Skip to main content
POST
/
clients
/
me
/
chains
/
{chain}
/
assets
/
{token}
/
approvals
Approve a token delegation
curl --request POST \
  --url https://api.portalhq.io/api/v3/clients/me/chains/{chain}/assets/{token}/approvals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "delegateAddress": "0xdFd8302f44727A6348F702fF7B594f127dE3A902",
  "amount": "100"
}
'
{ "transactions": [ { "from": "0x54968898742c08da211a1cd355447cd1f37f0649", "to": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "data": "0x095ea7b3000000000000000000000000..." } ], "metadata": { "chainId": "eip155:1", "delegateAmount": "100", "delegateAmountRaw": "100000000", "delegateAddress": "0xdFd8302f44727A6348F702fF7B594f127dE3A902", "tokenSymbol": "USDC", "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "ownerAddress": "0x54968898742c08da211a1cd355447cd1f37f0649", "tokenDecimals": 6 } }

Authorizations

​
Authorization
string
header
required

Client API Key or Client Session Token (CST). Pass as a Bearer token in the Authorization header.

Path Parameters

​
chain
string
required

The blockchain chain identifier. Use either a friendly name or CAIP-2 format. When using CAIP-2 format in URLs, ensure the colon (:) is URI-encoded as %3A.

Supported chains:

  • ethereum (eip155:1)
  • sepolia (eip155:11155111)
  • base (eip155:8453)
  • base-sepolia (eip155:84532)
  • polygon (eip155:137)
  • polygon-mumbai (eip155:80001)
  • celo (eip155:42220)
  • celo-alfajores (eip155:44787)
  • monad-testnet (eip155:10143)
  • solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)
  • solana-devnet (solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1)
  • tron (tron:mainnet)
  • tron-nile (tron:nile)
  • tron-shasta (tron:shasta)
  • stellar (stellar:pubnet)
  • stellar-testnet (stellar:testnet)
  • bitcoin-segwit (bip122:000000000019d6689c085ae165831e93-p2wpkh)
  • bitcoin-segwit-testnet (bip122:000000000933ea01ad0ee984209779ba-p2wpkh)
  • bitcoin-p2wpkh (bip122:000000000019d6689c085ae165831e93-p2wpkh)
  • bitcoin-p2wpkh-testnet (bip122:000000000933ea01ad0ee984209779ba-p2wpkh)
​
token
string
required

The token symbol (e.g. USDC, ETH) or contract/mint address on the specified chain.

Body

application/json
​
delegateAddress
string
required

The address to delegate spending authority to.

​
amount
string
required

The amount to approve for delegation. Must be greater than zero.

Response

Approval transaction built successfully. Response format depends on the chain type.

Delegation transaction response for EVM chains.

​
transactions
object[]

Array of unsigned transactions to sign and submit.

​
metadata
object

Transaction metadata. Fields vary depending on the operation (approval, revocation, or transfer).