DeFi Data

Get DeFi Positions

Query DeFi positions for one or more wallet addresses across the supported chains. Returns protocol-level position summaries with token breakdowns. Optionally filter by specific chains via binanceChainIds; when omitted, positions across all supported chains are returned. Position coverage is wider than the protocol list used by data queries and transaction building — see Supported Chains & Protocols for the difference.

POST/api/v1/defi/data/position/list

Endpoint https://web3.binance.com/build

Authorization

This is a signed endpoint and a signature must be included in the request headers. Learn more about how to generate a valid signature in the Authentication.

Headers

X-OC-APIKEYstringrequired

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMPstringrequired

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGNstringrequired

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOWinteger · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCEstring

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Request Body

addressesstring[] · maxItems: 3required

Wallet addresses to query positions for. Up to 3 addresses per request (server-side configured and subject to change); the limit is shared across chains — a multi-chain query consumes the same 3-address budget.

Example: ["0x66faa5ded68cc83a71bc172fb03c17a6bcb32f7a"]

binanceChainIdsstring[]

Optional chain filter. When set, only positions on the specified chains are returned; when omitted, positions across all supported chains are returned. See Supported Chains & Protocols for the supported chain ID values — unsupported values are rejected with 40001.

Example: ["56"]

forceRefreshboolean

Force a cache bypass and re-read the latest on-chain state. Defaults to false (serves cached data). Set to true right after a redeem / claim to see the updated position immediately — the cache otherwise lags by a short window.

Example: true

Responses

DeFi positions returned successfully.