Skip to content

Query Ticker Orderbook

Endpoint Information

Endpoint: GET /api/v1/tickers/{symbol}/orderbooks?exchange={exchange}

Description: Query platform orderbook

Authentication: Accessible anonymously

Query Parameters

ParameterTypeRequiredDescription
symbolstringYesRoute parameter, stock symbol
exchangeintYesURL parameter, exchange code. See Exchange enum type description

Response Parameters

FieldTypeDescription
symbolstringStock symbol
marketstringMarket code enum. See Market enum type description
askobject arrayAsk orders
ask[].pricedecimalPrice in corresponding market
ask[].volumedecimalVolume
bidobject arrayBid orders
bid[].pricedecimalPrice in corresponding market
bid[].volumedecimalVolume
timestringTime

Request Example

bash
curl -X GET "/api/v1/tickers/AAPL/orderbooks?exchange=0" \
     -H "Content-Type: application/json"

Response Example

json
{
    "code": 0,
    "data": {
        "symbol": "AAPL",
        "market": "usex",
        "ask": [
            {"price": "150.25", "volume": "100"},
            {"price": "150.30", "volume": "200"}
        ],
        "bid": [
            {"price": "150.20", "volume": "150"},
            {"price": "150.15", "volume": "250"}
        ],
        "time": "2025-01-17T03:00:24Z"
    }
}