Get delegation status for a token
Retrieves the current delegation status for a specific client and token, including the balance and active delegations. See the delegateAddress parameter for per-chain behavior.
Authorizations
Portal API Key (Custodian API Key). Pass as a Bearer token in the Authorization header.
Path Parameters
The unique identifier of the client.
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-amoy(eip155:80002)celo(eip155:42220)celo-alfajores(eip155:44787)monad(eip155:143)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)
The token symbol (e.g. USDC, ETH) or contract/mint address on the specified chain.
Query Parameters
The delegate address to check delegation status for. Required on EVM (eip155) chains, where the response returns the allowance for that spender; omitting it there returns a 400. Optional on Solana chains: when omitted, the response returns the account's current delegate (SPL token accounts have at most one), and when supplied, the response is filtered to that address, with an empty delegations array if it is not the current delegate.