Candles

Returns the aggregated volume and USD pricing in an Open-High-Low-Close (OHLC) candle format for a token for a specified time window.

curl -s --location --request GET \
    "https://app.pangea.foundation/v1/api/markets/tokens/0x2260fac5e5542a773aa44fbcfedf7c193bc2c599?start=1724408000&end=1727827200&interval=Hour" \
    --header "Accept: application/jsonstream" \
    --header "Accept-Encoding: gzip" --compressed \
    --header "Authorization: Basic $PANGEA_AUTH" | jq

Response

[
  ...
  {
    "interval": "Hour",
    "provider": "All",
    "chain": "ALL",
    "start_time": 1725001200,
    "name": "Wrapped BTC",
    "symbol": "WBTC",
    "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
    "open": 58740.63001224425,
    "high": 59251.799084892635,
    "low": 58675.686585557254,
    "close": 59114.727689365696,
    "volume": 24.94231951
  },
  ...
]

Query Parameters

v1/api/markets/tokens/<token>?start=<utc_timestamp>&end=<utc_timestamp>

• token: A token contract address is mandatory and must be provided as a path parameter.
• start: This mandatory parameter is used to filter the data by a starting timestamp.
• end: This mandatory parameter is used to filter the data by an ending timestamp.
• chain: This parameter is used to filter the data by specific blockchain networks. Defaults to All.
• interval: This parameter is used to determine the aggregation window interval (i.e. Minute, Hour, Day, Month). Defaults to Minute.
• provider: This parameter is used to filter the data by a data source. Currently supports uniswap-v2 and uniswap-v3. Defaults to All.