Market data
Read market metadata and public liquidity before constructing an order.
| Method and path | Purpose |
|---|---|
GET /v1/market/exchange-info | Markets, exact asset representations, precision, increments, status, fee version and order capabilities. |
GET /v1/market/data/prices | Current indicative or executable price summaries by market. |
GET /v1/market/data/stats | Rolling market statistics. |
GET /v1/market/data/trades | Public market trades where disclosure policy permits. |
GET /v1/market/data/klines | Time-bucketed market data. |
GET /v1/market/data/orderbook | Aggregated price levels and sequence metadata. |
Market identifiers must resolve to exact asset representation IDs from GET /v1/assets. Display symbols do not route funds. Quantities and prices require integer-string precision plus documented tick, step and scale rules.
Market metadata and book examples#
Proposed query: GET /v1/market/exchange-info?market=USD6-EUR6. The synthetic response below describes one market, not a supported production pair:
{"version":"0.1-review","requestId":"request_demo_1","data":{"market":"USD6-EUR6","baseAssetId":"asset_demo_usd6","quoteAssetId":"asset_demo_eur6","baseDecimals":6,"quoteDecimals":6,"priceScale":6,"quantityStep":"1000000","priceTick":"1000","orderTypes":["MARKET","LIMIT"],"status":"UNAVAILABLE"}}quantity is atomic base-asset units. limitPrice is quote currency per whole base unit, multiplied by 10^priceScale: 920000 means 0.92 EUR6 per USD6 here. A 25 USD6 limit buy has a 23 EUR6 principal bound before fees. Quantity step, price tick, actual fees and signing limits must be obtained from the versioned market contract; prices alone do not authorize a debit. Asset identity and decimal normalization must be retained for each leg.
Proposed query: GET /v1/market/data/orderbook?market=USD6-EUR6&limit=50:
{"version":"0.1-review","requestId":"request_demo_2","data":{"market":"USD6-EUR6","snapshotId":"book_demo_1","sequence":"42","observedAt":"2026-10-05T12:00:00.000Z","bids":[{"price":"919000","quantity":"100000000"}],"asks":[{"price":"920000","quantity":"25000000"}]}}This proposed snapshot contains aggregated levels, ordered from best to worse price: descending bids and ascending asks. Each quantity is base atomic units; sequence is an unsigned integer string. Empty sides are valid. A snapshot is observed liquidity, not a reservation or fill guarantee.
| Read route | Proposed query / response content |
|---|---|
/v1/market/data/prices | market; scaled price, price kind and observation time. An indicative price is not executable. |
/v1/market/data/stats | market; explicit window start/end, base volume and price scale. An empty window must not fabricate a trade. |
/v1/market/data/trades | market, bounded limit, opaque cursor; stable public trade IDs, price, base quantity and trade time. The illustrative public response omits private account identity. |
/v1/market/data/klines | market, interval and time bounds; bucket start/end, scaled OHLC prices and base volume. Empty buckets need explicit no-trade semantics. |
These query and response shapes are draft proposals. Interval sets, history retention and service limits remain unspecified in this target contract. Use request conventions for consistent pagination and the error guidance below for recovery.