Skip to main content
GET
/
api
/
v1
/
candlesticks
Get candlestick (OHLC) data
curl --request GET \
  --url https://api.mainnet.aptoslabs.com/decibel/api/v1/candlesticks \
  --header 'Authorization: Bearer <token>'
[
  {
    "T": 1761591599999,
    "c": 100,
    "h": 102,
    "i": "1h",
    "l": 98,
    "o": 100,
    "t": 1761588000000,
    "v": 1000
  }
]

Authorizations

​
Authorization
string
header
required

Bearer token from Geomi. See Authentication for setup instructions.

Query Parameters

​
market
string
required

Market address

​
interval
enum<string>
required

Candlestick interval (1m, 5m, 15m, 30m, 1h, 2h, 4h, 1d, 1w, 1mo)

Available options:
1m,
5m,
15m,
30m,
1h,
2h,
4h,
8h,
12h,
1d,
3d,
1w,
1mo
​
startTime
integer<int64>
required

Start time in milliseconds

​
endTime
integer<int64>
required

End time in milliseconds

​
filterWicks
boolean

When true, caps extreme H/L wicks using cross-candle volume-weighted standard deviation. For each candle, H and L are clamped to [VWAP ± nSigma × σ_v] while preserving the candle body (open/close). No extra database queries are required.

​
nSigma
number<double>

Number of volume-weighted standard deviations used as the wick-filter band (default: 3.0). Only applies when filterWicks is true.

Response

Candlestick data retrieved successfully

​
T
integer<int64>
required
Example:

1761591599999

​
c
number<double>
required
Example:

100

​
h
number<double>
required
Example:

102

​
i
string
required
Example:

"1h"

​
l
number<double>
required
Example:

98

​
o
number<double>
required
Example:

100

​
t
integer<int64>
required
Example:

1761588000000

​
v
number<double>
required
Example:

1000