Skip to main content
POST
/
clients
/
me
/
fund
Fund the client's wallet with testnet tokens
curl --request POST \
  --url https://api.portalhq.io/api/v3/clients/me/fund \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chainId": "eip155:11155111",
  "token": "USDC",
  "amount": "10"
}
'
{
  "data": {
    "explorerUrl": "https://sepolia.etherscan.io/tx/0xabc123...",
    "txHash": "0xabc123..."
  },
  "metadata": {
    "amount": "10",
    "chainId": "eip155:11155111",
    "clientId": "clientId",
    "custodianId": "custodianId",
    "environmentId": "environmentId",
    "token": "USDC"
  }
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
chainId
string
required

The testnet chain ID in CAIP-2 format (e.g. eip155:11155111 for Sepolia).

​
token
string
required

The token symbol to fund (e.g. USDC, ETH).

​
amount
string
required

The amount to fund as a numeric string. Must be greater than zero.

Response

Fund request processed. The response contains either data (on success) or error (on failure), but not both.

​
data
object

Present on success, null on failure.

​
error
object

Present on failure, null on success.

​
metadata
object