Skip to main content
PATCH
/
custodians
/
me
/
gas-sponsorship
/
chains
/
{chainId}
Update gas sponsorship for a chain
curl --request PATCH \
  --url https://api.portalhq.io/api/v3/custodians/me/gas-sponsorship/chains/{chainId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "value": "10"
}'
{
  "chainId": "eip155:11155111",
  "currentPeriod": {
    "gasAllowanceLimit": "499",
    "gasUsage": "0.35080714673101143",
    "transactionCount": "3005",
    "endsAt": "2026-02-13T17:49:43.000Z"
  }
}

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.

Path Parameters

​
chainId
string
required

The CAIP-2 chain ID. Be sure the colon (:) is URI-encoded as %3A in the URL.

Body

application/json
​
value
string
required

The new maximum gas allowance limit in ETH/SOL units.

Response

Gas sponsor updated 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).