Market Data

Endpoint

Download schema

List Prediction Categories

Get all available prediction market categories (L1 and L2).

GET

/sapi/v1/w3w/wallet/prediction/category/list

https://api.binance.com

List Prediction Categories › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

List Prediction Categories › Request Weight

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

IP Weight200

List Prediction Categories › Query Parameters

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

List Prediction Categories › Responses

200

List Prediction Categories

object[]

id

string

Example: crypto

name

string

Example: Crypto

icon

string

Example: crypto_icon

order

integer

Example: 1

object[]

id

string

Example: up-down

name

string

Example: Up/Down

icon

string

Example: updown_icon

order

integer

Example: 1

List Prediction Markets

Get a paginated list of prediction market topics, with optional category and sort filters.

GET

/sapi/v1/w3w/wallet/prediction/market/list

https://api.binance.com

List Prediction Markets › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

List Prediction Markets › Request Weight

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

IP Weight200

List Prediction Markets › Query Parameters

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

l1Category

string

Level-1 category filter

Example: crypto

l2Category

string

Level-2 category filter

Example: up-down

sortBy

string · enum

Sort field. Enum: RECOMMENDED, VOLUME, PARTICIPANTS, CREATED_TIME, END_DATE

Enum values:

RECOMMENDED

VOLUME

PARTICIPANTS

CREATED_TIME

END_DATE

Example: VOLUME

orderBy

string · enum

Sort direction. Enum: ASC, DESC

Enum values:

ASC

DESC

Example: DESC

offset

integer · int32 · min: 0

Pagination offset. Default 0

Example: 0

Default: 0

limit

integer · int32 · min: 1 · max: 100

Page size. Default 20, range 1–100

Example: 20

Default: 20

List Prediction Markets › Responses

200

List Prediction Markets

object[]

marketTopicId

integer · int64

Example: 4229564

vendor

string

Example: PREDICT_FUN

chainId

string

Example: 56

slug

string

Example: btc-price-1h-up-or-down

title

string

Example: BTC Price 1h Up or Down?

question

string

Example: Will BTC price go UP in the next 1 hour?

description

string

Example: Resolves YES if BTC spot price is higher than the starting price at resolution time.

imageUrl

string

Example: https://cdn.example.com/prediction/btc-1h.png

topicType

string

Example: FLAT

chartType

string

Example: CRYPTO_UP_DOWN

symbol

string

Example: BTCUSDT

participantCount

integer

Example: 3420

collateral

string

Example: USDT

feeRateBps

integer

Example: 200

slippageBps

integer

Example: 1200

isYieldBearing

boolean

Example: false

tradeVolume

string

Example: 158234.56

liquidity

string

Example: 45000.00

publishedAt

integer · int64

Example: 1748100000000

startDate

integer · int64

Example: 1748131200000

endDate

integer · int64

Example: 1748134800000

status

string

Example: REGISTERED

object[]

total

integer

Example: 128

offset

integer

Example: 0

limit

integer

Example: 20

hasMore

boolean

Example: true

GET/sapi/v1/w3w/wallet/prediction/market/list

curl --request GET \
  --url 'https://api.binance.com/sapi/v1/w3w/wallet/prediction/market/list?timestamp=%3Cnumber%3E'

Example Responses

{
  "marketTopics": [
    {
      "marketTopicId": 4229564,
      "vendor": "PREDICT_FUN",
      "chainId": "56",
      "slug": "btc-price-1h-up-or-down",
      "title": "BTC Price 1h Up or Down?",
      "question": "Will BTC price go UP in the next 1 hour?",
      "description": "Resolves YES if BTC spot price is higher than the starting price at resolution time.",
      "imageUrl": "https://cdn.example.com/prediction/btc-1h.png",
      "topicType": "FLAT",
      "chartType": "CRYPTO_UP_DOWN",
      "symbol": "BTCUSDT",
      "participantCount": 3420,
      "collateral": "USDT",
      "feeRateBps": 200,
      "slippageBps": 1200,
      "isYieldBearing": false,
      "tradeVolume": "158234.56",
      "liquidity": "45000.00",
      "publishedAt": 1748100000000,
      "startDate": 1748131200000,
      "endDate": 1748134800000,
      "status": "REGISTERED",
      "markets": [
        {}
      ]
    }
  ],
  "total": 128,
  "offset": 0,
  "limit": 20,
  "hasMore": true
}

json

application/json

Market Search

Semantic search for prediction market topics by keyword.

GET

/sapi/v1/w3w/wallet/prediction/market/search

https://api.binance.com

Market Search › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

Market Search › Request Weight

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

IP Weight200

Market Search › Query Parameters

query

string · required

Search keyword. Not blank

Example: BTC price

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

topK

integer · int32 · min: 1 · max: 50

Max number of results to return. Default 20, range 1–50

Example: 20

Default: 20

Market Search › Responses

200

Market Search

object

marketTopicId

integer · int64

Example: 4229564

vendor

string

Example: PREDICT_FUN

chainId

string

Example: 56

slug

string

Example: btc-price-1h-up-or-down

title

string

Example: BTC Price 1h Up or Down?

question

string

Example: Will BTC price go UP in the next 1 hour?

description

string

Example: Resolves YES if BTC spot price is higher than the starting price.

topicType

string

Example: FLAT

chartType

string

Example: CRYPTO_UP_DOWN

symbol

string

Example: BTCUSDT

participantCount

integer

Example: 3420

collateral

string

Example: USDT

tradeVolume

string

Example: 158234.56

liquidity

string

Example: 45000.00

startDate

integer · int64

Example: 1748131200000

endDate

integer · int64

Example: 1748134800000

status

string

Example: REGISTERED

object[]

GET/sapi/v1/w3w/wallet/prediction/market/search

curl --request GET \
  --url 'https://api.binance.com/sapi/v1/w3w/wallet/prediction/market/search?query=%3Cstring%3E&timestamp=%3Cnumber%3E'

Example Responses

[
  {
    "marketTopicId": 4229564,
    "vendor": "PREDICT_FUN",
    "chainId": "56",
    "slug": "btc-price-1h-up-or-down",
    "title": "BTC Price 1h Up or Down?",
    "question": "Will BTC price go UP in the next 1 hour?",
    "description": "Resolves YES if BTC spot price is higher than the starting price.",
    "topicType": "FLAT",
    "chartType": "CRYPTO_UP_DOWN",
    "symbol": "BTCUSDT",
    "participantCount": 3420,
    "collateral": "USDT",
    "tradeVolume": "158234.56",
    "liquidity": "45000.00",
    "startDate": 1748131200000,
    "endDate": 1748134800000,
    "status": "REGISTERED",
    "markets": [
      {}
    ]
  }
]

json

application/json

Get Market Detail

Get full details for a specific prediction market topic, including variant data and timeline.

GET

/sapi/v1/w3w/wallet/prediction/market/detail

https://api.binance.com

Get Market Detail › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

Get Market Detail › Request Weight

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

IP Weight200

Get Market Detail › Query Parameters

marketTopicId

integer · int64 · min: 1 · required

Market topic ID. Must be > 0

Example: 4229564

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

Get Market Detail › Responses

200

Get Market Detail

marketTopicId

integer · int64

Example: 4229564

vendor

string

Example: PREDICT_FUN

chainId

string

Example: 56

slug

string

Example: btc-price-1h-up-or-down

title

string

Example: BTC Price 1h Up or Down?

question

string

Example: Will BTC price go UP in the next 1 hour?

description

string

Example: Resolves YES if BTC spot price is higher than the starting price at resolution time.

imageUrl

string

Example: https://cdn.example.com/prediction/btc-1h.png

topicType

string

Example: FLAT

chartType

string

Example: CRYPTO_UP_DOWN

symbol

string

Example: BTCUSDT

object

type

string

Example: CRYPTO_UP_DOWN

startPrice

string

Example: 67890.12

endPrice

string | null

Example: null

priceFeedId

string

Example: 0xpricefeedid123

priceFeedProvider

string

Example: BINANCE

priceFeedSymbol

string

Example: BTCUSDT

participantCount

integer

Example: 3420

collateral

string

Example: USDT

feeRateBps

integer

Example: 200

slippageBps

integer

Example: 1200

isYieldBearing

boolean

Example: false

tradeVolume

string

Example: 158234.56

liquidity

string

Example: 45000.00

publishedAt

integer · int64

Example: 1748100000000

startDate

integer · int64

Example: 1748131200000

endDate

integer · int64

Example: 1748134800000

status

string

Example: REGISTERED

object[]

marketTopicId

integer · int64

Example: 4229560

startDate

integer · int64

Example: 1748127600000

endDate

integer · int64

Example: 1748131200000

object[]

marketId

integer · int64

Example: 5567895

externalId

string

Example: ext_001

title

string

Example: UP

question

string

Example: Will BTC go UP?

description

string

Example: Resolves YES if BTC price increases.

conditionId

string

Example: 0xabc123

status

string

Example: REGISTERED

tradingStatus

string

Example: OPEN

tradeVolume

string

Example: 90000.00

liquidity

string

Example: 25000.00

decimalPrecision

integer

Example: 2

object[]

name

string

Example: YES

price

string

Example: 0.52

chance

string

Example: 0.52

index

integer

Example: 0

tokenId

string

Example: 112233

GET/sapi/v1/w3w/wallet/prediction/market/detail

curl --request GET \
  --url 'https://api.binance.com/sapi/v1/w3w/wallet/prediction/market/detail?marketTopicId=%3Cnumber%3E&timestamp=%3Cnumber%3E'

Example Responses

{
  "marketTopicId": 4229564,
  "vendor": "PREDICT_FUN",
  "chainId": "56",
  "slug": "btc-price-1h-up-or-down",
  "title": "BTC Price 1h Up or Down?",
  "question": "Will BTC price go UP in the next 1 hour?",
  "description": "Resolves YES if BTC spot price is higher than the starting price at resolution time.",
  "imageUrl": "https://cdn.example.com/prediction/btc-1h.png",
  "topicType": "FLAT",
  "chartType": "CRYPTO_UP_DOWN",
  "symbol": "BTCUSDT",
  "variantData": {
    "type": "CRYPTO_UP_DOWN",
    "startPrice": "67890.12",
    "endPrice": null,
    "priceFeedId": "0xpricefeedid123",
    "priceFeedProvider": "BINANCE",
    "priceFeedSymbol": "BTCUSDT"
  },
  "participantCount": 3420,
  "collateral": "USDT",
  "feeRateBps": 200,
  "slippageBps": 1200,
  "isYieldBearing": false,
  "tradeVolume": "158234.56",
  "liquidity": "45000.00",
  "publishedAt": 1748100000000,
  "startDate": 1748131200000,
  "endDate": 1748134800000,
  "status": "REGISTERED",
  "timeline": [
    {
      "marketTopicId": 4229560,
      "startDate": 1748127600000,
      "endDate": 1748131200000
    }
  ],
  "markets": [
    {
      "marketId": 5567895,
      "externalId": "ext_001",
      "title": "UP",
      "question": "Will BTC go UP?",
      "description": "Resolves YES if BTC price increases.",
      "conditionId": "0xabc123",
      "status": "REGISTERED",
      "tradingStatus": "OPEN",
      "tradeVolume": "90000.00",
      "liquidity": "25000.00",
      "decimalPrecision": 2,
      "outcomes": [
        {
          "name": "YES",
          "price": "0.52",
          "chance": "0.52",
          "index": 0,
          "tokenId": "112233"
        }
      ]
    }
  ]
}

json

application/json

Query Order Book

Get the current order book (bids and asks) for a specific prediction market outcome token.

GET

/sapi/v1/w3w/wallet/prediction/order-book

https://api.binance.com

Query Order Book › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

Query Order Book › Request Weight

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

IP Weight200

Query Order Book › Query Parameters

vendor

string · required

Vendor identifier (e.g. predict_fun)

Example: predict_fun

marketId

integer · int64 · min: 1 · required

Market ID. Must be > 0

Example: 5567895

tokenId

string · required

Prediction outcome token ID

Example: 112233

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

Query Order Book › Responses

200

Query Order Book

outcome

string

Example: YES

tokenId

string

Example: 112233

timestamp

integer · int64

Example: 1748131800000

object[]

price

string

Example: 0.51

size

string

Example: 5000.00

object[]

price

string

Example: 0.52

size

string

Example: 3000.00

Query Last Trade Price

Get the most recent trade price for a prediction market.

GET

/sapi/v1/w3w/wallet/prediction/order-book/last-trade-price

https://api.binance.com

Query Last Trade Price › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

Query Last Trade Price › Request Weight

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

IP Weight200

Query Last Trade Price › Query Parameters

marketId

integer · int64 · min: 1 · required

Market ID. Must be > 0

Example: 5567895

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

Query Last Trade Price › Responses

200

Query Last Trade Price

marketId

integer · int64

Example: 5567895

lastTradePrice

string

Example: 0.52

Market Data

Endpoint

Download schema

List Prediction Categories

Get all available prediction market categories (L1 and L2).

GET

/sapi/v1/w3w/wallet/prediction/category/list

https://api.binance.com

List Prediction Categories › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

List Prediction Categories › Request Weight

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

IP Weight200

List Prediction Categories › Query Parameters

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

List Prediction Categories › Responses

200

List Prediction Categories

object[]

id

string

Example: crypto

name

string

Example: Crypto

icon

string

Example: crypto_icon

order

integer

Example: 1

object[]

id

string

Example: up-down

name

string

Example: Up/Down

icon

string

Example: updown_icon

order

integer

Example: 1

List Prediction Markets

Get a paginated list of prediction market topics, with optional category and sort filters.

GET

/sapi/v1/w3w/wallet/prediction/market/list

https://api.binance.com

List Prediction Markets › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

List Prediction Markets › Request Weight

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

IP Weight200

List Prediction Markets › Query Parameters

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

l1Category

string

Level-1 category filter

Example: crypto

l2Category

string

Level-2 category filter

Example: up-down

sortBy

string · enum

Sort field. Enum: RECOMMENDED, VOLUME, PARTICIPANTS, CREATED_TIME, END_DATE

Enum values:

RECOMMENDED

VOLUME

PARTICIPANTS

CREATED_TIME

END_DATE

Example: VOLUME

orderBy

string · enum

Sort direction. Enum: ASC, DESC

Enum values:

ASC

DESC

Example: DESC

offset

integer · int32 · min: 0

Pagination offset. Default 0

Example: 0

Default: 0

limit

integer · int32 · min: 1 · max: 100

Page size. Default 20, range 1–100

Example: 20

Default: 20

List Prediction Markets › Responses

200

List Prediction Markets

object[]

marketTopicId

integer · int64

Example: 4229564

vendor

string

Example: PREDICT_FUN

chainId

string

Example: 56

slug

string

Example: btc-price-1h-up-or-down

title

string

Example: BTC Price 1h Up or Down?

question

string

Example: Will BTC price go UP in the next 1 hour?

description

string

Example: Resolves YES if BTC spot price is higher than the starting price at resolution time.

imageUrl

string

Example: https://cdn.example.com/prediction/btc-1h.png

topicType

string

Example: FLAT

chartType

string

Example: CRYPTO_UP_DOWN

symbol

string

Example: BTCUSDT

participantCount

integer

Example: 3420

collateral

string

Example: USDT

feeRateBps

integer

Example: 200

slippageBps

integer

Example: 1200

isYieldBearing

boolean

Example: false

tradeVolume

string

Example: 158234.56

liquidity

string

Example: 45000.00

publishedAt

integer · int64

Example: 1748100000000

startDate

integer · int64

Example: 1748131200000

endDate

integer · int64

Example: 1748134800000

status

string

Example: REGISTERED

object[]

total

integer

Example: 128

offset

integer

Example: 0

limit

integer

Example: 20

hasMore

boolean

Example: true

GET/sapi/v1/w3w/wallet/prediction/market/list

curl --request GET \
  --url 'https://api.binance.com/sapi/v1/w3w/wallet/prediction/market/list?timestamp=%3Cnumber%3E'

Example Responses

{
  "marketTopics": [
    {
      "marketTopicId": 4229564,
      "vendor": "PREDICT_FUN",
      "chainId": "56",
      "slug": "btc-price-1h-up-or-down",
      "title": "BTC Price 1h Up or Down?",
      "question": "Will BTC price go UP in the next 1 hour?",
      "description": "Resolves YES if BTC spot price is higher than the starting price at resolution time.",
      "imageUrl": "https://cdn.example.com/prediction/btc-1h.png",
      "topicType": "FLAT",
      "chartType": "CRYPTO_UP_DOWN",
      "symbol": "BTCUSDT",
      "participantCount": 3420,
      "collateral": "USDT",
      "feeRateBps": 200,
      "slippageBps": 1200,
      "isYieldBearing": false,
      "tradeVolume": "158234.56",
      "liquidity": "45000.00",
      "publishedAt": 1748100000000,
      "startDate": 1748131200000,
      "endDate": 1748134800000,
      "status": "REGISTERED",
      "markets": [
        {}
      ]
    }
  ],
  "total": 128,
  "offset": 0,
  "limit": 20,
  "hasMore": true
}

json

application/json

Market Search

Semantic search for prediction market topics by keyword.

GET

/sapi/v1/w3w/wallet/prediction/market/search

https://api.binance.com

Market Search › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

Market Search › Request Weight

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

IP Weight200

Market Search › Query Parameters

query

string · required

Search keyword. Not blank

Example: BTC price

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

topK

integer · int32 · min: 1 · max: 50

Max number of results to return. Default 20, range 1–50

Example: 20

Default: 20

Market Search › Responses

200

Market Search

object

marketTopicId

integer · int64

Example: 4229564

vendor

string

Example: PREDICT_FUN

chainId

string

Example: 56

slug

string

Example: btc-price-1h-up-or-down

title

string

Example: BTC Price 1h Up or Down?

question

string

Example: Will BTC price go UP in the next 1 hour?

description

string

Example: Resolves YES if BTC spot price is higher than the starting price.

topicType

string

Example: FLAT

chartType

string

Example: CRYPTO_UP_DOWN

symbol

string

Example: BTCUSDT

participantCount

integer

Example: 3420

collateral

string

Example: USDT

tradeVolume

string

Example: 158234.56

liquidity

string

Example: 45000.00

startDate

integer · int64

Example: 1748131200000

endDate

integer · int64

Example: 1748134800000

status

string

Example: REGISTERED

object[]

GET/sapi/v1/w3w/wallet/prediction/market/search

curl --request GET \
  --url 'https://api.binance.com/sapi/v1/w3w/wallet/prediction/market/search?query=%3Cstring%3E&timestamp=%3Cnumber%3E'

Example Responses

[
  {
    "marketTopicId": 4229564,
    "vendor": "PREDICT_FUN",
    "chainId": "56",
    "slug": "btc-price-1h-up-or-down",
    "title": "BTC Price 1h Up or Down?",
    "question": "Will BTC price go UP in the next 1 hour?",
    "description": "Resolves YES if BTC spot price is higher than the starting price.",
    "topicType": "FLAT",
    "chartType": "CRYPTO_UP_DOWN",
    "symbol": "BTCUSDT",
    "participantCount": 3420,
    "collateral": "USDT",
    "tradeVolume": "158234.56",
    "liquidity": "45000.00",
    "startDate": 1748131200000,
    "endDate": 1748134800000,
    "status": "REGISTERED",
    "markets": [
      {}
    ]
  }
]

json

application/json

Get Market Detail

Get full details for a specific prediction market topic, including variant data and timeline.

GET

/sapi/v1/w3w/wallet/prediction/market/detail

https://api.binance.com

Get Market Detail › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

Get Market Detail › Request Weight

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

IP Weight200

Get Market Detail › Query Parameters

marketTopicId

integer · int64 · min: 1 · required

Market topic ID. Must be > 0

Example: 4229564

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

Get Market Detail › Responses

200

Get Market Detail

marketTopicId

integer · int64

Example: 4229564

vendor

string

Example: PREDICT_FUN

chainId

string

Example: 56

slug

string

Example: btc-price-1h-up-or-down

title

string

Example: BTC Price 1h Up or Down?

question

string

Example: Will BTC price go UP in the next 1 hour?

description

string

Example: Resolves YES if BTC spot price is higher than the starting price at resolution time.

imageUrl

string

Example: https://cdn.example.com/prediction/btc-1h.png

topicType

string

Example: FLAT

chartType

string

Example: CRYPTO_UP_DOWN

symbol

string

Example: BTCUSDT

object

type

string

Example: CRYPTO_UP_DOWN

startPrice

string

Example: 67890.12

endPrice

string | null

Example: null

priceFeedId

string

Example: 0xpricefeedid123

priceFeedProvider

string

Example: BINANCE

priceFeedSymbol

string

Example: BTCUSDT

participantCount

integer

Example: 3420

collateral

string

Example: USDT

feeRateBps

integer

Example: 200

slippageBps

integer

Example: 1200

isYieldBearing

boolean

Example: false

tradeVolume

string

Example: 158234.56

liquidity

string

Example: 45000.00

publishedAt

integer · int64

Example: 1748100000000

startDate

integer · int64

Example: 1748131200000

endDate

integer · int64

Example: 1748134800000

status

string

Example: REGISTERED

object[]

marketTopicId

integer · int64

Example: 4229560

startDate

integer · int64

Example: 1748127600000

endDate

integer · int64

Example: 1748131200000

object[]

marketId

integer · int64

Example: 5567895

externalId

string

Example: ext_001

title

string

Example: UP

question

string

Example: Will BTC go UP?

description

string

Example: Resolves YES if BTC price increases.

conditionId

string

Example: 0xabc123

status

string

Example: REGISTERED

tradingStatus

string

Example: OPEN

tradeVolume

string

Example: 90000.00

liquidity

string

Example: 25000.00

decimalPrecision

integer

Example: 2

object[]

name

string

Example: YES

price

string

Example: 0.52

chance

string

Example: 0.52

index

integer

Example: 0

tokenId

string

Example: 112233

GET/sapi/v1/w3w/wallet/prediction/market/detail

curl --request GET \
  --url 'https://api.binance.com/sapi/v1/w3w/wallet/prediction/market/detail?marketTopicId=%3Cnumber%3E&timestamp=%3Cnumber%3E'

Example Responses

{
  "marketTopicId": 4229564,
  "vendor": "PREDICT_FUN",
  "chainId": "56",
  "slug": "btc-price-1h-up-or-down",
  "title": "BTC Price 1h Up or Down?",
  "question": "Will BTC price go UP in the next 1 hour?",
  "description": "Resolves YES if BTC spot price is higher than the starting price at resolution time.",
  "imageUrl": "https://cdn.example.com/prediction/btc-1h.png",
  "topicType": "FLAT",
  "chartType": "CRYPTO_UP_DOWN",
  "symbol": "BTCUSDT",
  "variantData": {
    "type": "CRYPTO_UP_DOWN",
    "startPrice": "67890.12",
    "endPrice": null,
    "priceFeedId": "0xpricefeedid123",
    "priceFeedProvider": "BINANCE",
    "priceFeedSymbol": "BTCUSDT"
  },
  "participantCount": 3420,
  "collateral": "USDT",
  "feeRateBps": 200,
  "slippageBps": 1200,
  "isYieldBearing": false,
  "tradeVolume": "158234.56",
  "liquidity": "45000.00",
  "publishedAt": 1748100000000,
  "startDate": 1748131200000,
  "endDate": 1748134800000,
  "status": "REGISTERED",
  "timeline": [
    {
      "marketTopicId": 4229560,
      "startDate": 1748127600000,
      "endDate": 1748131200000
    }
  ],
  "markets": [
    {
      "marketId": 5567895,
      "externalId": "ext_001",
      "title": "UP",
      "question": "Will BTC go UP?",
      "description": "Resolves YES if BTC price increases.",
      "conditionId": "0xabc123",
      "status": "REGISTERED",
      "tradingStatus": "OPEN",
      "tradeVolume": "90000.00",
      "liquidity": "25000.00",
      "decimalPrecision": 2,
      "outcomes": [
        {
          "name": "YES",
          "price": "0.52",
          "chance": "0.52",
          "index": 0,
          "tokenId": "112233"
        }
      ]
    }
  ]
}

json

application/json

Query Order Book

Get the current order book (bids and asks) for a specific prediction market outcome token.

GET

/sapi/v1/w3w/wallet/prediction/order-book

https://api.binance.com

Query Order Book › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

Query Order Book › Request Weight

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

IP Weight200

Query Order Book › Query Parameters

vendor

string · required

Vendor identifier (e.g. predict_fun)

Example: predict_fun

marketId

integer · int64 · min: 1 · required

Market ID. Must be > 0

Example: 5567895

tokenId

string · required

Prediction outcome token ID

Example: 112233

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

Query Order Book › Responses

200

Query Order Book

outcome

string

Example: YES

tokenId

string

Example: 112233

timestamp

integer · int64

Example: 1748131800000

object[]

price

string

Example: 0.51

size

string

Example: 5000.00

object[]

price

string

Example: 0.52

size

string

Example: 3000.00

Query Last Trade Price

Get the most recent trade price for a prediction market.

GET

/sapi/v1/w3w/wallet/prediction/order-book/last-trade-price

https://api.binance.com

Query Last Trade Price › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

Query Last Trade Price › Request Weight

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

IP Weight200

Query Last Trade Price › Query Parameters

marketId

integer · int64 · min: 1 · required

Market ID. Must be > 0

Example: 5567895

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

Query Last Trade Price › Responses

200

Query Last Trade Price

marketId

integer · int64

Example: 5567895

lastTradePrice

string

Example: 0.52