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"
    }
  }
]

Gas Sponsorship

Get gas sponsors

Retrieves all gas sponsors and their usage information across all chains for your Portal environment. Solana entries also include the gas sponsor’s on-chain address and current balance.

Filtering: Pass the optional chains query parameter to narrow the response to a subset of chains. Each entry may be either a friendly chain slug (for example solana, solana-devnet, base, ethereum) or a full CAIP-2 chain ID (for example eip155:1, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp).

Tip — speed up your request: Only need a subset of chains? Passing chains skips the data fetches for every chain you leave out, which can reduce response times from several seconds to a few hundred milliseconds. For example, if you only care about Solana gas sponsor info, pass chains=solana,solana-devnet.

Note: Gas sponsorship must be enabled for your Portal environment.

GET

custodians

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"
    }
  }
]

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

Show child attributes

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

Show child attributes

Delete an external address Update gas sponsorship for a chain

⌘I