Approve API Wallet

HyperliquidPolymarket

Approves or revokes an API wallet. The request calls this wallet an agent.

Endpoint

POST /exchange

Request Body

Parameter	Type	Description
`action`*	object	Agent approval payload
`nonce`*	number	Replay-protection nonce, e.g., `1701234567890`
`signature`*	object	EIP-712 signature

action

Field	Type	Description
`type`*	string	Must be `"approveAgent"`
`hyperliquidChain`*	string	`"Mainnet"` or `"Testnet"`
`signatureChainId`*	string	EIP-712 chain ID in hex, for example `"0xa4b1"`
`agentAddress`*	string	API wallet address, or `"0x0000000000000000000000000000000000000000"` to revoke
`agentName`	string	Optional label, max 50 chars
`nonce`*	number	Must match the request-envelope `nonce`

signature

Field	Type	Description
`r`*	string	32-byte hex string, e.g., `"0x1234..."`
`s`*	string	32-byte hex string, e.g., `"0x5678..."`
`v`*	number	Recovery ID, e.g., `27`

Signing and Revocation

Use the NotionalSignTransaction domain, version 1, with the numeric signatureChainId and the zero address as verifyingContract. The primary type is NotionalTransaction:ApproveAgent. Use getNotionalDomain, AGENT_APPROVAL_TYPES, and buildAgentApprovalMessage from @notional/common to construct the typed data. The signed message contains notionalChain: string, agentAddress: address, agentName: string, and nonce: uint64. The HTTP action calls the network field hyperliquidChain; the signed message calls it notionalChain. Use the matching Mainnet or Testnet value. Sign with the account owner’s wallet and submit the signature as { r, s, v }. To revoke, set agentAddress to the zero address and use the existing wallet’s agentName. Use an empty name for the unnamed wallet. An existing address cannot be renamed in place; revoke it first, then approve it under the new name.

Response

200: Approved
401: Unauthorized

{
  "success": true
}

{
  "error": "Signature verification failed",
  "code": "UNAUTHORIZED",
  "timestamp": 1785254400000
}

Start Here

Info

Analytics

Exchange

WebSocket

Endpoint

Request Body

action

signature

Signing and Revocation

Response

​Endpoint

​Request Body

​action

​signature

​Signing and Revocation

​Response

Endpoint

Request Body

action

signature

Signing and Revocation

Response