Overview

The GasTanker API keeps your operational wallets visible: which ones are healthy, which are running low, and what GasTanker has recorded about them.

What you can do todayCopy Anchor Link

• Register wallets on the networks GasTanker accepts, and list them. GET /v1/networks lists those networks; today that is Base.
• Read gas health for a wallet: its latest balance and whether it is above your policy's threshold.
• Read gas policies and their immutable revisions.
• Ask GasTanker to check a wallet now. If it is low, GasTanker records a gas operation and alerts your team.

GasTanker is in a design-partner beta. It monitors wallets and sends alerts; it does not move funds. Automatic funding is coming soon, and the same calls will drive it without changing your integration.

BasicsCopy Anchor Link

• Base URL: https://api.gastanker.xyz. Every endpoint is under /v1.
• Requests and responses are JSON.
• Authenticate every request with an organization API key in the X-API-Key header. See Authentication.
• Every POST needs an Idempotency-Key header. See Idempotency.
• Amounts are exact integer strings in the wallet network's native base units (wei for ETH on Base). GET /v1/networks gives each network's native asset and its decimals. There is no floating point anywhere.

What the API never acceptsCopy Anchor Link

Exchange credentials, withdrawal addresses, transaction payloads, and signing material never go through the public API. Gas policies are created and changed in the GasTanker workspace, where changes need a second-factor check; the API reads them.