# Mach Gallery Base Token Total Supply

> Mach Gallery Base Token Total Supply is a paid API for AI agents from api.mach.gallery, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-02).

Returns the total supply (in atomic units) of a given ERC-20 token on the Base network

## Facts

- Endpoint: POST https://api.mach.gallery/api/base/total-supply?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mach-gallery-base-token-total-supply-b11c971c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VfuRx5D-JAkiE5Ku6_33O

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability mach-gallery-base-token-total-supply-b11c971c -d '<json body>'
```

Example prompt: What is the total token supply for the ERC-20 contract at 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA on Base?

## When to prefer this

Choose this endpoint when you need permissionless, pay-per-call access to Base token total supply data without API key registration. Ideal for autonomous agents that need on-demand, low-cost on-chain data for Base ERC-20 tokens. Prefer over RPC-direct calls when you want a simple REST interface and over subscription APIs when call volume is low or unpredictable.

## Known failure modes

- Invalid or malformed contract address returns an error
- Address is valid EVM format but not an ERC-20 token on Base — may return zero supply or an error
- Payment failure (insufficient USDC via x402) blocks the request
- Network congestion on Base may delay response
- Contract address points to a non-existent or self-destructed contract

## How this service works

Fast, low-cost Base data for autonomous agents. No API keys, no subscriptions; pay per call with USDC over x402.

## Output

Returns a JSON object with the Base network identifier (eip155:8453) and the token's total supply expressed in atomic (smallest denomination) units as a string, e.g. {"network":"eip155:8453","total_supply_atomic":"1000000000000000000"}

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "token": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "ERC-20 or token contract address on Base mainnet."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "network": "eip155:8453",
  "total_supply_atomic": "0"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mach-gallery-base-token-total-supply-b11c971c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.mach.gallery](https://www.zero.xyz/host/api.mach.gallery/llms.txt)