Skip to main content
GET
/
custodians
/
me
/
gas-sponsorship
/
chains
Get gas sponsors
curl --request GET \
  --url https://api.portalhq.io/api/v3/custodians/me/gas-sponsorship/chains \
  --header 'Authorization: Bearer <token>'
[
  {
    "chainId": "eip155:11155111",
    "currentPeriod": {
      "gasAllowanceLimit": "499",
      "gasUsage": "0.35080714673101143",
      "transactionCount": "3005",
      "endsAt": "2026-02-13T17:49:43.000Z"
    }
  },
  {
    "chainId": "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
    "currentPeriod": {
      "gasAllowanceLimit": "5",
      "gasUsage": "0.0053",
      "transactionCount": "12",
      "endsAt": "2026-02-13T17:49:43.000Z"
    },
    "gasSponsor": {
      "address": "8K1q5fZcHz3bVExampleSolanaGasSponsorPublicKey",
      "balance": "4.927",
      "balanceInBaseUnits": "4927000000"
    }
  }
]

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.

Authorizations

​
Authorization
string
header
required

Portal API Key (Custodian API Key). Pass as a Bearer token in the Authorization header.

Query Parameters

​
chains
string

Comma-separated list of chains to include in the response. Each entry may be a friendly slug (e.g. solana, base) or a full CAIP-2 chain ID (e.g. eip155:1). When omitted, every configured chain is returned.

Response

Gas sponsors retrieved successfully

​
chainId
string
​
currentPeriod
object
​
gasSponsor
object

Only present on Solana entries. null when no gas sponsor has been configured for that chain yet. The balance and balanceInBaseUnits fields are null when the RPC balance lookup fails (the sponsor address is still returned).