BUbullish
market-data

Get Market Candle

Get Current OHLCV Candle by Market Symbol

  • supports pagination
  • filtering on createdAtDatetime, createdAtTimestamp requires additional keywords, see filtering support

Ratelimited: False

get/v1/markets/{symbol}/candle

Request

Path parameters

symbolstring required

market symbol. E.g. BTCUSDC

Example:BTCUSDC

Query parameters

createdAtDatetime[gte]string date-time required

ISO 8601 with millisecond as string

Example:2025-05-20T01:01:01.000Z

start timestamp of window, ISO 8601 with millisecond as string

createdAtDatetime[lte]string date-time required

ISO 8601 with millisecond as string

Example:2025-05-20T01:01:01.000Z

end timestamp of window, ISO 8601 with millisecond as string

timeBucket'1m' | '5m' | '30m' | '1h' | '6h' | '12h' | '1d' required
Example:1m

time bucket size

Response

OK

openstring

see asset value format

highstring

see asset value format

lowstring

see asset value format

closestring

see asset value format

volumestring

see asset value format

createdAtTimestampstring string

unsigned 64 bit integer value which is the number of milliseconds since EPOCH expressed as string

createdAtDatetimestring date-time

ISO 8601 with millisecond as string

publishedAtTimestampstring string

unsigned 64 bit integer value which is the number of milliseconds since EPOCH expressed as string

Example response

[
  {
    "open": "1.00000000",
    "high": "1.00000000",
    "low": "1.00000000",
    "close": "1.00000000",
    "volume": "1.00000000",
    "createdAtTimestamp": "1621490985000",
    "createdAtDatetime": "2025-05-20T01:01:01.000Z",
    "publishedAtTimestamp": "1621490985000"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.