# Ambolt Base Token Facts

> Ambolt Base Token Facts is a paid API for AI agents from api.ambolt.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Fetches on-chain facts about an ERC-20 token contract on the Base network, including metadata, proxy structure, ownership, supply, and detected capabilities.

## Facts

- Endpoint: GET https://api.ambolt.dev/v1/base-token-facts?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ambolt-base-token-facts-db27bc59
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3BQcrr8Mzsk_i_naS1pr_

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 ambolt-base-token-facts-db27bc59
```

Example prompt: What are the on-chain facts for the USDC token contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — tell me if it's a proxy, who owns it, the total supply, and any special capabilities like mint or blacklist baked into the bytecode.

## When to prefer this

Choose this endpoint when you specifically need on-chain facts about an ERC-20 token deployed on the Base network, especially when you need proxy structure, ownership details, bytecode-level capability detection (mint, burn, blacklist, pause, upgrade), and total supply in a single call. Prefer this over generic block explorers when you need structured, machine-readable output for AI agent workflows. This is ideal for token risk analysis, DeFi due diligence, portfolio enrichment, or automated smart contract auditing on Base.

## Known failure modes

- Token address not found on Base — returns found: false
- Invalid address format (not a valid 0x ERC-20 address) — schema validation error
- Contract exists but is not an ERC-20 — may return partial or empty metadata
- Network connectivity issue to Base RPC — service error
- Payment failure via x402 — 402 Payment Required returned before data is delivered

## How this service works

Pay-per-call data tools for developers and AI agents: company registers, documents, tenders, rates and on-chain facts as MCP tools, x402 endpoints and Apify Actors.

## Output

A JSON object containing: token name, symbol, decimals, total supply (raw and human-readable), chain ID, network name, whether the contract is paused, whether it is a proxy (with proxy admin and implementation addresses), owner details (address, kind, whether ownership is renounced, whether an owner function exists), list of capabilities detected in bytecode (e.g. mint, burn, pause, blacklist, upgrade), contract byte size, and a timestamp of when the data was fetched. Also includes a note that capabilities are heuristic detections and not investment advice.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "POST"
     ]
    },
    "queryParams": {
     "type": "object",
     "required": [
      "token"
     ],
     "properties": {
      "token": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "ERC-20 token contract address on Base."
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "USD Coin",
  "note": "Capabilities are four-byte function selectors found in the contract bytecode (heuristic: a function can exist without being used). Facts at the time of the call; not advice.",
  "found": true,
  "owner": {
   "kind": "externally owned account",
   "address": "0x3abd6f64a422225e61e435bae41db12096106df7",
   "renounced": false,
   "hasOwnerFunction": true
  },
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "paused": false,
  "symbol": "USDC",
  "chainId": 8453,
  "isProxy": true,
  "network": "base",
  "decimals": 6,
  "checkedAt": "2026-10-02T23:08:15.427Z",
  "proxyAdmin": "0x4fc7850364958d97b4d3f5a08f79db2493f8ca44",
  "totalSupply": "4356053376.009397",
  "contractBytes": 1852,
  "implementation": "0x2ce6311ddae708829bc0784c967b7d77d19fd779",
  "totalSupplyRaw": "4356053376009397",
  "capabilitiesInBytecode": [
   "mint",
   "burn",
   "pause",
   "blacklist",
   "ownerTransfer",
   "upgrade"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ambolt-base-token-facts-db27bc59/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ambolt.dev](https://www.zero.xyz/host/api.ambolt.dev/llms.txt)