API ReferenceGuidesChangelog
Prices

Prices multiple assets at multiple timestamps in one call, grouping results per asset.

POST
/api/v2/prices/batch

Authorization

api-key<token>

In: header

Request Body

application/json

Cross-product request: each entry in assets is priced at each entry in timestamps. The response groups the results per asset as a PriceSeries (one point per timestamp). If timestamps is empty, the current price is used for every asset. Unlike GetPriceSeriesV2 (which returns a continuous range for one asset), this returns only the discrete requested timestamps, across many assets.

TypeScript Definitions

Use the request body type in TypeScript.

Cross-product request: each entry in assets is priced at each entry in timestamps. The response groups the results per asset as a PriceSeries (one point per timestamp). If timestamps is empty, the current price is used for every asset. Unlike GetPriceSeriesV2 (which returns a continuous range for one asset), this returns only the discrete requested timestamps, across many assets.

Response Body

application/json

curl -X POST "https://example.com/api/v2/prices/batch" \  -H "Content-Type: application/json" \  -d '{}'
{  "items": [    {      "asset": {        "address": {          "address": "string",          "chain": "string"        },        "assetId": "string",        "symbol": "string"      },      "candidates": {        "candidates": [          {            "addresses": [              {                "address": "string",                "chain": "string"              }            ],            "assetClass": "string",            "assetId": "string",            "marketCap": 0.1,            "name": "string",            "symbol": "string"          }        ]      },      "error": "string",      "series": {        "assetId": "string",        "points": [          {            "assetId": "string",            "price": 0.1,            "source": "string",            "timestamp": "2019-08-24T14:15:22Z"          }        ],        "source": "string"      }    }  ]}