Skip to main content
POST
/
clients
/
me
/
chains
/
{chain}
/
assets
/
{token}
/
delegations
/
transfers
Transfer tokens as a delegate
curl --request POST \
  --url https://api.portalhq.io/api/v3/clients/me/chains/{chain}/assets/{token}/delegations/transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fromAddress": "0x54968898742c08da211a1cd355447cd1f37f0649",
  "toAddress": "0xdFd8302f44727A6348F702fF7B594f127dE3A902",
  "amount": "50"
}
'
{
  "transactions": [
    {
      "from": "0x54968898742c08da211a1cd355447cd1f37f0649",
      "to": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "data": "0x23b872dd000000000000000000000000..."
    }
  ],
  "metadata": {
    "amount": "50",
    "amountRaw": "50000000",
    "chainId": "eip155:1",
    "delegateAddress": "0x54968898742c08da211a1cd355447cd1f37f0649",
    "ownerAddress": "0x54968898742c08da211a1cd355447cd1f37f0649",
    "recipientAddress": "0xdFd8302f44727A6348F702fF7B594f127dE3A902",
    "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "tokenSymbol": "USDC",
    "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
​
fromAddress
string
required

The address to transfer tokens from (the token owner).

​
toAddress
string
required

The address to transfer tokens to.

​
amount
string
required

The amount to transfer. Must be greater than zero.

Response

Delegated transfer 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).