Transfer

Endpoint

Create Inbound Transfer

Transfer funds from the prediction wallet back to the user's CEX account (SPOT or FUNDING). Requires SAS authorization.

⚠️ SAS Authorization Required: This endpoint enforces SAS (Self-Authorization Service) authorization. If SAS is not enabled for the wallet, the request will be rejected with -31003 SAS authorization required. Enable SAS for your wallet before calling this endpoint.

POST

/sapi/v1/w3w/wallet/prediction/transfer/inbound

https://api.binance.com

Create Inbound Transfer › Authorization

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

Create Inbound Transfer › Request Weight

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

IP Weight200

Create Inbound Transfer › 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

Create Inbound Transfer › 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

Create Inbound Transfer › Request Body

walletId

string · required

Wallet ID

Example: 5b5c1ec3be4e4416a5872b21c1ca5d20

walletAddress

string · required

User's prediction wallet address

Example: 0x12e32db8817e292508c34111cbc4b23340df542c

fromTokenAmount

string · required

Transfer amount in wei (18 decimals). Must be > 0. Example: 1000000000000000000 = 1 USDT

Example: 1000000000000000000

accountType

string · enum · required

Destination CEX account. Enum: SPOT, FUNDING

Enum values:

SPOT

FUNDING

Example: SPOT

fromToken

string

Source token symbol. Default USDT

Example: USDT

Default: USDT

toToken

string

Destination token symbol. Default USDT

Example: USDT

Default: USDT

chainId

string

Chain ID. Default 56 (BSC)

Example: 56

Default: 56

Create Inbound Transfer › Responses

200

Create Inbound Transfer

transferId

string

Example: tf_20260525_in_001

status

string

Example: PROCESSING

Create Outbound Transfer

Transfer funds from the user's CEX account (SPOT or FUNDING) into the prediction wallet. Requires SAS authorization.

POST

/sapi/v1/w3w/wallet/prediction/transfer/outbound

https://api.binance.com

Create Outbound Transfer › Authorization

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

Create Outbound Transfer › Request Weight

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

IP Weight200

Create Outbound Transfer › 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

Create Outbound Transfer › 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

Create Outbound Transfer › Request Body

walletId

string · required

Wallet ID

Example: 5b5c1ec3be4e4416a5872b21c1ca5d20

walletAddress

string · required

User's prediction wallet address

Example: 0x12e32db8817e292508c34111cbc4b23340df542c

fromTokenAmount

string · required

Transfer amount in wei (18 decimals). Must be > 0. Example: 1000000000000000000 = 1 USDT

Example: 1000000000000000000

accountType

string · enum · required

Source CEX account. Enum: SPOT, FUNDING

Enum values:

SPOT

FUNDING

Example: SPOT

sourceBiz

string · enum · required

Business source. Enum: USER_TRANSFER, PREDICTION_BUY

Enum values:

USER_TRANSFER

PREDICTION_BUY

Example: USER_TRANSFER

fromToken

string

Source token symbol. Default USDT

Example: USDT

Default: USDT

toToken

string

Destination token symbol. Default USDT

Example: USDT

Default: USDT

chainId

string

Chain ID. Default 56 (BSC)

Example: 56

Default: 56

Create Outbound Transfer › Responses

200

Create Outbound Transfer

transferId

string

Example: tf_20260525_out_001

status

string

Example: PROCESSING

POST/sapi/v1/w3w/wallet/prediction/transfer/outbound

curl --request POST \
  --url 'https://api.binance.com/sapi/v1/w3w/wallet/prediction/transfer/outbound?timestamp=%3Cnumber%3E' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data walletId=5b5c1ec3be4e4416a5872b21c1ca5d20 \
  --data walletAddress=0x12e32db8817e292508c34111cbc4b23340df542c \
  --data fromTokenAmount=1000000000000000000 \
  --data accountType=SPOT \
  --data sourceBiz=USER_TRANSFER

Example Request Body

{
  "walletId": "5b5c1ec3be4e4416a5872b21c1ca5d20",
  "walletAddress": "0x12e32db8817e292508c34111cbc4b23340df542c",
  "fromTokenAmount": "1000000000000000000",
  "accountType": "SPOT",
  "sourceBiz": "USER_TRANSFER"
}

json

Example Responses

{
  "transferId": "tf_20260525_out_001",
  "status": "PROCESSING"
}

json

application/json

Query Transfer List

Get the authenticated user's prediction wallet transfer history within a date range.

GET

/sapi/v1/w3w/wallet/prediction/transfer/list

https://api.binance.com

Query Transfer List › Authorization

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

Query Transfer List › Request Weight

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

IP Weight200

Query Transfer List › 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

Query Transfer List › Query Parameters

walletAddress

string · required

User's prediction wallet address

Example: 0x12e32db8817e292508c34111cbc4b23340df542c

startDate

string · required

Start date. Format: yyyy-MM-dd. Must be ≤ endDate

Example: 2026-05-01

endDate

string · required

End date. Format: yyyy-MM-dd. Must be ≥ startDate

Example: 2026-05-25

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

tokenSymbol

string

Filter by token symbol (e.g. USDT)

Example: USDT

direction

string · enum

Filter by direction. Enum: INBOUND, OUTBOUND

Enum values:

INBOUND

OUTBOUND

Example: OUTBOUND

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

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Query Transfer List › Responses

200

Query Transfer List

object[]

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

curl --request GET \
  --url 'https://api.binance.com/sapi/v1/w3w/wallet/prediction/transfer/list?walletAddress=%3Cstring%3E&startDate=%3Cstring%3E&endDate=%3Cstring%3E&timestamp=%3Cnumber%3E' \
  --header 'X-MBX-APIKEY: <string>'

Example Responses

{
  "transfers": [
    {
      "transferId": "tf_20260525_out_001",
      "direction": "OUTBOUND",
      "status": "SUCCESS",
      "walletAddress": "0x12e32db8817e292508c34111cbc4b23340df542c",
      "fromToken": "USDT",
      "fromTokenAmount": "100.00",
      "toToken": "USDT",
      "toTokenAmount": "100.00",
      "errorCode": null,
      "errorMessage": null,
      "createTime": "2026-05-25T04:00:00.000+00:00",
      "updateTime": "2026-05-25T04:00:05.000+00:00",
      "completeAt": "2026-05-25T04:00:05.000+00:00"
    }
  ]
}

json

application/json

Query Transfer Status

Query the current status of a prediction wallet transfer by transfer ID.

status values: Terminal states are COMPLETED and FAILED. Intermediate states are PROCESSING and PENDING. Do not poll for SUCCESS — it is not a valid terminal state.

GET

/sapi/v1/w3w/wallet/prediction/transfer/status

https://api.binance.com

Query Transfer Status › Authorization

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

Query Transfer Status › Request Weight

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

IP Weight200

Query Transfer Status › 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

Query Transfer Status › Query Parameters

transferId

string · required

Transfer ID returned from outbound/inbound transfer

Example: tf_20260525_out_001

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

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Query Transfer Status › Responses

200

Query Transfer Status

transferId

string

Example: tf_20260525_out_001

direction

string

Example: OUTBOUND

status

string · enum

Enum values:

COMPLETED

FAILED

PROCESSING

PENDING

Example: COMPLETED

fromToken

string

Example: USDT

fromTokenAmount

string

Example: 100.00

toToken

string

Example: USDT

toTokenAmount

string

Example: 100.00

errorCode

string | null

Example: null

errorMessage

string | null

Example: null

createTime

string

Example: 2026-05-25T04:00:00.000+00:00

updateTime

string

Example: 2026-05-25T04:00:05.000+00:00

Create Inbound Transfer

Transfer funds from the prediction wallet back to the user's CEX account (SPOT or FUNDING). Requires SAS authorization.

POST

/sapi/v1/w3w/wallet/prediction/transfer/inbound

https://api.binance.com

Create Inbound Transfer › Authorization

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

Create Inbound Transfer › Request Weight

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

IP Weight200

Create Inbound Transfer › 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

Create Inbound Transfer › 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

Create Inbound Transfer › Request Body

walletId

string · required

Wallet ID

Example: 5b5c1ec3be4e4416a5872b21c1ca5d20

walletAddress

string · required

User's prediction wallet address

Example: 0x12e32db8817e292508c34111cbc4b23340df542c

fromTokenAmount

string · required

Transfer amount in wei (18 decimals). Must be > 0. Example: 1000000000000000000 = 1 USDT

Example: 1000000000000000000

accountType

string · enum · required

Destination CEX account. Enum: SPOT, FUNDING

Enum values:

SPOT

FUNDING

Example: SPOT

fromToken

string

Source token symbol. Default USDT

Example: USDT

Default: USDT

toToken

string

Destination token symbol. Default USDT

Example: USDT

Default: USDT

chainId

string

Chain ID. Default 56 (BSC)

Example: 56

Default: 56

Create Inbound Transfer › Responses

200

Create Inbound Transfer

transferId

string

Example: tf_20260525_in_001

status

string

Example: PROCESSING

Create Outbound Transfer

Transfer funds from the user's CEX account (SPOT or FUNDING) into the prediction wallet. Requires SAS authorization.

POST

/sapi/v1/w3w/wallet/prediction/transfer/outbound

https://api.binance.com

Create Outbound Transfer › Authorization

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

Create Outbound Transfer › Request Weight

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

IP Weight200

Create Outbound Transfer › 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

Create Outbound Transfer › 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

Create Outbound Transfer › Request Body

walletId

string · required

Wallet ID

Example: 5b5c1ec3be4e4416a5872b21c1ca5d20

walletAddress

string · required

User's prediction wallet address

Example: 0x12e32db8817e292508c34111cbc4b23340df542c

fromTokenAmount

string · required

Transfer amount in wei (18 decimals). Must be > 0. Example: 1000000000000000000 = 1 USDT

Example: 1000000000000000000

accountType

string · enum · required

Source CEX account. Enum: SPOT, FUNDING

Enum values:

SPOT

FUNDING

Example: SPOT

sourceBiz

string · enum · required

Business source. Enum: USER_TRANSFER, PREDICTION_BUY

Enum values:

USER_TRANSFER

PREDICTION_BUY

Example: USER_TRANSFER

fromToken

string

Source token symbol. Default USDT

Example: USDT

Default: USDT

toToken

string

Destination token symbol. Default USDT

Example: USDT

Default: USDT

chainId

string

Chain ID. Default 56 (BSC)

Example: 56

Default: 56

Create Outbound Transfer › Responses

200

Create Outbound Transfer

transferId

string

Example: tf_20260525_out_001

status

string

Example: PROCESSING

Query Transfer List

Get the authenticated user's prediction wallet transfer history within a date range.

GET

/sapi/v1/w3w/wallet/prediction/transfer/list

https://api.binance.com

Query Transfer List › Authorization

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

Query Transfer List › Request Weight

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

IP Weight200

Query Transfer List › 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

Query Transfer List › Query Parameters

walletAddress

string · required

User's prediction wallet address

Example: 0x12e32db8817e292508c34111cbc4b23340df542c

startDate

string · required

Start date. Format: yyyy-MM-dd. Must be ≤ endDate

Example: 2026-05-01

endDate

string · required

End date. Format: yyyy-MM-dd. Must be ≥ startDate

Example: 2026-05-25

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

tokenSymbol

string

Filter by token symbol (e.g. USDT)

Example: USDT

direction

string · enum

Filter by direction. Enum: INBOUND, OUTBOUND

Enum values:

INBOUND

OUTBOUND

Example: OUTBOUND

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

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Query Transfer List › Responses

200

Query Transfer List

object[]

Query Transfer Status

Query the current status of a prediction wallet transfer by transfer ID.

status values: Terminal states are COMPLETED and FAILED. Intermediate states are PROCESSING and PENDING. Do not poll for SUCCESS — it is not a valid terminal state.

GET

/sapi/v1/w3w/wallet/prediction/transfer/status

https://api.binance.com

Query Transfer Status › Authorization

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

Query Transfer Status › Request Weight

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

IP Weight200

Query Transfer Status › 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

Query Transfer Status › Query Parameters

transferId

string · required

Transfer ID returned from outbound/inbound transfer

Example: tf_20260525_out_001

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

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Query Transfer Status › Responses

200

Query Transfer Status

transferId

string

Example: tf_20260525_out_001

direction

string

Example: OUTBOUND

status

string · enum

Enum values:

COMPLETED

FAILED

PROCESSING

PENDING

Example: COMPLETED

fromToken

string

Example: USDT

fromTokenAmount

string

Example: 100.00

toToken

string

Example: USDT

toTokenAmount

string

Example: 100.00

errorCode

string | null

Example: null

errorMessage

string | null

Example: null

createTime

string

Example: 2026-05-25T04:00:00.000+00:00

updateTime

string

Example: 2026-05-25T04:00:05.000+00:00