DeFi Data

Endpointhttps://web3.binance.com/build

Get DeFi Positions

Query DeFi positions for one or more wallet addresses on BSC. Returns protocol-level position summaries with token breakdowns. Optionally filter by specific chains via binanceChainIds. 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

https://web3.binance.com/build

Get DeFi Positions › 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.

Get DeFi Positions › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

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-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

Get DeFi Positions › Request Body

addresses

string[] · maxItems: 3 · required

Wallet addresses to query positions for. Up to 3 addresses per request (server-side configured and subject to change).

Example: ["0x66faa5ded68cc83a71bc172fb03c17a6bcb32f7a"]

binanceChainIds

string[]

Optional chain filter. When set, only positions on the specified chains are returned. This release supports BSC ("56") only.

Example: ["56"]

Get DeFi Positions › Responses

DeFi positions returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Human-readable status message.

Example: success

object

Aggregated DeFi positions response.

timestamp

integer · int64

Server timestamp in milliseconds.

Example: 1748601600000

success

boolean

Whether the request succeeded (mirrors code == 0).

Example: true

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

curl --request POST \
  --url https://web3.binance.com/build/api/v1/defi/data/position/list \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "addresses": [
    "0x66faa5ded68cc83a71bc172fb03c17a6bcb32f7a"
  ]
}
'

Example Request Body

{
  "addresses": [
    "0x66faa5ded68cc83a71bc172fb03c17a6bcb32f7a"
  ]
}

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "totalValue": "5000.50123456",
    "addressList": [
      {
        "address": "0x66faa5ded68cc83a71bc172fb03c17a6bcb32f7a",
        "addressTotalValue": "26.70787419",
        "protocolList": [
          {
            "binanceChainId": "56",
            "defiProtocolId": "helio",
            "protocolName": "Lista DAO",
            "protocolTotalValue": "26.70787419",
            "poolList": [
              {
                "bnPoolId": "0xd4e9b3f0fbb5129bf893f01df339935185b5ad22492fac093f391753389a8656",
                "poolCa": "0x3662d86220BE5BEA975BE9Fd8aB3d6b5D4FB4163",
                "poolType": "Liquidity Pool",
                "positionCollectionList": [
                  {
                    "positionCollectionId": "85dab74a61426fa11f02a234d5e4462c7cc62249875c212f2dbfa09a927b8097",
                    "positionCollectionDetail": {
                      "collectionIndex": "0x00000000000000000000000055d398326f99059ff775485246999027b3197955",
                      "collectionDisplayName": null,
                      "healthFactor": "1.85"
                    },
                    "positionCollectionTotalValue": "10.51121227",
                    "positionList": [
                      {
                        "positionId": "dbc71cba52420db0021821a240a3901df566fbcda97b663402ec7d52308f0e29",
                        "underlyingAssetName": "USDT-USDC",
                        "underlyingAssetId": "e73d51bced063d9e7bd5d799e51752ffb7bc6fbfa579ce41164d0dbd9cc13a4b",
                        "assetType": "locked",
                        "investmentIds": [
                          "b3e50a2dd4aab008d3410dae2a383fe5216346fb613bb1bef9b1822fe47c742a"
                        ],
                        "positionDetail": {
                          "positionIndex": "6993078",
                          "nftId": "#6993078",
                          "unlockTime": "1787744768",
                          "unlockTimeReached": false,
                          "tickLower": "-60",
                          "tickUpper": "40",
                          "active": true,
                          "proofs": {
                            "0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82": [
                              "0xb0477ce01ce3dcfc137ab44d91af37f5ed3f468421d2d2e44941dd5a8bf44aa4"
                            ]
                          },
                          "stakeState": "active",
                          "claimTypes": [
                            "LP_FEE",
                            "REWARD_INVESTMENT"
                          ],
                          "redemptionId": "redem-abc123"
                        },
                        "positionValue": "10.51121227",
                        "tokenList": {
                          "supply": [
                            {
                              "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
                              "tokenSymbol": "USDT",
                              "tokenAmount": "1000.5",
                              "tokenValue": "1000.6"
                            }
                          ],
                          "reward": [
                            {
                              "tokenAddress": "0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82",
                              "tokenSymbol": "Cake",
                              "tokenAmount": "12.3",
                              "tokenValue": "45.6"
                            }
                          ]
                        }
                      }
                    ]
                  }
                ],
                "poolDetail": {
                  "expiry": 1748601600,
                  "feeTier": "500",
                  "lpFee": "330",
                  "tickSpacing": "50",
                  "isDynamicFee": true,
                  "hookFee": "2800",
                  "tick": "59683",
                  "hooks": "0xdfdfb2c5a717ab00b370e883021f20c2fbaed277",
                  "swapProtocolFee": "300",
                  "parameters": "0x0000000000000000000000000000000000000000000000000000000000320040",
                  "fee": "2500",
                  "spokeName": null,
                  "reserveCount": null,
                  "vaultName": null
                }
              }
            ]
          }
        ]
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

List DeFi Protocols

List supported DeFi protocols with optional filtering by chain and investment type. Results are paginated and sortable.

POST

/api/v1/defi/data/protocol/list

https://web3.binance.com/build

List DeFi Protocols › 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.

List DeFi Protocols › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

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-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

List DeFi Protocols › Request Body

binanceChainId

string

Filter by Binance chain ID (e.g. "56"=BSC).

Example: 56

investType

string · enum

Filter by investment type. Known values: Earn, LiquidityPool.

Enum values:

Earn

LiquidityPool

Example: Earn

sortField

string

Field to sort by. Only two values are accepted: tvl, apy. Note: sorting by APY uses apy (the server-side field name), even though the response exposes apyBps / apyDisplay. Other values are not supported.

Example: tvl

sortDirection

string · enum

Sort direction.

Enum values:

ASC

DESC

Example: DESC

page

integer · min: 1

Page number (1-based).

Example: 1

Default: 1

size

integer · min: 1 · max: 200

Page size. Max: 200.

Example: 20

Default: 200

List DeFi Protocols › Responses

Protocol list returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Human-readable status message.

Example: success

object

Paginated protocol list result.

timestamp

integer · int64

Server timestamp in milliseconds.

Example: 1748601600000

success

boolean

Whether the request succeeded (mirrors code == 0).

Example: true

POST/api/v1/defi/data/protocol/list

curl --request POST \
  --url https://web3.binance.com/build/api/v1/defi/data/protocol/list \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '{}'

Example Request Body

{}

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "page": 1,
    "size": 20,
    "total": 10,
    "list": [
      {
        "defiProtocolId": "pancakeswap3",
        "protocolName": "PancakeSwap V3",
        "protocolLogo": "https://bin.bnbstatic.com/image/admin_mgs_image_upload/20250228/pancakeswap-logo.png",
        "tvl": "1250000.5",
        "apyBps": 1235,
        "apyDisplay": "12.35%",
        "investType": [
          "Earn",
          "LiquidityPool"
        ],
        "supportedChains": [
          "56"
        ]
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Protocol Detail

Get detailed information for a specific DeFi protocol, including description, highlights, CertiK security scores, team, fundraising, social links, and FAQ.

POST

/api/v1/defi/data/protocol/detail

https://web3.binance.com/build

Get Protocol Detail › 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.

Get Protocol Detail › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

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-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

Get Protocol Detail › Request Body

defiProtocolId

string · required

DeFi protocol identifier.

Example: pancakeswap3

Get Protocol Detail › Responses

Protocol detail returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Human-readable status message.

Example: success

object

DeFi protocol detail.

timestamp

integer · int64

Server timestamp in milliseconds.

Example: 1748601600000

success

boolean

Whether the request succeeded (mirrors code == 0).

Example: true

POST/api/v1/defi/data/protocol/detail

curl --request POST \
  --url https://web3.binance.com/build/api/v1/defi/data/protocol/detail \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "defiProtocolId": "pancakeswap3"
}
'

Example Request Body

{
  "defiProtocolId": "pancakeswap3"
}

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "defiProtocolId": "pancakeswap3",
    "protocolName": "PancakeSwap",
    "protocolLogo": "https://bin.bnbstatic.com/image/admin_mgs_image_upload/20250527/06ab0ee1-8382-4416-9395-15446112b09b.png",
    "description": "PancakeSwap is a decentralized exchange (DEX) built on BNB Chain that utilizes an automated market making (AMM) system.",
    "websiteUrl": "https://pancakeswap.finance/",
    "investType": [
      "LiquidityPool"
    ],
    "supportedChains": [
      "56"
    ],
    "tvl": "290233074",
    "tags": [
      "DeFi",
      "DEX"
    ],
    "founded": "2020",
    "fdv": "510239911.86046",
    "totalFunding": null,
    "socialLinks": {
      "x": "https://x.com/pancakeswap",
      "discord": null,
      "github": "https://github.com/pancakeswap",
      "linkedin": "https://www.linkedin.com/company/pancakeswap/",
      "telegram": null,
      "gitbook": "",
      "website": "https://pancakeswap.finance/"
    },
    "team": [
      {
        "name": "Henry Cavill",
        "role": "CEO",
        "twitter": "https://x.com/0xchefjackson",
        "linkedin": "https://www.linkedin.com/in/henry-cavill-6b6ab6229/",
        "bio": null
      }
    ],
    "fundRaising": [
      {
        "round": "Strategic",
        "amount": null,
        "date": "2022-06-06",
        "investors": [
          "YZi Labs"
        ]
      }
    ],
    "securityScore": "92.33",
    "dimensionScores": {
      "codeSecurity": "95.47",
      "fundamentalHealth": "76.7",
      "operationalResilience": "94.96",
      "communityTrust": "98",
      "governanceStrength": "98",
      "marketStability": "96"
    },
    "highlights": [
      "Project has security audits",
      "Code repo health is in excellent condition"
    ],
    "faq": [
      {
        "title": "How are rewards accrued from providing liquidity on Pancakeswap V3?",
        "answer": "• Rewards come from trading fees collected on swaps within your liquidity price range.<Br/>• Fees accumulate and increase your liquidity position value.<Br/>• Fees are accrued only when the market is trading within the range set by you."
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

List DeFi Investments

List available DeFi investment products. Filter by protocol, chain, investment type, or contract address. Results are paginated and sortable.

POST

/api/v1/defi/data/investment/list

https://web3.binance.com/build

List DeFi Investments › 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.

List DeFi Investments › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

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-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

List DeFi Investments › Request Body

investType

string · enum · required

Filter by investment type. Required. Known values: Earn, LiquidityPool.

Enum values:

Earn

LiquidityPool

Example: Earn

defiProtocolId

string

Filter by DeFi protocol ID.

Example: pancakeswap3

tokenAddressList

string[]

Filter by token addresses.

Example: ["0x55d398326f99059fF775485246999027B3197955"]

binanceChainId

string

Filter by Binance chain ID (e.g. "56"=BSC).

Example: 56

sortField

string

Example: tvl

sortDirection

string · enum

Sort direction.

Enum values:

ASC

DESC

Example: DESC

page

integer · min: 1

Page number (1-based).

Example: 1

Default: 1

size

integer · min: 1 · max: 100

Page size. Max: 100.

Example: 20

Default: 20

List DeFi Investments › Responses

Investment list returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Human-readable status message.

Example: success

object

Paginated investment list result.

timestamp

integer · int64

Server timestamp in milliseconds.

Example: 1748601600000

success

boolean

Whether the request succeeded (mirrors code == 0).

Example: true

POST/api/v1/defi/data/investment/list

curl --request POST \
  --url https://web3.binance.com/build/api/v1/defi/data/investment/list \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "investType": "Earn"
}
'

Example Request Body

{
  "investType": "Earn"
}

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "page": 1,
    "size": 20,
    "total": 290,
    "list": [
      {
        "binanceChainId": "56",
        "defiProtocolId": "pancakeswap3",
        "protocolName": "PancakeSwap V3",
        "investmentId": "fc546857d03bf5f7ca15d01c564c8430599f6fd8ec3c2dda0119b8a7e7e793e8",
        "investmentName": "USDT-MarsCoin",
        "investType": "LiquidityPool",
        "apyType": "APR",
        "apyBps": 156265,
        "apyDisplay": "1,562.65%",
        "tvl": "352489.87"
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Investment Detail

Get detailed information for a specific DeFi investment product, including APY, TVL, supported tokens (asset / reward / LP / borrow), pool address, fee rate, and investability.

POST

/api/v1/defi/data/investment/detail

https://web3.binance.com/build

Get Investment Detail › 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.

Get Investment Detail › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

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-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

Get Investment Detail › Request Body

investmentId

string · required

Investment product identifier (64-char hex, no 0x prefix). Same format as the investmentIds returned by POST /api/v1/defi/data/position/list.

Example: fc546857d03bf5f7ca15d01c564c8430599f6fd8ec3c2dda0119b8a7e7e793e8

Get Investment Detail › Responses

Investment detail returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Human-readable status message.

Example: success

object

DeFi investment product detail.

timestamp

integer · int64

Server timestamp in milliseconds.

Example: 1748601600000

success

boolean

Whether the request succeeded (mirrors code == 0).

Example: true

POST/api/v1/defi/data/investment/detail

curl --request POST \
  --url https://web3.binance.com/build/api/v1/defi/data/investment/detail \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "investmentId": "fc546857d03bf5f7ca15d01c564c8430599f6fd8ec3c2dda0119b8a7e7e793e8"
}
'

Example Request Body

{
  "investmentId": "fc546857d03bf5f7ca15d01c564c8430599f6fd8ec3c2dda0119b8a7e7e793e8"
}

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "binanceChainId": "56",
    "defiProtocolId": "pancakeswap3",
    "protocolName": "PancakeSwap V3",
    "protocolLogo": "https://bin.bnbstatic.com/image/admin_mgs_image_upload/20250228/pancakeswap-logo.png",
    "investmentId": "fc546857d03bf5f7ca15d01c564c8430599f6fd8ec3c2dda0119b8a7e7e793e8",
    "investmentName": "USDT-MarsCoin",
    "investType": "LiquidityPool",
    "investable": true,
    "apyBps": 156265,
    "apyDisplay": "1,562.65%",
    "apyType": "APR",
    "tvl": "500000.5",
    "poolAddress": "0x87870Bca3F3fF67225794148012b73643B78Ed36",
    "feeRate": "0.001",
    "assetTokenList": [
      {
        "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
        "tokenName": "Tether USD",
        "tokenSymbol": "USDT"
      }
    ],
    "rewardTokenList": [
      {
        "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
        "tokenName": "Tether USD",
        "tokenSymbol": "USDT"
      }
    ],
    "lpTokenList": [
      {
        "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
        "tokenName": "Tether USD",
        "tokenSymbol": "USDT"
      }
    ],
    "borrowTokenList": [
      {
        "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
        "tokenName": "Tether USD",
        "tokenSymbol": "USDT"
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

DeFi Data

Endpointhttps://web3.binance.com/build

Download schema

Get DeFi Positions

POST

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

https://web3.binance.com/build

Get DeFi Positions › 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.

Get DeFi Positions › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

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-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

Get DeFi Positions › Request Body

addresses

string[] · maxItems: 3 · required

Wallet addresses to query positions for. Up to 3 addresses per request (server-side configured and subject to change).

Example: ["0x66faa5ded68cc83a71bc172fb03c17a6bcb32f7a"]

binanceChainIds

string[]

Optional chain filter. When set, only positions on the specified chains are returned. This release supports BSC ("56") only.

Example: ["56"]

Get DeFi Positions › Responses

DeFi positions returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Human-readable status message.

Example: success

object

Aggregated DeFi positions response.

timestamp

integer · int64

Server timestamp in milliseconds.

Example: 1748601600000

success

boolean

Whether the request succeeded (mirrors code == 0).

Example: true

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

curl --request POST \
  --url https://web3.binance.com/build/api/v1/defi/data/position/list \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "addresses": [
    "0x66faa5ded68cc83a71bc172fb03c17a6bcb32f7a"
  ]
}
'

Example Request Body

{
  "addresses": [
    "0x66faa5ded68cc83a71bc172fb03c17a6bcb32f7a"
  ]
}

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "totalValue": "5000.50123456",
    "addressList": [
      {
        "address": "0x66faa5ded68cc83a71bc172fb03c17a6bcb32f7a",
        "addressTotalValue": "26.70787419",
        "protocolList": [
          {
            "binanceChainId": "56",
            "defiProtocolId": "helio",
            "protocolName": "Lista DAO",
            "protocolTotalValue": "26.70787419",
            "poolList": [
              {
                "bnPoolId": "0xd4e9b3f0fbb5129bf893f01df339935185b5ad22492fac093f391753389a8656",
                "poolCa": "0x3662d86220BE5BEA975BE9Fd8aB3d6b5D4FB4163",
                "poolType": "Liquidity Pool",
                "positionCollectionList": [
                  {
                    "positionCollectionId": "85dab74a61426fa11f02a234d5e4462c7cc62249875c212f2dbfa09a927b8097",
                    "positionCollectionDetail": {
                      "collectionIndex": "0x00000000000000000000000055d398326f99059ff775485246999027b3197955",
                      "collectionDisplayName": null,
                      "healthFactor": "1.85"
                    },
                    "positionCollectionTotalValue": "10.51121227",
                    "positionList": [
                      {
                        "positionId": "dbc71cba52420db0021821a240a3901df566fbcda97b663402ec7d52308f0e29",
                        "underlyingAssetName": "USDT-USDC",
                        "underlyingAssetId": "e73d51bced063d9e7bd5d799e51752ffb7bc6fbfa579ce41164d0dbd9cc13a4b",
                        "assetType": "locked",
                        "investmentIds": [
                          "b3e50a2dd4aab008d3410dae2a383fe5216346fb613bb1bef9b1822fe47c742a"
                        ],
                        "positionDetail": {
                          "positionIndex": "6993078",
                          "nftId": "#6993078",
                          "unlockTime": "1787744768",
                          "unlockTimeReached": false,
                          "tickLower": "-60",
                          "tickUpper": "40",
                          "active": true,
                          "proofs": {
                            "0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82": [
                              "0xb0477ce01ce3dcfc137ab44d91af37f5ed3f468421d2d2e44941dd5a8bf44aa4"
                            ]
                          },
                          "stakeState": "active",
                          "claimTypes": [
                            "LP_FEE",
                            "REWARD_INVESTMENT"
                          ],
                          "redemptionId": "redem-abc123"
                        },
                        "positionValue": "10.51121227",
                        "tokenList": {
                          "supply": [
                            {
                              "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
                              "tokenSymbol": "USDT",
                              "tokenAmount": "1000.5",
                              "tokenValue": "1000.6"
                            }
                          ],
                          "reward": [
                            {
                              "tokenAddress": "0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82",
                              "tokenSymbol": "Cake",
                              "tokenAmount": "12.3",
                              "tokenValue": "45.6"
                            }
                          ]
                        }
                      }
                    ]
                  }
                ],
                "poolDetail": {
                  "expiry": 1748601600,
                  "feeTier": "500",
                  "lpFee": "330",
                  "tickSpacing": "50",
                  "isDynamicFee": true,
                  "hookFee": "2800",
                  "tick": "59683",
                  "hooks": "0xdfdfb2c5a717ab00b370e883021f20c2fbaed277",
                  "swapProtocolFee": "300",
                  "parameters": "0x0000000000000000000000000000000000000000000000000000000000320040",
                  "fee": "2500",
                  "spokeName": null,
                  "reserveCount": null,
                  "vaultName": null
                }
              }
            ]
          }
        ]
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

List DeFi Protocols

List supported DeFi protocols with optional filtering by chain and investment type. Results are paginated and sortable.

POST

/api/v1/defi/data/protocol/list

https://web3.binance.com/build

List DeFi Protocols › 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.

List DeFi Protocols › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

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-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

List DeFi Protocols › Request Body

binanceChainId

string

Filter by Binance chain ID (e.g. "56"=BSC).

Example: 56

investType

string · enum

Filter by investment type. Known values: Earn, LiquidityPool.

Enum values:

Earn

LiquidityPool

Example: Earn

sortField

string

Example: tvl

sortDirection

string · enum

Sort direction.

Enum values:

ASC

DESC

Example: DESC

page

integer · min: 1

Page number (1-based).

Example: 1

Default: 1

size

integer · min: 1 · max: 200

Page size. Max: 200.

Example: 20

Default: 200

List DeFi Protocols › Responses

Protocol list returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Human-readable status message.

Example: success

object

Paginated protocol list result.

timestamp

integer · int64

Server timestamp in milliseconds.

Example: 1748601600000

success

boolean

Whether the request succeeded (mirrors code == 0).

Example: true

POST/api/v1/defi/data/protocol/list

curl --request POST \
  --url https://web3.binance.com/build/api/v1/defi/data/protocol/list \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '{}'

Example Request Body

{}

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "page": 1,
    "size": 20,
    "total": 10,
    "list": [
      {
        "defiProtocolId": "pancakeswap3",
        "protocolName": "PancakeSwap V3",
        "protocolLogo": "https://bin.bnbstatic.com/image/admin_mgs_image_upload/20250228/pancakeswap-logo.png",
        "tvl": "1250000.5",
        "apyBps": 1235,
        "apyDisplay": "12.35%",
        "investType": [
          "Earn",
          "LiquidityPool"
        ],
        "supportedChains": [
          "56"
        ]
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Protocol Detail

Get detailed information for a specific DeFi protocol, including description, highlights, CertiK security scores, team, fundraising, social links, and FAQ.

POST

/api/v1/defi/data/protocol/detail

https://web3.binance.com/build

Get Protocol Detail › 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.

Get Protocol Detail › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

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-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

Get Protocol Detail › Request Body

defiProtocolId

string · required

DeFi protocol identifier.

Example: pancakeswap3

Get Protocol Detail › Responses

Protocol detail returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Human-readable status message.

Example: success

object

DeFi protocol detail.

timestamp

integer · int64

Server timestamp in milliseconds.

Example: 1748601600000

success

boolean

Whether the request succeeded (mirrors code == 0).

Example: true

POST/api/v1/defi/data/protocol/detail

curl --request POST \
  --url https://web3.binance.com/build/api/v1/defi/data/protocol/detail \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "defiProtocolId": "pancakeswap3"
}
'

Example Request Body

{
  "defiProtocolId": "pancakeswap3"
}

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "defiProtocolId": "pancakeswap3",
    "protocolName": "PancakeSwap",
    "protocolLogo": "https://bin.bnbstatic.com/image/admin_mgs_image_upload/20250527/06ab0ee1-8382-4416-9395-15446112b09b.png",
    "description": "PancakeSwap is a decentralized exchange (DEX) built on BNB Chain that utilizes an automated market making (AMM) system.",
    "websiteUrl": "https://pancakeswap.finance/",
    "investType": [
      "LiquidityPool"
    ],
    "supportedChains": [
      "56"
    ],
    "tvl": "290233074",
    "tags": [
      "DeFi",
      "DEX"
    ],
    "founded": "2020",
    "fdv": "510239911.86046",
    "totalFunding": null,
    "socialLinks": {
      "x": "https://x.com/pancakeswap",
      "discord": null,
      "github": "https://github.com/pancakeswap",
      "linkedin": "https://www.linkedin.com/company/pancakeswap/",
      "telegram": null,
      "gitbook": "",
      "website": "https://pancakeswap.finance/"
    },
    "team": [
      {
        "name": "Henry Cavill",
        "role": "CEO",
        "twitter": "https://x.com/0xchefjackson",
        "linkedin": "https://www.linkedin.com/in/henry-cavill-6b6ab6229/",
        "bio": null
      }
    ],
    "fundRaising": [
      {
        "round": "Strategic",
        "amount": null,
        "date": "2022-06-06",
        "investors": [
          "YZi Labs"
        ]
      }
    ],
    "securityScore": "92.33",
    "dimensionScores": {
      "codeSecurity": "95.47",
      "fundamentalHealth": "76.7",
      "operationalResilience": "94.96",
      "communityTrust": "98",
      "governanceStrength": "98",
      "marketStability": "96"
    },
    "highlights": [
      "Project has security audits",
      "Code repo health is in excellent condition"
    ],
    "faq": [
      {
        "title": "How are rewards accrued from providing liquidity on Pancakeswap V3?",
        "answer": "• Rewards come from trading fees collected on swaps within your liquidity price range.<Br/>• Fees accumulate and increase your liquidity position value.<Br/>• Fees are accrued only when the market is trading within the range set by you."
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

List DeFi Investments

List available DeFi investment products. Filter by protocol, chain, investment type, or contract address. Results are paginated and sortable.

POST

/api/v1/defi/data/investment/list

https://web3.binance.com/build

List DeFi Investments › 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.

List DeFi Investments › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

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-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

List DeFi Investments › Request Body

investType

string · enum · required

Filter by investment type. Required. Known values: Earn, LiquidityPool.

Enum values:

Earn

LiquidityPool

Example: Earn

defiProtocolId

string

Filter by DeFi protocol ID.

Example: pancakeswap3

tokenAddressList

string[]

Filter by token addresses.

Example: ["0x55d398326f99059fF775485246999027B3197955"]

binanceChainId

string

Filter by Binance chain ID (e.g. "56"=BSC).

Example: 56

sortField

string

Example: tvl

sortDirection

string · enum

Sort direction.

Enum values:

ASC

DESC

Example: DESC

page

integer · min: 1

Page number (1-based).

Example: 1

Default: 1

size

integer · min: 1 · max: 100

Page size. Max: 100.

Example: 20

Default: 20

List DeFi Investments › Responses

Investment list returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Human-readable status message.

Example: success

object

Paginated investment list result.

timestamp

integer · int64

Server timestamp in milliseconds.

Example: 1748601600000

success

boolean

Whether the request succeeded (mirrors code == 0).

Example: true

POST/api/v1/defi/data/investment/list

curl --request POST \
  --url https://web3.binance.com/build/api/v1/defi/data/investment/list \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "investType": "Earn"
}
'

Example Request Body

{
  "investType": "Earn"
}

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "page": 1,
    "size": 20,
    "total": 290,
    "list": [
      {
        "binanceChainId": "56",
        "defiProtocolId": "pancakeswap3",
        "protocolName": "PancakeSwap V3",
        "investmentId": "fc546857d03bf5f7ca15d01c564c8430599f6fd8ec3c2dda0119b8a7e7e793e8",
        "investmentName": "USDT-MarsCoin",
        "investType": "LiquidityPool",
        "apyType": "APR",
        "apyBps": 156265,
        "apyDisplay": "1,562.65%",
        "tvl": "352489.87"
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Investment Detail

Get detailed information for a specific DeFi investment product, including APY, TVL, supported tokens (asset / reward / LP / borrow), pool address, fee rate, and investability.

POST

/api/v1/defi/data/investment/detail

https://web3.binance.com/build

Get Investment Detail › 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.

Get Investment Detail › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

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-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

Get Investment Detail › Request Body

investmentId

string · required

Investment product identifier (64-char hex, no 0x prefix). Same format as the investmentIds returned by POST /api/v1/defi/data/position/list.

Example: fc546857d03bf5f7ca15d01c564c8430599f6fd8ec3c2dda0119b8a7e7e793e8

Get Investment Detail › Responses

Investment detail returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Human-readable status message.

Example: success

object

DeFi investment product detail.

timestamp

integer · int64

Server timestamp in milliseconds.

Example: 1748601600000

success

boolean

Whether the request succeeded (mirrors code == 0).

Example: true

POST/api/v1/defi/data/investment/detail

curl --request POST \
  --url https://web3.binance.com/build/api/v1/defi/data/investment/detail \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "investmentId": "fc546857d03bf5f7ca15d01c564c8430599f6fd8ec3c2dda0119b8a7e7e793e8"
}
'

Example Request Body

{
  "investmentId": "fc546857d03bf5f7ca15d01c564c8430599f6fd8ec3c2dda0119b8a7e7e793e8"
}

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "binanceChainId": "56",
    "defiProtocolId": "pancakeswap3",
    "protocolName": "PancakeSwap V3",
    "protocolLogo": "https://bin.bnbstatic.com/image/admin_mgs_image_upload/20250228/pancakeswap-logo.png",
    "investmentId": "fc546857d03bf5f7ca15d01c564c8430599f6fd8ec3c2dda0119b8a7e7e793e8",
    "investmentName": "USDT-MarsCoin",
    "investType": "LiquidityPool",
    "investable": true,
    "apyBps": 156265,
    "apyDisplay": "1,562.65%",
    "apyType": "APR",
    "tvl": "500000.5",
    "poolAddress": "0x87870Bca3F3fF67225794148012b73643B78Ed36",
    "feeRate": "0.001",
    "assetTokenList": [
      {
        "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
        "tokenName": "Tether USD",
        "tokenSymbol": "USDT"
      }
    ],
    "rewardTokenList": [
      {
        "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
        "tokenName": "Tether USD",
        "tokenSymbol": "USDT"
      }
    ],
    "lpTokenList": [
      {
        "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
        "tokenName": "Tether USD",
        "tokenSymbol": "USDT"
      }
    ],
    "borrowTokenList": [
      {
        "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
        "tokenName": "Tether USD",
        "tokenSymbol": "USDT"
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json