latestSwagger 2.02026-08-12187723.0 MB

c4a12725cdb5

advanced

Batches

The batch request endpoint allows users to request data for multiple financial instruments, time intervals, and data types simultaneously. This endpoint is useful for efficiently gathering diverse financial data in a single operation, reducing the need for multiple individual requests. Errors in specific requests do not affect the processing of others, and each error is reported separately, enabling easy troubleshooting.

Request body

Only JSON POST requests are supported. The request content structure consists of key-value items. The key is a unique request ID. The value is requested url.

Response

The response contains key-value data. The key is a unique request ID. The value is returned data.

API credits

<ul> <li>The number of concurrent requests is limited by your subscription plan.</li> <li>Credits are consumed per requested endpoint, with the total usage equal to the sum of individual requests in the batch.</li> <li>If the requested data exceeds your available credits, only partial data will be returned asynchronously until your quota is exhausted.</li> <li>If one or more requests in the batch contain errors (e.g., invalid symbols or unsupported intervals), it will not affect the successful processing of other requests. Errors are reported individually within the response, allowing you to identify and correct specific issues without impacting the entire batch.</li> </ul>

post/batch

Request body

object required

Response

codeinteger

HTTP status code

statusstring

Status of the request

dataobject

Response data containing individual request results

Example response

{
  "code": 200,
  "status": "success",
  "data": {
    "req_1": {
      "response": {
        "meta": {
          "currency": "USD",
          "exchange": "NASDAQ",
          "exchange_timezone": "America/New_York",
          "interval": "1min",
          "mic_code": "XNGS",
          "symbol": "AAPL",
          "type": "Common Stock"
        },
        "status": "ok",
        "values": [
          {
            "close": "248.6",
            "datetime": "2025-02-21 12:51:00",
            "high": "248.6",
            "low": "248.4",
            "open": "248.5",
            "volume": "22290"
          },
          {
            "close": "248.52",
            "datetime": "2025-02-21 12:50:00",
            "high": "248.59",
            "low": "248.43",
            "open": "248.52",
            "volume": "64085"
          }
        ]
      },
      "status": "success"
    },
    "req_2": {
      "response": {
        "rate": 149.25999,
        "symbol": "USD/JPY",
        "timestamp": 1740160260
      },
      "status": "success"
    },
    "req_3": {
      "response": {
        "amount": 18209.71933,
        "rate": 149.25999,
        "symbol": "USD/JPY",
        "timestamp": 1740160260
      },
      "status": "success"
    }
  }
}