Market Data

Endpoint

Download schema

Basis

Query basis

GET

/futures/data/basis

https://dapi.binance.com

Basis › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Basis › Query Parameters

pair

string · required

Pair.

Example: null

contractType

string · enum · required

Contract type.

Enum values:

PERPETUAL

CURRENT_QUARTER

NEXT_QUARTER

Example: PERPETUAL

period

string · enum · required

Period interval.

Enum values:

15m

30m

12h

Example: 5m

limit

integer · int64 · max: 500

Maximum number of records to return.

Example: 30

Default: 30

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

Basis › Responses

200

Basis

object

indexPrice

string

index price

Example: 29269.93972727

contractType

string

Contract type.

Example: CURRENT_QUARTER

basisRate

string

Basis rate.

Example: 0.0024

futuresPrice

string

Futures price.

Example: 29341.3

annualizedBasisRate

string

Annualized basis rate.

Example: 0.0283

basis

string

Basis value.

Example: 71.36027273

pair

string

Pair

Example: BTCUSD

timestamp

integer · int64

Timestamp in milliseconds.

Example: 1653381600000

Check Server time

Test connectivity to the Rest API and get the current server time.

GET

/dapi/v1/time

https://dapi.binance.com

Check Server time › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Check Server time › Responses

200

Check Server time

serverTime

integer · int64

Ignore please. If you want to check current server time, please check via "GET /dapi/v1/time"

Example: 1499827319559

Compressed/Aggregate Trades List

Get compressed, aggregate trades. Market trades that fill in 100ms with the same price and the same taking side will have the quantity aggregated.

GET

/dapi/v1/aggTrades

https://dapi.binance.com

Compressed/Aggregate Trades List › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight20

Compressed/Aggregate Trades List › Query Parameters

symbol

string · required

Symbol

Example: null

fromId

integer · int64

ID to get aggregate trades from INCLUSIVE.

Example: 1

startTime

integer · int64

Timestamp in ms to get aggregate trades from INCLUSIVE.

Example: 1623319461670

endTime

integer · int64

Timestamp in ms to get aggregate trades until INCLUSIVE.

Example: 1641782889000

limit

integer · int64 · max: 1000

Maximum number of records to return.

Example: 30

Default: 500

Compressed/Aggregate Trades List › Responses

200

Compressed/Aggregate Trades List

object

a

integer · int64

Aggregate tradeId

Example: 416690

p

string

Price

Example: 9642.4

q

string

Quantity

Example: 3

f

integer · int64

First tradeId

Example: 595259

l

integer · int64

Last tradeId

Example: 595259

T

integer · int64

Timestamp

Example: 1591250548649

m

boolean

Was the buyer the maker?

Example: false

Continuous Contract Kline/Candlestick Data

Kline/candlestick bars for a specific contract type. Klines are uniquely identified by their open time.

GET

/dapi/v1/continuousKlines

https://dapi.binance.com

Continuous Contract Kline/Candlestick Data › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

based on parameter LIMIT

LIMIT	weight
[1,100)	1
[100, 500)	2
[500, 1000]	5
> 1000	10

Continuous Contract Kline/Candlestick Data › Query Parameters

pair

string · required

After CM migration, accepts both CM and UM pair values.

Example: BTCUSD

contractType

string · enum · required

Enum values:

PERPETUAL

CURRENT_QUARTER

NEXT_QUARTER

Example: PERPETUAL

interval

string · enum · required

Interval

Enum values:

15m

30m

Example: 1m

startTime

integer · int64

Start time

Example: 1623319461670

endTime

integer · int64

End time

Example: 1641782889000

limit

integer · int64 · max: 1500

Maximum number of records to return.

Example: 30

Default: 500

Continuous Contract Kline/Candlestick Data › Responses

200

Continuous Contract Kline/Candlestick Data

array[]

tuple[12] · minItems: 12 · maxItems: 12

[0]

integer · int64 · required

Open time

Example: 1591258320000

[1]

string · required

Open

Example: 9640.7

[2]

string · required

High

Example: 9642.4

[3]

string · required

Low

Example: 9640.6

[4]

string · required

Example: 9642.0

[5]

string · required

Volume

Example: 206

[6]

integer · int64 · required

Close time

Example: 1591258379999

[7]

string · required

Base asset volume

Example: 2.13660389

[8]

integer · required

Number of trades

Example: 48

[9]

string · required

Taker buy volume

Example: 119

[10]

string · required

Taker buy base asset volume

Example: 1.23424865

[11]

string · required

Ignore

Example: 0

Exchange Information

Current exchange trading rules and symbol information

GET

/dapi/v1/exchangeInfo

https://dapi.binance.com

Exchange Information › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Exchange Information › Responses

200

Exchange Information

exchangeFilters

string[]

Exchange filters.

object[]

Rate limit definitions.

interval

string

Rate limit interval.

Example: MINUTE

intervalNum

integer · int64

Rate limit interval multiplier.

Example: 1

limit

integer · int64

Maximum allowed orders for this rule.

Example: 2400

rateLimitType

string

Rate limit type.

Example: REQUEST_WEIGHT

serverTime

integer · int64

Ignore please. If you want to check current server time, please check via "GET /dapi/v1/time"

Example: 1565613908500

object[]

Supported trading symbols.

object[]

Trading filters and constraints.

filterType

string

Filter type.

Example: PRICE_FILTER

maxPrice

string

Maximum price.

Example: 100000

minPrice

string

Minimum price.

Example: 0.1

tickSize

string

Tick size.

Example: 0.1

maxQty

string

maximum quantity of base asset

Example: 100000

minQty

string

Minimum quantity.

Example: 1

stepSize

string

Step size.

Example: 1

limit

integer · int64

Maximum allowed orders for this rule.

Example: 200

multiplierUp

string

Upper multiplier bound.

Example: 1.0500

multiplierDown

string

Lower multiplier bound.

Example: 0.9500

multiplierDecimal

string

Multiplier decimal precision.

Example: 4

orderTypes

string[]

Supported order types.

timeInForce

string[]

Time in force

liquidationFee

string

liquidation fee rate

Example: 0.010000

marketTakeBound

string

the max price difference rate( from mark price) a market order can make

Example: 0.30

symbol

string

Trading symbol

Example: BTCUSD_200925

pair

string

Pair

Example: BTCUSD

contractType

string

Contract type.

Example: CURRENT_QUARTER

deliveryDate

integer · int64

Delivery timestamp.

Example: 1601020800000

onboardDate

integer · int64

Onboard timestamp.

Example: 1590739200000

contractStatus

string

Contract status.

Example: TRADING

contractSize

integer · int64

Contract size.

Example: 100

quoteAsset

string

Quote asset symbol.

Example: USD

baseAsset

string

Base asset symbol.

Example: BTC

marginAsset

string

Margin asset.

Example: BTC

pricePrecision

integer · int64

please do not use it as tickSize

Example: 1

quantityPrecision

integer · int64

please do not use it as stepSize

Example: 0

baseAssetPrecision

integer · int64

Base asset precision.

Example: 8

quotePrecision

integer · int64

Quote asset precision.

Example: 8

equalQtyPrecision

integer · int64

ignore

Example: 4

triggerProtect

string

threshold for algo order with "priceProtect"

Example: 0.0500

maintMarginPercent

string

ignore

Example: 2.5000

requiredMarginPercent

string

ignore

Example: 5.0000

underlyingType

string

Underlying asset type.

Example: COIN

underlyingSubType

string[]

Underlying asset sub-type.

timezone

string

Timezone of market data.

Example: UTC

GET/dapi/v1/exchangeInfo

curl --request GET \
  --url https://dapi.binance.com/dapi/v1/exchangeInfo

Example Responses

{
  "exchangeFilters": [
    []
  ],
  "rateLimits": [
    {
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 2400,
      "rateLimitType": "REQUEST_WEIGHT"
    }
  ],
  "serverTime": 1565613908500,
  "symbols": [
    {
      "filters": [
        {
          "filterType": "PRICE_FILTER",
          "maxPrice": "100000",
          "minPrice": "0.1",
          "tickSize": "0.1",
          "maxQty": "100000",
          "minQty": "1",
          "stepSize": "1",
          "limit": 200,
          "multiplierUp": "1.0500",
          "multiplierDown": "0.9500",
          "multiplierDecimal": "4"
        }
      ],
      "orderTypes": [
        "LIMIT"
      ],
      "timeInForce": [
        "GTC"
      ],
      "liquidationFee": "0.010000",
      "marketTakeBound": "0.30",
      "symbol": "BTCUSD_200925",
      "pair": "BTCUSD",
      "contractType": "CURRENT_QUARTER",
      "deliveryDate": 1601020800000,
      "onboardDate": 1590739200000,
      "contractStatus": "TRADING",
      "contractSize": 100,
      "quoteAsset": "USD",
      "baseAsset": "BTC",
      "marginAsset": "BTC",
      "pricePrecision": 1,
      "quantityPrecision": 0,
      "baseAssetPrecision": 8,
      "quotePrecision": 8,
      "equalQtyPrecision": 4,
      "triggerProtect": "0.0500",
      "maintMarginPercent": "2.5000",
      "requiredMarginPercent": "5.0000",
      "underlyingType": "COIN",
      "underlyingSubType": [
        []
      ]
    }
  ],
  "timezone": "UTC"
}

json

application/json

Get Funding Rate History of Perpetual Futures

GET

/dapi/v1/fundingRate

https://dapi.binance.com

Get Funding Rate History of Perpetual Futures › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Get Funding Rate History of Perpetual Futures › Query Parameters

symbol

string · required

Symbol

Example: null

startTime

integer · int64

Timestamp in ms to get funding rate from INCLUSIVE.

Example: 1623319461670

endTime

integer · int64

Timestamp in ms to get funding rate until INCLUSIVE.

Example: 1641782889000

limit

integer · int64 · max: 1000

Maximum number of records to return.

Example: 30

Default: 100

Get Funding Rate History of Perpetual Futures › Responses

200

Get Funding Rate History of Perpetual Futures

object

symbol

string

Trading symbol

Example: BTCUSD_PERP

fundingTime

integer · int64

Funding time.

Example: 1596038400000

fundingRate

string

Funding rate.

Example: -0.00300000

Get Funding Rate Info

Query funding rate info for symbols that had FundingRateCap/FundingRateFloor/fundingIntervalHours adjustment

GET

/dapi/v1/fundingInfo

https://dapi.binance.com

Get Funding Rate Info › Responses

200

Get Funding Rate Info

object

symbol

string

Trading symbol

Example: BTCUSD_PERP

adjustedFundingRateCap

string

Adjusted funding rate cap.

Example: 0.02500000

adjustedFundingRateFloor

string

Adjusted funding rate floor.

Example: -0.02500000

fundingIntervalHours

integer · int64

Funding interval in hours.

Example: 8

disclaimer

boolean

Disclaimer text.

Example: false

Index Price and Mark Price

Query index price and mark price

GET

/dapi/v1/premiumIndex

https://dapi.binance.com

Index Price and Mark Price › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight10

Index Price and Mark Price › Query Parameters

symbol

string

Example: BTCUSD_PERP

pair

string

Example: BTCUSD

Index Price and Mark Price › Responses

200

Index Price and Mark Price

object

symbol

string

Trading symbol

Example: BTCUSD_PERP

pair

string

Pair

Example: BTCUSD

markPrice

string

mark price

Example: 11029.69574559

indexPrice

string

index price

Example: 10979.14437500

estimatedSettlePrice

string

Estimated Settle Price, only useful in the last hour before the settlement starts.

Example: 10981.74168236

lastFundingRate

string

the lasted funding rate, for perpetual contract symbols only. For delivery symbols, "" will be shown.

Example: 0.00071003

interestRate

string

the base asset interest rate, for perpetual contract symbols only. For delivery symbols, "" will be shown.

Example: 0.00010000

nextFundingTime

integer · int64

For perpetual contract symbols only. For delivery symbols, 0 will be shown

Example: 1596096000000

time

integer · int64

Time

Example: 1596094042000

Index Price Kline/Candlestick Data

Kline/candlestick bars for the index price of a pair. Klines are uniquely identified by their open time.

GET

/dapi/v1/indexPriceKlines

https://dapi.binance.com

Index Price Kline/Candlestick Data › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

Based on parameter LIMIT

LIMIT	weight
[1,100)	1
[100, 500)	2
[500, 1000]	5
> 1000	10

Index Price Kline/Candlestick Data › Query Parameters

pair

string · required

After CM migration, accepts both CM and UM pair values.

Example: BTCUSD

interval

string · enum · required

Interval

Enum values:

15m

30m

Example: 1m

startTime

integer · int64

Start time

Example: 1623319461670

endTime

integer · int64

End time

Example: 1641782889000

limit

integer · int64 · max: 1500

Maximum number of records to return.

Example: 30

Default: 500

Index Price Kline/Candlestick Data › Responses

200

Index Price Kline/Candlestick Data

array[]

tuple[12] · minItems: 12 · maxItems: 12

[0]

integer · int64 · required

Open time

Example: 1591256400000

[1]

string · required

Open

Example: 9653.69440000

[2]

string · required

High

Example: 9653.69640000

[3]

string · required

Low

Example: 9651.38600000

[4]

string · required

Example: 9651.55200000

[5]

string · required

Ignore

Example: 0

[6]

integer · int64 · required

Close time

Example: 1591256459999

[7]

string · required

Ignore

Example: 0

[8]

integer · required

Number of bisic data

Example: 60

[9]

string · required

Ignore

Example: 0

[10]

string · required

Ignore

Example: 0

[11]

string · required

Ignore

Example: 0

Kline/Candlestick Data

Kline/candlestick bars for a symbol. Klines are uniquely identified by their open time.

GET

/dapi/v1/klines

https://dapi.binance.com

Kline/Candlestick Data › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

Based on parameter LIMIT

LIMIT	weight
[1,100)	1
[100, 500)	2
[500, 1000]	5
> 1000	10

Kline/Candlestick Data › Query Parameters

symbol

string · required

After CM migration, accepts both CM and UM symbols.

Example: BTCUSD

interval

string · enum · required

Interval

Enum values:

15m

30m

Example: 1m

startTime

integer · int64

Start time

Example: 1623319461670

endTime

integer · int64

End time

Example: 1641782889000

limit

integer · int64 · max: 1500

Maximum number of records to return.

Example: 30

Default: 500

Kline/Candlestick Data › Responses

200

Kline/Candlestick Data

array[]

tuple[12] · minItems: 12 · maxItems: 12

[0]

integer · int64 · required

Open time

Example: 1591258320000

[1]

string · required

Open

Example: 9640.7

[2]

string · required

High

Example: 9642.4

[3]

string · required

Low

Example: 9640.6

[4]

string · required

Example: 9642.0

[5]

string · required

Volume

Example: 206

[6]

integer · int64 · required

Close time

Example: 1591258379999

[7]

string · required

Base asset volume

Example: 2.13660389

[8]

integer · required

Number of trades

Example: 48

[9]

string · required

Taker buy volume

Example: 119

[10]

string · required

Taker buy base asset volume

Example: 1.23424865

[11]

string · required

Ignore

Example: 0

Long/Short Ratio

Query symbol Long/Short Ratio

GET

/futures/data/globalLongShortAccountRatio

https://dapi.binance.com

Long/Short Ratio › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Long/Short Ratio › Query Parameters

pair

string · required

BTCUSD

Example: null

period

string · enum · required

Enum values:

15m

30m

12h

Example: 5m

limit

integer · int64 · max: 500

Maximum number of records to return.

Example: 30

Default: 30

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

Long/Short Ratio › Responses

200

Long/Short Ratio

object

pair

string

Pair

Example: BTCUSD

longShortRatio

string

Long/short ratio.

Example: 0.1960

longAccount

string

64.42%

Example: 0.6622

shortAccount

string

35.58%

Example: 0.3378

timestamp

integer · int64

Timestamp in milliseconds.

Example: 1583139600000

Mark Price Kline/Candlestick Data

Kline/candlestick bars for the mark price of a symbol. Klines are uniquely identified by their open time.

GET

/dapi/v1/markPriceKlines

https://dapi.binance.com

Mark Price Kline/Candlestick Data › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

Based on parameter LIMIT

LIMIT	weight
[1,100)	1
[100, 500)	2
[500, 1000]	5
> 1000	10

Mark Price Kline/Candlestick Data › Query Parameters

symbol

string · required

After CM migration, accepts both CM and UM symbols.

Example: BTCUSD

interval

string · enum · required

Interval

Enum values:

15m

30m

Example: 1m

startTime

integer · int64

Start time

Example: 1623319461670

endTime

integer · int64

End time

Example: 1641782889000

limit

integer · int64 · max: 1500

Maximum number of records to return.

Example: 30

Default: 500

Mark Price Kline/Candlestick Data › Responses

200

Mark Price Kline/Candlestick Data

array[]

tuple[12] · minItems: 12 · maxItems: 12

[0]

integer · int64 · required

Open time

Example: 1591256400000

[1]

string · required

Open

Example: 9653.69440000

[2]

string · required

High

Example: 9653.69640000

[3]

string · required

Low

Example: 9651.38600000

[4]

string · required

Example: 9651.55200000

[5]

string · required

Ignore

Example: 0

[6]

integer · int64 · required

Close time

Example: 1591256459999

[7]

string · required

Ignore

Example: 0

[8]

integer · required

Number of bisic data

Example: 60

[9]

string · required

Ignore

Example: 0

[10]

string · required

Ignore

Example: 0

[11]

string · required

Ignore

Example: 0

Old Trades Lookup (MARKET_DATA)

Get older market historical trades.

GET

/dapi/v1/historicalTrades

https://dapi.binance.com

Old Trades Lookup (MARKET_DATA) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight20

Old Trades Lookup (MARKET_DATA) › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Old Trades Lookup (MARKET_DATA) › Query Parameters

symbol

string · required

Symbol

Example: null

limit

integer · int64 · max: 500

Maximum number of records to return.

Example: 30

Default: 100

fromId

integer · int64

TradeId to fetch from. Default gets most recent trades.

Example: 595103

Old Trades Lookup (MARKET_DATA) › Responses

200

Old Trades Lookup

object

id

integer · int64

positionId

Example: 595103

price

string

Latest token price.

Example: 9642.2

qty

string

Quantity.

Example: 1

baseQty

string

Base asset quantity.

Example: 0.01037108

time

integer · int64

Time

Example: 1499865549590

isBuyerMaker

boolean

Whether buyer is market maker.

Example: true

Open Interest

Get present open interest of a specific symbol.

GET

/dapi/v1/openInterest

https://dapi.binance.com

Open Interest › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Open Interest › Query Parameters

symbol

string · required

Symbol

Example: BTCUSD_200626

Open Interest › Responses

200

Open Interest

symbol

string

Trading symbol

Example: BTCUSD_200626

pair

string

Pair

Example: BTCUSD

openInterest

string

Open interest.

Example: 15004

contractType

string

Contract type.

Example: CURRENT_QUARTER

time

integer · int64

Time

Example: 1591261042378

Open Interest Statistics

Query open interest stats

GET

/futures/data/openInterestHist

https://dapi.binance.com

Open Interest Statistics › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Open Interest Statistics › Query Parameters

pair

string · required

Example: BTCUSD

contractType

string · enum · required

Enum values:

ALL

PERPETUAL

CURRENT_QUARTER

NEXT_QUARTER

Example: PERPETUAL

period

string · enum · required

Enum values:

15m

30m

12h

Example: 5m

limit

integer · int64 · max: 500

Maximum number of records to return.

Example: 30

Default: 30

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

Open Interest Statistics › Responses

200

Open Interest Statistics

object

pair

string

Pair

Example: BTCUSD

contractType

string

Contract type.

Example: CURRENT_QUARTER

sumOpenInterest

string

unit: cont

Example: 20403

sumOpenInterestValue

string

unit: base asset

Example: 176196512.23400000

timestamp

integer · int64

Timestamp in milliseconds.

Example: 1591261042378

Order Book

Query orderbook on specific symbol

GET

/dapi/v1/depth

https://dapi.binance.com

Order Book › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

Adjusted based on the limit:

Limit	Weight
5, 10, 20, 50	2
100	5
500	10
1000	20

Order Book › Query Parameters

symbol

string · required

Symbol

Example: BTCUSD_PERP

limit

integer · int64 · max: 1000

Valid limits:[5, 10, 20, 50, 100, 500, 1000].

Example: 500

Default: 500

Order Book › Responses

200

Order Book

lastUpdateId

integer · int64

Last update ID.

Example: 16769853

symbol

string

Trading symbol

Example: BTCUSD_PERP

pair

string

Pair

Example: BTCUSD

E

integer · int64

Message output time

Example: 1591250106370

T

integer · int64

Transaction time

Example: 1591250106368

array[]

Bid orders. Each entry is [price, quantity].

Example: [["9638.00000000","431.00000000"]]

tuple[2] · minItems: 2 · maxItems: 2

[0]

string · required

Price

Example: 9638.00000000

[1]

string · required

Quantity

Example: 431.00000000

array[]

Ask orders. Each entry is [price, quantity].

Example: [["9638.20000000","12.00000000"]]

tuple[2] · minItems: 2 · maxItems: 2

[0]

string · required

Price

Example: 9638.20000000

[1]

string · required

Quantity

Example: 12.00000000

Premium index Kline Data

Premium index kline bars of a symbol. Klines are uniquely identified by their open time.

GET

/dapi/v1/premiumIndexKlines

https://dapi.binance.com

Premium index Kline Data › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

Based on parameter LIMIT

LIMIT	weight
[1,100)	1
[100, 500)	2
[500, 1000]	5
> 1000	10

Premium index Kline Data › Query Parameters

symbol

string · required

After CM migration, accepts both CM and UM symbols.

Example: BTCUSD

interval

string · enum · required

Interval

Enum values:

15m

30m

Example: 1m

startTime

integer · int64

Start time

Example: 1623319461670

endTime

integer · int64

End time

Example: 1641782889000

limit

integer · int64 · max: 1500

Maximum number of records to return.

Example: 30

Default: 500

Premium index Kline Data › Responses

200

Premium index Kline Data

array[]

tuple[12] · minItems: 12 · maxItems: 12

[0]

integer · int64 · required

Open time

Example: 1691603820000

[1]

string · required

Open

Example: -0.00042931

[2]

string · required

High

Example: -0.00023641

[3]

string · required

Low

Example: -0.00059406

[4]

string · required

Example: -0.00043659

[5]

string · required

Ignore

Example: 0

[6]

integer · int64 · required

Close time

Example: 1691603879999

[7]

string · required

Ignore

Example: 0

[8]

integer · required

Ignore

Example: 12

[9]

string · required

Ignore

Example: 0

[10]

string · required

Ignore

Example: 0

[11]

string · required

Ignore

Example: 0

Query Index Price Constituents

Query index price constituents

GET

/dapi/v1/constituents

https://dapi.binance.com

Query Index Price Constituents › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Query Index Price Constituents › Query Parameters

symbol

string · required

Symbol

Example: BTCUSD

Query Index Price Constituents › Responses

200

Index Price Constituents

symbol

string

Trading symbol

Example: BTCUSD

time

integer · int64

Time

Example: 1697422647853

object[]

Constituent list.

exchange

string

Exchange identifier.

Example: bitstamp

symbol

string

Trading symbol

Example: btcusd

price

string

Price

Example: 94057.03000000

weight

string

Weight

Example: 0.25000000

Recent Trades List

Get recent market trades

GET

/dapi/v1/trades

https://dapi.binance.com

Recent Trades List › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight5

Recent Trades List › Query Parameters

symbol

string · required

Symbol

Example: BTCUSD

limit

integer · int64 · max: 1000

Maximum number of records to return.

Example: 30

Default: 500

Recent Trades List › Responses

200

Recent Trades List

object

id

integer · int64

positionId

Example: 28457

price

string

Latest token price.

Example: 9635.0

qty

string

Quantity.

Example: 1

baseQty

string

Base asset quantity.

Example: 0.01037883

time

integer · int64

Time

Example: 1591250192508

isBuyerMaker

boolean

Whether buyer is market maker.

Example: true

Symbol Order Book Ticker

Best price/qty on the order book for a symbol or symbols.

GET

/dapi/v1/ticker/bookTicker

https://dapi.binance.com

Symbol Order Book Ticker › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

2 for a single symbol, 5 when the symbol parameter is omitted

Symbol Order Book Ticker › Query Parameters

symbol

string

Symbol

Example: BTCUSD_200626

pair

string

Symbol

Example: BTCUSD

Symbol Order Book Ticker › Responses

200

Symbol Order Book Ticker

object

lastUpdateId

integer · int64

Last update ID.

Example: 1027024

symbol

string

Trading symbol

Example: BTCUSD_200626

pair

string

Pair

Example: BTCUSD

bidPrice

string

Best bid price.

Example: 9650.1

bidQty

string

Best bid quantity.

Example: 16

askPrice

string

Best ask price.

Example: 9650.3

askQty

string

Best ask quantity.

Example: 7

time

integer · int64

Time

Example: 1591257300345

Symbol Price Ticker

Latest price for a symbol or symbols.

GET

/dapi/v1/ticker/price

https://dapi.binance.com

Symbol Price Ticker › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

1 for a single symbol, 2 when the symbol parameter is omitted

Symbol Price Ticker › Query Parameters

symbol

string

Symbol

Example: BTCUSD_200626

pair

string

Pair

Example: BTCUSD

Symbol Price Ticker › Responses

200

Symbol Price Ticker

object

symbol

string

Trading symbol

Example: BTCUSD_200626

ps

string

Pair

Example: BTCUSD

price

string

Latest token price.

Example: 9647.8

time

integer · int64

Time

Example: 1591257246176

Taker Buy/Sell Volume

Taker Buy Volume: the total volume of buy orders filled by takers within the period.

Taker Sell Volume: the total volume of sell orders filled by takers within the period.

GET

/futures/data/takerBuySellVol

https://dapi.binance.com

Taker Buy/Sell Volume › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Taker Buy/Sell Volume › Query Parameters

pair

string · required

Example: BTCUSD

contractType

string · enum · required

Enum values:

ALL

PERPETUAL

CURRENT_QUARTER

NEXT_QUARTER

Example: PERPETUAL

period

string · enum · required

Enum values:

15m

30m

12h

Example: 5m

limit

integer · int64 · max: 500

Maximum number of records to return.

Example: 30

Default: 30

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

Taker Buy/Sell Volume › Responses

200

Taker Buy/Sell Volume

object

pair

string

Pair

Example: BTCUSD

contractType

string

Contract type.

Example: CURRENT_QUARTER

takerBuyVol

string

unit: cont

Example: 387

takerSellVol

string

unit: cont

Example: 248

takerBuyVolValue

string

unit: base asset

Example: 2342.1220

takerSellVolValue

string

unit: base asset

Example: 4213.9800

timestamp

integer · int64

Timestamp in milliseconds.

Example: 1591261042378

Test Connectivity

Test connectivity to the Rest API.

GET

/dapi/v1/ping

https://dapi.binance.com

Test Connectivity › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Test Connectivity › Responses

200

No data returned

24hr Ticker Price Change Statistics

24 hour rolling window price change statistics.

GET

/dapi/v1/ticker/24hr

https://dapi.binance.com

24hr Ticker Price Change Statistics › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

1 for a single symbol, 40 when the symbol parameter is omitted Careful when accessing this with no symbol.

24hr Ticker Price Change Statistics › Query Parameters

symbol

string

Symbol

Example: BTCUSD_200925

pair

string

Pair

Example: BTCUSD

24hr Ticker Price Change Statistics › Responses

200

24hr Ticker Price Change Statistics

object

symbol

string

Trading symbol

Example: BTCUSD_200925

pair

string

Pair

Example: BTCUSD

priceChange

string

Absolute price change in the 24h window.

Example: 136.6

priceChangePercent

string

Percentage price change in the 24h window.

Example: 1.436

weightedAvgPrice

string

Weighted average price in the 24h window.

Example: 9547.3

lastPrice

string

Latest traded price.

Example: 9651.6

lastQty

string

Quantity of the latest trade.

Example: 1

openPrice

string

Opening price of the 24h window.

Example: 9515.0

highPrice

string

Highest price in the 24h window.

Example: 9687.0

lowPrice

string

Lowest price in the 24h window.

Example: 9499.5

volume

string

Base asset volume in the 24h window.

Example: 494109

baseVolume

string

Base asset volume.

Example: 5192.94797687

openTime

integer · int64

Start time of the 24h window (milliseconds).

Example: 1591170300000

closeTime

integer · int64

End time of the 24h window (milliseconds).

Example: 1591256718418

firstId

integer · int64

First tradeId

Example: 600507

lastId

integer · int64

Last tradeId

Example: 697803

count

integer · int64

Total number of trades in the 24h window.

Example: 97297

Top Trader Long/Short Account Ratio

The proportion of net long and net short accounts to total accounts of the top 20% users with the highest margin balance. Each account is counted once only.

Long Account % = Accounts of top traders with net long positions / Total accounts of top traders with open positions

Short Account % = Accounts of top traders with net short positions / Total accounts of top traders with open positions

Long/Short Ratio (Accounts) = Long Account % / Short Account %

GET

/futures/data/topLongShortAccountRatio

https://dapi.binance.com

Top Trader Long/Short Account Ratio › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Top Trader Long/Short Account Ratio › Query Parameters

symbol

string · required

Symbol

Example: null

period

string · enum · required

Enum values:

15m

30m

12h

Example: 5m

limit

integer · int64 · max: 500

Maximum number of records to return.

Example: 30

Default: 30

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

Top Trader Long/Short Account Ratio › Responses

200

Top Trader Long/Short Ratio

object

pair

string

Pair

Example: BTCUSD

longShortRatio

string

Long/short ratio.

Example: 1.8105

longAccount

string

64.42%

Example: 0.6442

shortAccount

string

35.58%

Example: 0.3558

timestamp

integer · int64

Timestamp in milliseconds.

Example: 1591261042378

Top Trader Long/Short Position Ratio

The proportion of net long and net short positions to total open positions of the top 20% users with the highest margin balance.

Long Position % = Long positions of top traders / Total open positions of top traders

Short Position % = Short positions of top traders / Total open positions of top traders

Long/Short Ratio (Positions) = Long Position % / Short Position %

GET

/futures/data/topLongShortPositionRatio

https://dapi.binance.com

Top Trader Long/Short Position Ratio › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Top Trader Long/Short Position Ratio › Query Parameters

pair

string · required

Example: BTCUSD

period

string · enum · required

Enum values:

15m

30m

12h

Example: 5m

limit

integer · int64 · max: 500

Maximum number of records to return.

Example: 30

Default: 30

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

Top Trader Long/Short Position Ratio › Responses

200

Top Trader Long/Short Ratio

object

pair

string

Pair

Example: BTCUSD

longShortRatio

string

Long/short ratio.

Example: 0.7869

longPosition

string

64.42%

Example: 0.6442

shortPosition

string

44.04%

Example: 0.4404

timestamp

integer · int64

Timestamp in milliseconds.

Example: 1592870400000