HTTP API: Market Data

Market data endpoints are intended for displaying prices, 24h stats, and K-line series.

Query Parameter Casing

These endpoints use camelCase query parameters like chainId and pairId.

GET /v1/market/pair

Get a single pair overview (price, 24h change, volume, FDV, etc.).

Query parameters:

Param	Type	Required	Notes
chainId	int	yes	Chain ID
pairId	int	recommended	If set, base/quote are ignored
base	string	optional	Compatibility mode (use together with quote)
quote	string	optional	Compatibility mode (use together with base)
interval	string	optional	Defaults to 1h

Response data: PairOverview.

Field	Type	Notes
chain_id	int	Chain ID
pair_id	int	Pair ID
base	string	Base token address
quote	string	Quote token address
pair_name	string	Pair name
price	string	Quote-denominated price
price_usd	string	USD price
price_source	string	kline or swap_indicative
change_24h	string	Example: 0.1234 means +12.34%
volume_base_24h	string	24h base volume
volume_quote_24h	string	24h quote volume
volume_usd_24h	string	24h USD volume
fdv_usd	string	Fully diluted valuation (USD)

Examples:

curl "{rfq-api-base-url}/v1/market/pair?chainId=56&pairId=123&interval=1h"

curl "{rfq-api-base-url}/v1/market/pair?chainId=56&base=0xabc...&quote=0xdef..."

GET /v1/market/klines

Get a K-line series.

Query parameters:

Param	Type	Required	Notes
chainId	int	yes	Chain ID
interval	string	yes	See available values below
pairId	int	recommended	If set, base/quote are ignored
base	string	optional	Compatibility mode
quote	string	optional	Compatibility mode
start	int64	optional	open_time start (Unix seconds)
end	int64	optional	open_time end (Unix seconds)
limit	int	optional	Max rows; default 500

Behavior:

• If start/end are omitted: returns the most recent limit klines.
• If start or end is provided: returns up to limit rows within the constraint.

Response data: KlineDTO[].

Field	Type	Notes
chain_id	int	Chain ID
base	string	Base token address
quote	string	Quote token address
interval	string	Interval
open_time	int64	Unix seconds
open	string	Open price
high	string	High price
low	string	Low price
close	string	Close price
volume_base	string	Base volume
volume_quote	string	Quote volume
volume_usd	string	USD volume

Available interval values:

1m 3m 5m 15m 30m 1h 2h 4h 8h 12h 1d 3d 1w 1M

Examples:

curl "{rfq-api-base-url}/v1/market/klines?chainId=56&pairId=123&interval=1m&limit=200"

curl "{rfq-api-base-url}/v1/market/klines?chainId=56&pairId=123&interval=1h&start=1734316800&end=1734403200&limit=500"