> ## Documentation Index > Fetch the complete documentation index at: https://docs.portalhq.io/llms.txt > Use this file to discover all available pages before exploring further. # Transfer as a delegate > Transfers tokens from a client on behalf of another address using delegated spending authority. Returns unsigned transaction(s) ready for signing. ## OpenAPI ````yaml /openapi/custodian-api.yaml post /custodians/me/clients/{clientId}/chains/{chain}/assets/{token}/delegations/transfers openapi: 3.1.0 info: title: Portal Custodian API version: '3.0' description: > The Portal Custodian API provides endpoints for managing clients, building transactions, retrieving wallet data, managing delegations, alert webhooks, and gas sponsorship. All endpoints require authentication via a Portal API Key (also known as a Custodian API Key) passed as a Bearer token. ## Base URL `https://api.portalhq.io/api/v3` ## Authentication Include your Portal API Key as a Bearer token in the `Authorization` header of every request. ## Chain ID Format Chain parameters use either friendly names (e.g. `ethereum`, `solana`) or CAIP-2 format (e.g. `eip155:1`, `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`). When using CAIP-2 format in URLs, ensure the colon is URI-encoded (`%3A`). servers: - url: https://api.portalhq.io/api/v3 description: Production security: - bearerAuth: [] tags: - name: Clients description: Create and manage Portal clients - name: Transactions description: Build and evaluate blockchain transactions - name: Wallet Metadata description: Retrieve wallet balances and NFTs - name: Wallet Shares description: Manage backup shares and wallet ejection - name: Delegations description: Manage token delegations and delegated transfers - name: Session Keys description: Build and send EIP-7702 session key user operations - name: Alert Webhooks description: Manage alert webhooks, external addresses, and replay failed events - name: Gas Sponsorship description: View and manage gas sponsorship across chains paths: /custodians/me/clients/{clientId}/chains/{chain}/assets/{token}/delegations/transfers: post: tags: - Delegations summary: Transfer as a delegate description: > Transfers tokens from a client on behalf of another address using delegated spending authority. Returns unsigned transaction(s) ready for signing. operationId: custodianDelegationTransfer parameters: - $ref: '#/components/parameters/clientId' - $ref: '#/components/parameters/chain' - $ref: '#/components/parameters/token' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/DelegationTransferRequest' example: fromAddress: '0x5e1a0d484c5f0de722e82f9dca3a9d5a421d47cb' toAddress: '0x9876543210fedcba9876543210fedcba98765432' amount: '100' responses: '200': description: Unsigned delegation transfer transaction(s) built successfully content: application/json: schema: oneOf: - $ref: '#/components/schemas/DelegationTransferEvmResponse' - $ref: '#/components/schemas/DelegationTransferSolanaResponse' examples: evm: summary: EVM delegation transfer value: transactions: - from: '0x1234567890abcdef1234567890abcdef12345678' to: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' data: 0x23b872dd... value: '0x0' metadata: amount: '100.0' amountRaw: '100000000' chainId: eip155:1 delegateAddress: '0x1234567890abcdef1234567890abcdef12345678' ownerAddress: '0x5e1a0d484c5f0de722e82f9dca3a9d5a421d47cb' recipientAddress: '0x9876543210fedcba9876543210fedcba98765432' tokenAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' tokenSymbol: USDC tokenDecimals: 6 solana: summary: Solana delegation transfer value: encodedTransactions: - >- AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAIEfGzKdQVmXn0GKjTPBmEMuca3SbUvHjJWvxyrNqRvSgGH4... metadata: amount: '100.0' amountRaw: '100000000' chainId: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp delegateAddress: 7UX2i7SucgLMQcfZ75s3VXmZZY4YRUyJN9X1RgfMoDUi lastValidBlockHeight: '252435678' needsRecipientTokenAccount: false ownerAddress: Hm64jVjGRz7soPXReLXoXBYDvY5xKmkXjMWkPyLP5gqc recipientAddress: 9aE476sH92Vz7DMPyq5WLPkrKWivxeuTKEFKd2sZZcde tokenAddress: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v tokenSymbol: USDC tokenDecimals: 6 '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized - invalid or missing authentication token content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: parameters: clientId: name: clientId in: path required: true description: The unique identifier of the client. schema: type: string chain: name: chain in: path required: true description: > 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`) schema: type: string examples: ethereum: value: ethereum summary: Ethereum mainnet (friendly name) eip155: value: eip155:1 summary: Ethereum mainnet (CAIP-2) solana: value: solana summary: Solana mainnet (friendly name) token: name: token in: path required: true description: > The token symbol (e.g. `USDC`, `ETH`) or contract/mint address on the specified chain. schema: type: string examples: symbol: value: USDC summary: Token symbol contractAddress: value: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48' summary: ERC-20 contract address schemas: DelegationTransferRequest: type: object required: - fromAddress - toAddress - amount properties: fromAddress: type: string description: The address of the token owner whose tokens will be transferred. toAddress: type: string description: The recipient address. amount: type: string description: The amount to transfer in the token's primary denomination. DelegationTransferEvmResponse: type: object properties: transactions: type: array items: type: object properties: from: type: string to: type: string data: type: string value: type: string metadata: type: object properties: amount: type: string amountRaw: type: string chainId: type: string delegateAddress: type: string ownerAddress: type: string recipientAddress: type: string tokenAddress: type: string tokenSymbol: type: string tokenDecimals: type: integer DelegationTransferSolanaResponse: type: object properties: encodedTransactions: type: array items: type: string metadata: type: object properties: amount: type: string amountRaw: type: string chainId: type: string delegateAddress: type: string lastValidBlockHeight: type: string needsRecipientTokenAccount: type: boolean ownerAddress: type: string recipientAddress: type: string tokenAddress: type: string tokenSymbol: type: string tokenDecimals: type: integer ErrorResponse: type: object properties: error: type: string description: Error message describing what went wrong securitySchemes: bearerAuth: type: http scheme: bearer description: | Portal API Key (Custodian API Key). Pass as a Bearer token in the Authorization header. ````