Skip to content

2026-5-12

2026-05-12

Futures V3 & Testnet — Register and Approve Agent Endpoint

  • Added a new endpoint POST /fapi/v3/registerAndApproveAgent — Register and Approve Agent (PUBLIC) in Futures V3 and Futures Testnet (EN & ZH):
  • Registers an API agent account and grants trading/withdrawal permissions in a single atomic call.
  • No authentication required — authorization is verified through the signature parameter (no API Key or HMAC header).
  • signature is generated by signing the canonical message body (msg: user={user}&nonce={nonce}&agentName={agentName}&agentAddress={agentAddress}&expired={expired}&signatureChainId={signatureChainId}&canSpotTrade={canSpotTrade}&canPerpTrade={canPerpTrade}&canWithdraw={canWithdraw}&ipWhitelist={ipWhitelist}) with the user's wallet private key.
  • Supports EVM (EIP-712 Typed Data, signatureChainId=56) and Solana (Ed25519, signatureChainId=101) signing. For EVM the msg string is wrapped as message.msg in the documented EIP-712 typed-data structure before signing.
  • EIP-712 domain chainId is 1666 for V3 mainnet and 714 for Testnet.
  • Configurable per-agent permissions: canSpotTrade, canPerpTrade, canWithdraw.
  • ipWhitelist: space-separated, supports CIDR; required and must not be empty when canWithdraw=true.
  • Optional referral code via agentCode; agent validity bounded by expired (millisecond timestamp).
  • Weight: 50.