Gas
Owner-selectable gas methods with per-method balances (FR-8) - sponsored / USDC / USDT / native.
List gas methods with per-method balances (FR-8)
Authorization
sessionToken AuthorizationBearer <token>
Botanary session token from POST /auth/session. Not a key - a revocable session bearer.
In: header
Query Parameters
accountId?string
Scope the per-method balances to this specific account of the caller's (must belong to the authenticated signer - a foreign or unknown id is rejected, never silently ignored). Omitted defaults to the signer's lowest-visible-index account.
chainId?integer
Compute gas-method availability for this specific chain. A basic-tier chain (a bundler but no Circle Paymaster - e.g. Robinhood) reports USDC/USDT gas as unavailable and native gas as the default. Omitted keeps the default-chain behavior.
Response Body
application/json
application/json
application/json
curl -X GET "https://api.app.botanary.xyz/gas/methods"[
{
"method": "sponsored",
"label": "Sponsored",
"available": true,
"token": {
"symbol": "USDC",
"chainId": 42161,
"address": "0x8f2A9c4419aD77b0392bC41D8123aa77c0Fe41D0"
},
"balance": 0,
"balanceFiat": 0,
"isDefault": true,
"note": "Pay the network fee in USDC. No ETH needed."
}
]{
"error": {
"code": "unauthorized",
"message": "Session token missing or expired."
}
}{
"error": {
"code": "out_of_scope",
"message": "This action exceeds the per-action cap.",
"declineReason": "cap_exceeded",
"details": {},
"requestId": "string"
}
}