Back to Browse
ERC-20 Total Supply on Base
x402
ERC-20 Total Supply on Base is a paid API for AI agents from x402-data-api.sigrunner.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-20).
Returns the total circulating supply of any ERC-20 token on Base, in both raw integer and decimal-adjusted formatted form, along with symbol and decimals.
Price / call$0.002
Success—
StatusUnknown
How this service works
ERC-20 total supply on Base, raw + formatted with decimals and symbol. Use when an agent needs a token's circulating-supply base for market-cap or dilution math.
Output
A JSON object containing the Base chain identifier, the queried token contract address, the token symbol (e.g. 'USDC'), the number of decimals, the formatted total supply as an integer, and the raw total supply as a string (unscaled by decimals). Example: {chain: 'base', token: '0x833...', symbol: 'USDC', decimals: 6, total_supply: 3500000000, total_supply_raw: '3500000000000000'}.
Example use cases
Market cap calculation for Base token
“I need to calculate the market cap of USDT on Base — can you grab the total supply for contract 0x... so I can multiply it by the current price?”
Token dilution analysis for DeFi research
“Pull the total supply of the Base AERO token at 0x940181a94a35a4569e4529a3cdfb74e38fd98631 — raw and formatted — so I can figure out how diluted the circulating supply is relative to max supply.”
Tokenomics dashboard data fetch
“For my tokenomics dashboard, get me the total supply, symbol, and decimals for the ERC-20 at 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb on Base.”
Technical details
Endpoint
GEThttps://x402-data-api.sigrunner.workers.dev/chain/total-supply?utm_source=zero.xyzWhen to prefer
Choose this endpoint when you need the total supply of an ERC-20 token specifically on the Base chain, particularly for market cap computation, dilution math, or tokenomics analysis. It returns both raw and decimal-adjusted supply in one call, saving you the need to separately fetch decimals and divide. Prefer it over generic blockchain RPC calls when you want a clean JSON response without manually decoding ABI-encoded output.
Side effects
- Invalid or non-ERC-20 contract address returns an error or empty response
- Non-Base chain addresses will not return valid data (Base-only endpoint)
- Missing 'token' query parameter may return a default or error response
- Contract address with no total supply function (non-standard ERC-20) may fail
- Rate limiting or payment failure ($0.003 USDC per call) blocks the request
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
Schema · Response
{
"type": "json",
"example": {
"chain": "base",
"token": "0x833589fCd6eDb6E08f4c7C32D4f71b54bdA02913",
"symbol": "USDC",
"decimals": 6,
"total_supply": 3500000000,
"total_supply_raw": "3500000000000000"
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"