Skip to main content
GET
/
v3
/
tokens
/
{tokenAddress}
/
prices
/
candle
curl "https://starknet.impulse.avnu.fi/v3/tokens/0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7/prices/candle?startDate=2024-02-01T00:00:00Z&endDate=2024-02-14T00:00:00Z&resolution=4H"

[
  {
    "date": "2024-02-05T00:00:00Z",
    "open": 2410.30,
    "high": 2425.80,
    "low": 2405.15,
    "close": 2418.60,
    "volume": 1250000
  },
  {
    "date": "2024-02-05T04:00:00Z",
    "open": 2418.60,
    "high": 2435.00,
    "low": 2415.25,
    "close": 2430.75,
    "volume": 1480000
  },
  {
    "date": "2024-02-05T08:00:00Z",
    "open": 2430.75,
    "high": 2445.90,
    "low": 2428.00,
    "close": 2435.50,
    "volume": 1620000
  }
]

​
Overview

Returns Open, High, Low, Close, and Volume (OHLCV) candlestick data for any token. Essential for building trading charts and performing technical analysis.

​
Path Parameters

​
tokenAddress
string
required
Token contract address (hex format)

​
Query Parameters

​
startDate
string
required
Start date (ISO 8601 format)
​
endDate
string
required
End date (ISO 8601 format)
​
resolution
string
default:"1H"
Candle timeframe: 1, 5, 15, 1H, 4H, 1D, 1W
​
quoteTokenAddress
string
Quote currency token address (defaults to USD)

​
Response

Returns an array of candlestick objects (CandleDataPoint).
​
date
string
required
ISO 8601 timestamp for candle open
​
open
number
required
Opening price
​
high
number
required
Highest price during period
​
low
number
required
Lowest price during period
​
close
number
required
Closing price
​
volume
number
required
Total volume traded
curl "https://starknet.impulse.avnu.fi/v3/tokens/0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7/prices/candle?startDate=2024-02-01T00:00:00Z&endDate=2024-02-14T00:00:00Z&resolution=4H"

[
  {
    "date": "2024-02-05T00:00:00Z",
    "open": 2410.30,
    "high": 2425.80,
    "low": 2405.15,
    "close": 2418.60,
    "volume": 1250000
  },
  {
    "date": "2024-02-05T04:00:00Z",
    "open": 2418.60,
    "high": 2435.00,
    "low": 2415.25,
    "close": 2430.75,
    "volume": 1480000
  },
  {
    "date": "2024-02-05T08:00:00Z",
    "open": 2430.75,
    "high": 2445.90,
    "low": 2428.00,
    "close": 2435.50,
    "volume": 1620000
  }
]

​
Resolution Values

ValueDescription
11 minute
55 minutes
1515 minutes
1H1 hour
4H4 hours
1D1 day
1W1 week