DeFi Transaction

Endpointhttps://web3.binance.com/build

Build DeFi Deposit Transaction

Build the unsigned transaction calldata for a DeFi deposit / stake. Returns an ordered dataList (typically [APPROVE, DEPOSIT], or [DEPOSIT] when the allowance is already sufficient) for the caller to sign and broadcast. The caller does NOT pass binanceChainId — the service resolves it from investmentId. Set simulate=true to also receive a preview (projected balance change, estimated gas, and lending health-factor change) without broadcasting.

POST

/api/v1/defi/transaction/deposit

https://web3.binance.com/build

Build DeFi Deposit Transaction › 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.

Build DeFi Deposit Transaction › 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

Build DeFi Deposit Transaction › Request Body

address

string · required

User wallet address (the signer / sender).

Example: 0x1234567890123456789012345678901234567890

investmentId

string · required

Investment product ID (chain-agnostic). The service resolves the chain from this ID.

Example: 10ab3e25d9f0b72f1f912b5d611f825bec495a74f2e1b25d8bba5fd2e56fb283

object · required

A (tokenAddress, amount) pair. amount is a human-readable decimal string (NOT the token's smallest unit); the service converts it according to the token's decimals. For the native asset use the sentinel 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee (40 es).

simulate

boolean

When true, the response also includes a preview object. Default false. If the simulated transaction reverts, the request returns 40485 for a specific classified revert reason or 40484 for any other revert (see Error Codes).

Example: true

Build DeFi Deposit Transaction › Responses

Deposit transaction calldata returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Human-readable status message.

Example: success

object

Unified response of the five build endpoints (deposit / redeem / lp-add / lp-remove / claim). dataList is ordered: APPROVE items come first, the main action follows — sign and broadcast each item in order. preview is non-null only when the request set simulate=true. redeemDelayDays is populated only by /transaction/redeem.

timestamp

integer · int64

Server timestamp in milliseconds.

Example: 1748601600000

success

boolean

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

Example: true

POST/api/v1/defi/transaction/deposit

curl --request POST \
  --url https://web3.binance.com/build/api/v1/defi/transaction/deposit \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "address": "0x1234567890123456789012345678901234567890",
  "investmentId": "10ab3e25d9f0b72f1f912b5d611f825bec495a74f2e1b25d8bba5fd2e56fb283",
  "token": {
    "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
    "amount": "100"
  }
}
'

Example Request Body

{
  "address": "0x1234567890123456789012345678901234567890",
  "investmentId": "10ab3e25d9f0b72f1f912b5d611f825bec495a74f2e1b25d8bba5fd2e56fb283",
  "token": {
    "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
    "amount": "100"
  }
}

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "dataList": [
      {
        "callDataType": "APPROVE",
        "from": "0x1234567890123456789012345678901234567890",
        "to": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "value": "0x0",
        "data": "0x095ea7b300000000000000000000000087870bca3f3ff67225794148012b73643b78ed3600000000000000000000000000000000000000000000000000000000000fffff",
        "gasLimit": "50000",
        "gasPrice": null,
        "maxPriorityFeePerGas": "1000000000",
        "maxFeePerGas": "3000000000"
      },
      {
        "callDataType": "DEPOSIT",
        "from": "0x1234567890123456789012345678901234567890",
        "to": "0x87870Bca3F3fF67225794148012b73643B78Ed36",
        "value": "0x0",
        "data": "0xa9059cbb000000000000000000000000dead00000000000000000000000000000000dead00000000000000000000000000000000000000000000000000000000000000000a",
        "gasLimit": "200000",
        "gasPrice": null,
        "maxPriorityFeePerGas": "1000000000",
        "maxFeePerGas": "3000000000"
      }
    ],
    "preview": {
      "success": true,
      "balanceChange": [
        {
          "tokenType": "TOKEN",
          "tokenSymbol": "USDT",
          "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
          "tokenDecimals": "18",
          "amount": "-1000",
          "valueUsd": "1000.00"
        },
        {
          "tokenType": "TOKEN",
          "tokenSymbol": "aBUSD",
          "tokenAddress": "0x6d8981847eb3cc2234179d0f0e72f6be6e0950a4",
          "tokenDecimals": "18",
          "amount": "999.99",
          "valueUsd": "999.99"
        }
      ],
      "feeAndContract": {
        "estimatedNetworkFee": {
          "amount": "0.000003056787",
          "tokenSymbol": "BNB",
          "valueUsd": "0.002002",
          "rentFeeAmount": null,
          "rentFeeValueUsd": null,
          "priorityFeeAmount": null
        },
        "interactWith": {
          "address": "0x87870Bca3F3fF67225794148012b73643B78Ed36"
        }
      },
      "healthFactor": {
        "before": "1.85",
        "after": "1.35"
      },
      "warnings": [
        {
          "code": "HEALTH_FACTOR_WARNING",
          "level": "WARN",
          "message": "Health factor will drop from 1.85 to 1.35 after this transaction."
        }
      ]
    }
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Build DeFi Redeem Transaction

Build the unsigned transaction calldata for a DeFi redeem / withdraw. Returns an ordered dataList (typically [REDEEM] or [APPROVE, REDEEM]). Redeem amount is decided by exactly one of ratio or token (mutually exclusive): - ratio omitted / blank → exact-amount redeem: the amount comes from token (tokenAddress + amount); the position is not queried. token is required in this mode (omitting token, or leaving amount blank, is rejected with 40001, Parameter error; both ratio and token absent is also rejected with 40001).

ratio present → proportional redeem: must parse as a decimal in (0, 1]. The service queries the user's on-chain position under investmentId and scales each token's amount by ratio (floored to the token's decimals). ratio="1" is a full (max) redeem. In this mode token is ignored — the output tokens and amounts are derived from the position.

slippageBps is the slippage tolerance in basis points (e.g. 300 = 3%). The caller does NOT pass binanceChainId — resolved from investmentId. Set simulate=true to also receive preview. The response also carries redeemDelayDays — the redeem waiting period as a [min, max] day pair (e.g. ["7","10"] = 7–10 days, [] = instant). The wait starts after the redeem tx is confirmed on-chain. See the redeemDelayDays field on DefiTxResponse.

POST

/api/v1/defi/transaction/redeem

https://web3.binance.com/build

Build DeFi Redeem Transaction › 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.

Build DeFi Redeem Transaction › 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

Build DeFi Redeem Transaction › Request Body

address

string · required

User wallet address (the signer / sender).

Example: 0x1234567890123456789012345678901234567890

investmentId

string · required

Investment product ID (chain-agnostic). The service resolves the chain from this ID.

Example: 10ab3e25d9f0b72f1f912b5d611f825bec495a74f2e1b25d8bba5fd2e56fb283

object

ratio

string

Redeem ratio, mutually exclusive with token. Omitted / blank → exact-amount redeem via token (tokenAddress + amount, position not queried). Present → must parse as a decimal in (0, 1]; the service queries the on-chain position under investmentId and scales each token amount by ratio (floored to decimals). "1" = full (max) redeem; in this mode token is ignored.

Example: 1

slippageBps

string

Slippage tolerance in basis points (e.g. 300 = 3%).

Example: 300

simulate

boolean

When true, the response also includes a preview object. Default false. If the simulated transaction reverts, the request returns an error code instead of a 200 with preview.success=false: 40485 when the redeem amount exceeds the current position, 40484 for any other revert (see Error Codes).

Example: true

Build DeFi Redeem Transaction › Responses

Redeem transaction calldata returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Human-readable status message.

Example: success

object

timestamp

integer · int64

Server timestamp in milliseconds.

Example: 1748601600000

success

boolean

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

Example: true

POST/api/v1/defi/transaction/redeem

curl --request POST \
  --url https://web3.binance.com/build/api/v1/defi/transaction/redeem \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "address": "0x1234567890123456789012345678901234567890",
  "investmentId": "10ab3e25d9f0b72f1f912b5d611f825bec495a74f2e1b25d8bba5fd2e56fb283"
}
'

Example Request Body

{
  "address": "0x1234567890123456789012345678901234567890",
  "investmentId": "10ab3e25d9f0b72f1f912b5d611f825bec495a74f2e1b25d8bba5fd2e56fb283"
}

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "dataList": [
      {
        "callDataType": "REDEEM",
        "from": "0x1234567890123456789012345678901234567890",
        "to": "0x87870Bca3F3fF67225794148012b73643B78Ed36",
        "value": "0x0",
        "data": "0x1a3204a30000000000000000000000000000000000000000000000000000000000000001",
        "gasLimit": "180000",
        "gasPrice": null,
        "maxPriorityFeePerGas": "1000000000",
        "maxFeePerGas": "3000000000"
      }
    ],
    "redeemDelayDays": [
      "7",
      "10"
    ],
    "preview": {
      "success": true,
      "balanceChange": [
        {
          "tokenType": "TOKEN",
          "tokenSymbol": "aBUSD",
          "tokenAddress": "0x6d8981847eb3cc2234179d0f0e72f6be6e0950a4",
          "tokenDecimals": "18",
          "amount": "999.99",
          "valueUsd": "999.99"
        }
      ],
      "feeAndContract": {
        "estimatedNetworkFee": {
          "amount": "0.000003056787",
          "tokenSymbol": "BNB",
          "valueUsd": "0.002002",
          "rentFeeAmount": null,
          "rentFeeValueUsd": null,
          "priorityFeeAmount": null
        },
        "interactWith": {
          "address": "0x87870Bca3F3fF67225794148012b73643B78Ed36"
        }
      },
      "healthFactor": {
        "before": "1.85",
        "after": "1.35"
      },
      "warnings": [
        {
          "code": "HEALTH_FACTOR_WARNING",
          "level": "WARN",
          "message": "Health factor will drop from 1.85 to 1.35 after this transaction."
        }
      ]
    }
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Build LP Add Transaction

Build the unsigned transaction calldata for adding liquidity. tokenList supports multiple tokens. Returns an ordered dataList (typically [APPROVE, LP_ADD]). Tick range source (provide exactly one group):

nftId — append to an existing LP position (reuses its range).
priceRange — percentage band (e.g. "5" = ±5%) for a new position.
tickLower + tickUpper — explicit raw int24 pair for a new position. Rules:

If more than one group is supplied, only the highest-priority one above is used and the others are silently ignored (priority: nftId > priceRange > explicit tick pair).
If none is supplied, the request is rejected (40453).
tickLower / tickUpper are raw int24 values and MUST be aligned to the pool's tickSpacing, otherwise the request is rejected (40453).
The caller does NOT pass binanceChainId — resolved from investmentId.

POST

/api/v1/defi/transaction/lp-add

https://web3.binance.com/build

Build LP Add Transaction › 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.

Build LP Add Transaction › 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

Build LP Add Transaction › Request Body

address

string · required

User wallet address (the signer / sender).

Example: 0x1234567890123456789012345678901234567890

investmentId

string · required

LP investment product ID (chain-agnostic).

Example: 6a3522eee3f2fc4fa9cc1273603429ba95ebd9ff4d33fad8a14d39b9a0a6ce3a

object[] · required

Tokens to supply. Two tokens for a standard LP add.

Example: [{"tokenAddress":"0x55d398326f99059fF775485246999027B3197955","amount":"10"},{"tokenAddress":"0xf1686b0b45114bcec963b139344a54cefae09a58","amount":"20"}]

tickLower

string

Lower tick bound (raw int24) for a new position. MUST be aligned to the pool's tickSpacing. Pick exactly one tick-range source: tickLower+tickUpper, priceRange, or nftId (to append to an existing position). If several are supplied, the lowest-priority ones are ignored (priority: nftId > priceRange > explicit tick pair).

Example: -100

tickUpper

string

Upper tick bound (raw int24) for a new position. MUST be aligned to the pool's tickSpacing. See tickLower for the pick-exactly-one rule.

Example: 100

priceRange

string

Price range as a percentage (e.g. "5" = ±5%) for a new position. Alternative to tickLower+tickUpper; see tickLower for the pick-exactly-one rule.

Example: 5

nftId

string

LP NFT token ID, decimal string (e.g. "7225901" or "#7225901"). Required when appending to an existing position (reuses its range); omit for a new position. Highest-priority tick-range source — see tickLower for the pick-exactly-one rule. The # prefix returned by the position list may be passed as-is — the service strips it automatically.

Example: 123456

slippageBps

string

Slippage tolerance for the LP leg, in basis points (e.g. 300 = 3%).

Example: 300

simulate

boolean

Example: true

Build LP Add Transaction › Responses

LP add transaction calldata returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Human-readable status message.

Example: success

object

timestamp

integer · int64

Server timestamp in milliseconds.

Example: 1748601600000

success

boolean

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

Example: true

POST/api/v1/defi/transaction/lp-add

curl --request POST \
  --url https://web3.binance.com/build/api/v1/defi/transaction/lp-add \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "address": "0x1234567890123456789012345678901234567890",
  "investmentId": "6a3522eee3f2fc4fa9cc1273603429ba95ebd9ff4d33fad8a14d39b9a0a6ce3a",
  "tokenList": [
    {
      "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
      "amount": "10"
    },
    {
      "tokenAddress": "0xf1686b0b45114bcec963b139344a54cefae09a58",
      "amount": "20"
    }
  ]
}
'

Example Request Body

{
  "address": "0x1234567890123456789012345678901234567890",
  "investmentId": "6a3522eee3f2fc4fa9cc1273603429ba95ebd9ff4d33fad8a14d39b9a0a6ce3a",
  "tokenList": [
    {
      "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
      "amount": "10"
    },
    {
      "tokenAddress": "0xf1686b0b45114bcec963b139344a54cefae09a58",
      "amount": "20"
    }
  ]
}

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "dataList": [
      {
        "callDataType": "APPROVE",
        "from": "0x1234567890123456789012345678901234567890",
        "to": "0x55d398326f99059fF775485246999027B3197955",
        "value": "0x0",
        "data": "0x095ea7b30000000000000000000000003662d86220be5bea975be9fd8ab3d6b5d4fb4163000000000000000000000000000000000000000000000000000000000000ffff",
        "gasLimit": "50000",
        "gasPrice": null,
        "maxPriorityFeePerGas": "1000000000",
        "maxFeePerGas": "3000000000"
      },
      {
        "callDataType": "LP_ADD",
        "from": "0x1234567890123456789012345678901234567890",
        "to": "0x3662d86220BE5BEA975BE9Fd8aB3d6b5D4FB4163",
        "value": "0x0",
        "data": "0x88cc36350000000000000000000000000000000000000000000000000000000000000064",
        "gasLimit": "250000",
        "gasPrice": null,
        "maxPriorityFeePerGas": "1000000000",
        "maxFeePerGas": "3000000000"
      }
    ],
    "preview": {
      "success": true,
      "balanceChange": [
        {
          "tokenType": "TOKEN",
          "tokenSymbol": "USDT",
          "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
          "tokenDecimals": "18",
          "amount": "-1.5",
          "valueUsd": "450.00"
        },
        {
          "tokenType": "TOKEN",
          "tokenSymbol": "BUSD",
          "tokenAddress": "0x4eCbB006EdcB9B984c0D4b5c6Fd1d5C1f12f9dE9",
          "tokenDecimals": "18",
          "amount": "-451.5",
          "valueUsd": "451.50"
        },
        {
          "tokenType": "NFT",
          "tokenSymbol": null,
          "tokenAddress": "0x3662d86220BE5BEA975BE9Fd8aB3d6b5D4FB4163",
          "tokenDecimals": null,
          "amount": "1",
          "valueUsd": null,
          "tokenId": "123456"
        }
      ],
      "feeAndContract": {
        "estimatedNetworkFee": {
          "amount": "0.000004120834",
          "tokenSymbol": "BNB",
          "valueUsd": "0.002701",
          "rentFeeAmount": null,
          "rentFeeValueUsd": null,
          "priorityFeeAmount": null
        },
        "interactWith": {
          "address": "0x3662d86220BE5BEA975BE9Fd8aB3d6b5D4FB4163"
        }
      },
      "healthFactor": null,
      "warnings": []
    }
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Calculate LP Add Paired Amounts

Given a single input token, calculate the paired token amount needed for an LP add. This is a pure computation endpoint — it does not touch the chain and does not deduct any fee. Use it before /transaction/lp-add to size the paired token when only one side is supplied. Tick range source rules are the same as /lp-add — provide exactly one group: nftId (existing position), priceRange, or tickLower+tickUpper.

If more than one group is supplied, only the highest-priority one is used and the others are silently ignored (priority: nftId > priceRange > explicit tick pair).
If none is supplied, the request is rejected.
The caller does NOT pass binanceChainId — resolved from investmentId.

POST

/api/v1/defi/transaction/lp-add/calculate

https://web3.binance.com/build

Calculate LP Add Paired Amounts › 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.

Calculate LP Add Paired Amounts › 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

Calculate LP Add Paired Amounts › Request Body

address

string · required

User wallet address.

Example: 0x1234567890123456789012345678901234567890

investmentId

string · required

LP investment product ID (chain-agnostic).

Example: 6a3522eee3f2fc4fa9cc1273603429ba95ebd9ff4d33fad8a14d39b9a0a6ce3a

object · required

tickLower

string

Lower tick bound (raw int24), aligned to the pool's tickSpacing.

Example: -100

tickUpper

string

Upper tick bound (raw int24), aligned to the pool's tickSpacing.

Example: 100

priceRange

string

Price range as a percentage (e.g. "5" = ±5%).

Example: 5

nftId

string

Required when calculating for an existing LP position.

Example: 123456

Calculate LP Add Paired Amounts › Responses

Paired token amounts returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Human-readable status message.

Example: success

object

Result of /transaction/lp-add/calculate. Returns the paired token amounts derived from the single input token. This endpoint is pure computation — it does not touch the chain and does not deduct any fee.

timestamp

integer · int64

Server timestamp in milliseconds.

Example: 1748601600000

success

boolean

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

Example: true

POST/api/v1/defi/transaction/lp-add/calculate

curl --request POST \
  --url https://web3.binance.com/build/api/v1/defi/transaction/lp-add/calculate \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "address": "0x1234567890123456789012345678901234567890",
  "investmentId": "6a3522eee3f2fc4fa9cc1273603429ba95ebd9ff4d33fad8a14d39b9a0a6ce3a",
  "inputToken": {
    "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
    "amount": "100"
  }
}
'

Example Request Body

{
  "address": "0x1234567890123456789012345678901234567890",
  "investmentId": "6a3522eee3f2fc4fa9cc1273603429ba95ebd9ff4d33fad8a14d39b9a0a6ce3a",
  "inputToken": {
    "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
    "amount": "100"
  }
}

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "inputTokenAmount": "10",
    "pairedTokenAddress": "0xf1686b0b45114bcec963b139344a54cefae09a58",
    "pairedTokenAmount": "20"
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Build LP Remove Transaction

Build the unsigned transaction calldata for removing liquidity. Removal is by nftId + ratio (range (0, 1]) — no tokenList is needed; the per-token amounts are derived from the on-chain position. Returns an ordered dataList (typically [LP_REMOVE]). slippageBps is the LP-leg slippage tolerance in basis points. The caller does NOT pass binanceChainId — resolved from investmentId.

POST

/api/v1/defi/transaction/lp-remove

https://web3.binance.com/build

Build LP Remove Transaction › 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.

Build LP Remove Transaction › 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

Build LP Remove Transaction › Request Body

address

string · required

User wallet address (the signer / sender).

Example: 0x1234567890123456789012345678901234567890

investmentId

string · required

LP investment product ID (chain-agnostic).

Example: 6a3522eee3f2fc4fa9cc1273603429ba95ebd9ff4d33fad8a14d39b9a0a6ce3a

nftId

string · required

LP NFT token ID identifying the position to remove, decimal string (e.g. "7225901" or "#7225901"). The # prefix returned by the position list may be passed as-is — the service strips it automatically.

Example: 123456

ratio

string · required

Removal ratio in the range (0, 1] as a decimal string (e.g. "0.04", "1").

Example: 1

slippageBps

string

Slippage tolerance for the LP leg, in basis points (e.g. 300 = 3%).

Example: 300

simulate

boolean

Example: true

Build LP Remove Transaction › Responses

LP remove transaction calldata returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Human-readable status message.

Example: success

object

timestamp

integer · int64

Server timestamp in milliseconds.

Example: 1748601600000

success

boolean

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

Example: true

POST/api/v1/defi/transaction/lp-remove

curl --request POST \
  --url https://web3.binance.com/build/api/v1/defi/transaction/lp-remove \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "address": "0x1234567890123456789012345678901234567890",
  "investmentId": "6a3522eee3f2fc4fa9cc1273603429ba95ebd9ff4d33fad8a14d39b9a0a6ce3a",
  "nftId": "123456",
  "ratio": "1"
}
'

Example Request Body

{
  "address": "0x1234567890123456789012345678901234567890",
  "investmentId": "6a3522eee3f2fc4fa9cc1273603429ba95ebd9ff4d33fad8a14d39b9a0a6ce3a",
  "nftId": "123456",
  "ratio": "1"
}

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "dataList": [
      {
        "callDataType": "LP_REMOVE",
        "from": "0x1234567890123456789012345678901234567890",
        "to": "0x3662d86220BE5BEA975BE9Fd8aB3d6b5D4FB4163",
        "value": "0x0",
        "data": "0x96145dd60000000000000000000000000000000000000000000000000000000000000001",
        "gasLimit": "200000",
        "gasPrice": null,
        "maxPriorityFeePerGas": "1000000000",
        "maxFeePerGas": "3000000000"
      }
    ],
    "preview": {
      "success": true,
      "balanceChange": [
        {
          "tokenType": "TOKEN",
          "tokenSymbol": "USDT",
          "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
          "tokenDecimals": "18",
          "amount": "1.5",
          "valueUsd": "450.00"
        },
        {
          "tokenType": "TOKEN",
          "tokenSymbol": "BUSD",
          "tokenAddress": "0x4eCbB006EdcB9B984c0D4b5c6Fd1d5C1f12f9dE9",
          "tokenDecimals": "18",
          "amount": "451.5",
          "valueUsd": "451.50"
        },
        {
          "tokenType": "NFT",
          "tokenSymbol": null,
          "tokenAddress": "0x3662d86220BE5BEA975BE9Fd8aB3d6b5D4FB4163",
          "tokenDecimals": null,
          "amount": "-1",
          "valueUsd": null,
          "tokenId": "123456"
        }
      ],
      "feeAndContract": {
        "estimatedNetworkFee": {
          "amount": "0.000002884733",
          "tokenSymbol": "BNB",
          "valueUsd": "0.001891",
          "rentFeeAmount": null,
          "rentFeeValueUsd": null,
          "priorityFeeAmount": null
        },
        "interactWith": {
          "address": "0x3662d86220BE5BEA975BE9Fd8aB3d6b5D4FB4163"
        }
      },
      "healthFactor": null,
      "warnings": []
    }
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Build DeFi Claim Transaction

Build the unsigned claim calldata for one of four claim types — see DefiClaimType for which companion fields each type requires and which protocol constraints apply (e.g. REWARD_PROTOCOL is not supported for LP protocols; PancakeSwap V3 farming uses LP_FEE, not REWARD_INVESTMENT). Returns an ordered dataList (typically [CLAIM]). binanceChainId resolution rules:

Normally resolved from investmentId; the call always executes on that chain.
For claim types other than REWARD_PROTOCOL, any client-supplied binanceChainId is silently ignored — passing a different chainId will not redirect the claim.
Exception: REWARD_PROTOCOL with no investmentId — the client MUST pass binanceChainId (it is the only chain signal).

tokenAddressList optionally narrows the claim scope. Set simulate=true to also receive preview.

POST

/api/v1/defi/transaction/claim

https://web3.binance.com/build

Build DeFi Claim Transaction › 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.

Build DeFi Claim Transaction › 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

Build DeFi Claim Transaction › Request Body

address

string · required

User wallet address (the signer / sender).

Example: 0x1234567890123456789012345678901234567890

claimType

string · enum · required

Claim routing type. Determines which companion fields are required:

REWARD_PROTOCOL: protocol-level rewards (e.g. Aave incentive, Radiant) — requires defiProtocolId + binanceChainId
REWARD_INVESTMENT: per-investment rewards — requires investmentId
LP_FEE: Uniswap V3/V4 LP fees — requires investmentId + nftId
REDEMPTION: redeem principal (Lista / Aster / Solv etc.) — requires investmentId + redemptionId

Protocol constraints — not every claimType is valid for every protocol; an invalid combination is rejected (40453 or 40454):

REWARD_PROTOCOL is not supported for LP (liquidity-pool) protocols in this release.
REWARD_INVESTMENT is not supported for PancakeSwap V3 farming positions; use LP_FEE to claim farming incentives there.
LP_FEE applies only to concentrated-liquidity (V3/V4) LP positions.
REDEMPTION applies only to protocols with a redemption / lock-up flow (Lista, Aster, Solv).

The valid claimTypes for a specific position are returned in that position's positionDetail.claimTypes (see the position list) — branch on that rather than hard-coding the mapping. Note: error messages may surface the protocol id with a chain prefix (e.g. bsc_pancakeswap4); the canonical id in API fields is the un-prefixed form (e.g. pancakeswap4).

Enum values:

REWARD_PROTOCOL

REWARD_INVESTMENT

LP_FEE

REDEMPTION

Example: LP_FEE

binanceChainId

string

Binance chain ID. For REWARD_PROTOCOL (which does not use investmentId) this is the only chain signal and is required. For all other claim types the chain is resolved from investmentId and any client-supplied value is silently ignored — the call still executes on the investmentId chain, so a different chainId does not redirect the claim.

Example: 56

investmentId

string

Required for REWARD_INVESTMENT, LP_FEE, and REDEMPTION. Not used for REWARD_PROTOCOL (which keys off defiProtocolId).

Example: 6a3522eee3f2fc4fa9cc1273603429ba95ebd9ff4d33fad8a14d39b9a0a6ce3a

defiProtocolId

string

Required for REWARD_PROTOCOL (e.g. pancakeswap3).

Example: pancakeswap3

nftId

string

Required for LP_FEE. The NFT token ID as a decimal string (e.g. "7225901" or "#7225901"). The # prefix returned by the position list may be passed as-is — the service strips it automatically.

Example: 123456

redemptionId

string

Required for REDEMPTION. Maps to the redemptionId returned in the position list (the on-line position index).

Example: test-redemption-1

tokenAddressList

string[]

Optional token address filter to narrow the claim scope.

Example: ["0x55d398326f99059fF775485246999027B3197955"]

simulate

boolean

Example: true

Build DeFi Claim Transaction › Responses

Claim transaction calldata returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Human-readable status message.

Example: success

object

timestamp

integer · int64

Server timestamp in milliseconds.

Example: 1748601600000

success

boolean

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

Example: true

POST/api/v1/defi/transaction/claim

curl --request POST \
  --url https://web3.binance.com/build/api/v1/defi/transaction/claim \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "address": "0x1234567890123456789012345678901234567890",
  "claimType": "LP_FEE"
}
'

Example Request Body

{
  "address": "0x1234567890123456789012345678901234567890",
  "claimType": "LP_FEE"
}

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "dataList": [
      {
        "callDataType": "CLAIM",
        "from": "0x1234567890123456789012345678901234567890",
        "to": "0x87870Bca3F3fF67225794148012b73643B78Ed36",
        "value": "0x0",
        "data": "0x4e71d9230000000000000000000000000000000000000000000000000000000000000002",
        "gasLimit": "150000",
        "gasPrice": null,
        "maxPriorityFeePerGas": "1000000000",
        "maxFeePerGas": "3000000000"
      }
    ],
    "preview": {
      "success": true,
      "balanceChange": [
        {
          "tokenType": "TOKEN",
          "tokenSymbol": "CAKE",
          "tokenAddress": "0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82",
          "tokenDecimals": "18",
          "amount": "12.5",
          "valueUsd": "37.50"
        }
      ],
      "feeAndContract": {
        "estimatedNetworkFee": {
          "amount": "0.000002431077",
          "tokenSymbol": "BNB",
          "valueUsd": "0.001594",
          "rentFeeAmount": null,
          "rentFeeValueUsd": null,
          "priorityFeeAmount": null
        },
        "interactWith": {
          "address": "0x87870Bca3F3fF67225794148012b73643B78Ed36"
        }
      },
      "healthFactor": null,
      "warnings": []
    }
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json