Spot Market Data Endpoints

Get Ticker By Symbol

Rate limit rule: 20 request/1s

HTTP Request

  • GET /api/spot/v1/market/ticker

Request parameter

ParametersTypeRequiredDescription

symbol

String

Yes

Currency pair

Response:

{
    "code":"00000",
    "data":{
        "symbol":"BTCUSDT",
        "high24h":"34413.1",
        "low24h":"34413.1",
        "close":"34413.1",
        "quoteVol":"0",
        "baseVol":"0",
        "usdtVol":"0",
        "ts":"1625125755277"
    },
    "msg":"success",
    "requestTime":1625125756372
}

Response Field

FieldDescription

symbol

Currency pair

high24h

24h highest price

close

Latest transaction price

low24h

24h lowest price

quoteVol

Quote Currency volume

baseVol

Base Currency volume

usdtVol

USDT volume

ts

System timestamp

Get The Latest Ticker For All Symbols

Rate limit rule: 20 request/1s

HTTP Request Get the latest ticker for all coin pairs

  • GET /api/spot/v1/market/tickers

Response:

{
    "code":"00000",
    "data":[
      {
        "symbol":"BTCUSDT",
        "high24h":"34413.1",
        "low24h":"34413.1",
        "close":"34413.1",
        "quoteVol":"0",
        "baseVol":"0",
        "usdtVol":"0",
        "ts":"1625125755277"
    }
    ]
    "msg":"success",
    "requestTime":1625125756372
}

Response Field

FieldDescription

symbol

Currency pair

high24h

24h highest price

close

Latest transaction price

low24h

24h lowest price

ts

System timestamp

baseVol

Base coin volume

quoteVol

Quote coin volume

usdtVol

USDT volume

Recent Trades List

Rate limit rule: 20 request/1s

HTTP Request

  • GET /api/spot/v1/market/fills

Request parameter

ParametersTypeRequiredDescription

symbol

String

Yes

Currency pair

limit

String

No

Default 100

Response:

{
    "code":"00000",
    "msg":"success",
    "requestTime":1622097283024,
    "data":[
        {
            "symbol":"BFTUSDT_SPBL",
            "tradeId":"781698148534505473",
            "side":"buy",
            "fillPrice":"2.38735",
            "fillQuantity":"2470.6224",
            "fillTime":"1622097282536"
        },
        {
            "symbol":"BFTUSDT_SPBL",
            "tradeId":"781698140590493697",
            "side":"sell",
            "fillPrice":"2.38649",
            "fillQuantity":"3239.7976",
            "fillTime":"1622097280642"
        }
    ]
}

Response Field

FieldDescription

symbol

Currency pair

tradeId

trade id

side

Trade direction

fillPrice

Transaction price

fillQuantity

Transaction quantity

fillTime

Transaction time

Kline/Candlestick Data

Rate limit rule: 20 request/1s

HTTP Request

  • GET /api/spot/v1/market/candles

Request parameter

ParametersTypeRequiredDescription

symbol

String

Yes

Currency pair

period

String

Yes

Candlestick line time unit, granularity (​​refer to the following list for values)

after

String

No

Time after

before

String

No

Time before

limit

String

No

Default 100

Descriptiongranularity

1min

60

5min

300

15min

900

30min

1800

1h

3600

4h

14400

12h

43200

1d

86400

7d

604800

Response:

{
    "code":"00000",
    "msg":"success",
    "requestTime":1622097356073,
    "data":[
        {
            "open":"2.34517",
            "high":"2.34771",
            "low":"2.34214",
            "close":"2.34555",
            "quoteVol":"189631.101357091",
            "baseVol":"80862.6823",
            "usdtVol":"189631.101357091",
            "ts":"1622091360000"
        },
        {
            "open":"2.34391",
            "high":"2.34903",
            "low":"2.34391",
            "close":"2.34608",
            "quoteVol":"167725.002115681",
            "baseVol":"71479.3205",
            "usdtVol":"167725.002115681",
            "ts":"1622091420000"
        }
    ]
}

Response Field

FieldDescription

ts

System timestamp

open

Opening price

high

Highest price

low

Lowest price

close

Closing price

baseVol

Base Currency volume

quoteVol

Quote Currency volume

usdtVol

USDT volume

Order Book

Rate limit rule: 20 request/1s

HTTP Request

  • GET /api/spot/v1/market/depth

Request parameter

ParametersTypeRequiredDescription

symbol

String

Yes

Currency pair

type

String

Yes

Default: step0: do not merge, value: step0, step1, step2, step3, step4, step5

limit

String

Yes

Default 500

Response:

{
    "code":"00000",
    "msg":"success",
    "requestTime":1622102974025,
    "data":{
        "asks":[
            [
                "38084.5",
                "0.0039"
            ],
            [
                "38085.7",
                "0.0018"
            ],
            [
                "38086.7",
                "0.0310"
            ],
            [
                "38088.2",
                "0.5303"
            ]
        ],
        "bids":[
            [
                "38073.7",
                "0.4993000000000000"
            ],
            [
                "38073.4",
                "0.4500"
            ],
            [
                "38073.3",
                "0.1179"
            ],
            [
                "38071.5",
                "0.2162"
            ]
        ],
        "timestamp":"1622102974025"
    }
}

Last updated