---
name: axiom-tools
version: 3.0.0
description: 41 agent endpoints on Base — wallet risk, token analysis, contract scanning, gas oracle, NFT intel, portfolio evidence, and more. Pay per call with x402 (USDC) or hold an AXIOM Tool Pass for unlimited access.
homepage: https://www.clawbots.org/tools
metadata: {"emoji":"🔬","category":"agent-tools","chain":"base","api_base":"https://www.clawbots.org/api/tools"}
---

# Axiom Tools

41 agent endpoints on Base. Pay per call with x402 micropayments (USDC), or hold an AXIOM Tool Pass NFT for unlimited access.

Full spec: https://www.clawbots.org/tools.llms.txt
Human-readable: https://www.clawbots.org/tools

---

## Endpoints

### Infrastructure
| Tool | Endpoint | Price |
|------|----------|-------|
| Base Ecosystem Radar | GET/POST /api/tools/base-ecosystem-radar | $0.03 |
| Contract ABI Inspector | GET/POST /api/tools/contract-abi-inspector | $0.02 |
| ENS Resolver | GET/POST /api/tools/ens-resolver | Free |
| ERC-20 Approval Audit | GET/POST /api/tools/erc20-approval-audit | $0.03 |
| Gas Oracle | GET/POST /api/tools/gas-oracle | $0.01 |
| TX Decoder | GET/POST /api/tools/tx-decoder | Free |
| Wallet Profile | GET/POST /api/tools/wallet-profile | $0.02 |
| Wallet Action Ledger | GET/POST /api/tools/wallet-action-ledger | $0.02 |
| Token Safety Check | GET/POST /api/tools/token-safety | $0.02 |
| ERC-20 Holder Overlap | GET/POST /api/tools/erc20-holder-overlap | $0.05 |
| Token Info | GET/POST /api/tools/token-info | $0.02 |
| x402 Preflight | GET/POST /api/tools/x402-preflight | $0.02 |
| x402 Cost Guard | POST /api/tools/x402-cost-guard | $0.01 |

#### Contract ABI Inspector
Inspect a Base contract before an agent calls it. Returns verified-source status, compiler metadata, proxy implementation hints, ABI counts, sample read/write/event signatures, payable/write-method flags, and Blockscout evidence. Powered by Blockscout. 5min cache. $0.02 USDC per call; AXIOM Tool Pass holders get free access.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| address | string | Yes | Contract address on Base (0x...). |
| includeAbi | boolean | No | If true, include the raw ABI array. Defaults false to keep responses compact. (default: false) |

```bash
curl "https://www.clawbots.org/api/tools/contract-abi-inspector?address=0x4200000000000000000000000000000000000006"
```

#### ENS Resolver
Batch ENS name/address resolution on Ethereum mainnet. Forward: ENS name (.eth etc) → address (up to 20 names). Reverse: Ethereum address → primary ENS name. Also returns avatar URL when available. Free — no payment required. Handles .eth names and any ENS subdomain.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| items | array | Yes | Array of ENS names and/or Ethereum addresses to resolve. Mix is OK. |

```bash
curl -X POST "https://www.clawbots.org/api/tools/ens-resolver" \
  -H "Content-Type: application/json" \
  -d '{"items":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"]}'
```

#### ERC-20 Approval Audit
Audit recent Base ERC-20 approvals for a wallet before an agent spends or routes funds. Scans Approval(owner,spender,value) logs, collapses by token+spender, reads live allowance() for each pair, flags infinite approvals, and returns block/tx evidence. Uses public Base RPC fallbacks. $0.03 USDC per call; AXIOM Tool Pass holders get free access.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| owner | string | Yes | Base wallet address whose ERC-20 approvals should be audited (0x...). |
| lookbackBlocks | integer | No | Recent Base block window to scan for Approval events. Larger windows are slower and may hit public RPC limits. (default: 50000) |
| maxApprovals | integer | No | Maximum discovered token+spender pairs to verify with live allowance() reads. (default: 40) |
| includeRevoked | boolean | No | Include discovered pairs whose current live allowance is zero. (default: false) |

```bash
curl "https://www.clawbots.org/api/tools/erc20-approval-audit?owner=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
```

#### TX Decoder
Decode any Base transaction by hash. Returns the decoded function call (method name + parameters), token transfers (ERC-20/ERC-721/ERC-1155), ETH value sent, gas used, and a plain-English summary of what happened. Free. 60s cache.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| hash | string | Yes | Base transaction hash (0x + 64 hex chars) |

```bash
curl "https://www.clawbots.org/api/tools/tx-decoder?hash=0x8e7d48c25768bec80dfeafd3cbe5c3b12df2d0b8f9786fa035e002b53d966ba0"
```

#### Wallet Profile
Comprehensive Base wallet profile for agent-to-agent context. Returns ENS name, ETH balance, top-10 ERC-20 token holdings (symbol, name, raw balance), distinct NFT collection count, transaction count, token transfer count, and wallet age (first-seen date on Base). Powered by Blockscout. 5min cache. $0.02 USDC per call; AXIOM Tool Pass holders get free access.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| address | string | Yes | Base wallet address to profile (0x...) |

```bash
curl "https://www.clawbots.org/api/tools/wallet-profile?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
```

#### Wallet Action Ledger
Recent Base wallet action receipt for agents. Summarizes the latest transactions by direction, failed count, contract calls, token-transfer transactions, top methods and counterparties, gas/value totals, and per-transaction Blockscout evidence links. Powered by Blockscout. 5min cache. $0.02 USDC per call; AXIOM Tool Pass holders get free access.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| address | string | Yes | Base wallet address to summarize (0x...). |
| limit | integer | No | Number of recent transactions to inspect, 1–50. Defaults to 25. (default: 25) |

```bash
curl "https://www.clawbots.org/api/tools/wallet-action-ledger?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
```

#### Token Safety Check
Pre-execution token safety scan. Checks for honeypots, sell restrictions, hidden owners, balance manipulation, excessive taxes, proxy contracts, blacklists, and more. Powered by GoPlus Security + Blockscout verification. Returns a risk level (DANGEROUS / HIGH_RISK / MEDIUM_RISK / LOW_RISK / LIKELY_SAFE) with detailed findings. Use before any trade or token interaction.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| address | string | Yes | Token contract address (0x + 40 hex chars). E.g. '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' for USDC on Base. |
| chain | string | No | Chain to check on: base, ethereum, arbitrum, or polygon. (default: base) |

```bash
curl "https://www.clawbots.org/api/tools/token-safety?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
```

#### ERC-20 Holder Overlap
Computes holder overlap between two ERC-20 tokens on Base. Returns the number of wallets holding both tokens (above optional minimum balances), overlap percentage, Jaccard similarity index, and top-25 shared wallets by combined holdings. Useful for community analysis, airdrop targeting, and token ecosystem research.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| tokenA | string | Yes | First ERC-20 token contract address on Base. E.g. '0x4200000000000000000000000000000000000006' for WETH. |
| tokenB | string | Yes | Second ERC-20 token contract address to compare against. Must differ from tokenA. |
| minBalanceA | string | No | Minimum token balance for tokenA holders in atomic units (wei). Default '0' includes all holders. E.g. '1000000' for 1 USDC (6 decimals). (default: 0) |
| minBalanceB | string | No | Minimum token balance for tokenB holders in atomic units (wei). Default '0' includes all holders. (default: 0) |
| maxPages | integer | No | Max Blockscout pages to walk per token (default 5, max 20). Higher = more holders scanned but slower. (default: 5) |

```bash
curl "https://www.clawbots.org/api/tools/erc20-holder-overlap?tokenA=0x4200000000000000000000000000000000000006&tokenB=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
```

#### Token Info
Raw ERC-20 token facts for any Base token. Returns name, symbol, decimals, total supply, holder count, transfer count, USD exchange rate, 24h trading volume, circulating market cap, and top-10 holders with percentage share. Powered by Blockscout. 5min cache. $0.02 USDC per call; AXIOM Tool Pass holders get free access.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| token | string | Yes | ERC-20 contract address on Base (0x...) |

```bash
curl "https://www.clawbots.org/api/tools/token-info?token=0x4200000000000000000000000000000000000006"
```

#### x402 Preflight
Preflight a public HTTPS endpoint before spending. Probes with GET or POST, detects 402/x402 payment requirements, summarizes networks, schemes, payTo recipients, USDC price hints, retryability, Tool Pass auth clues, latency, and evidence. Blocks localhost/private/IP-literal targets to avoid SSRF. Built for agents deciding whether and how to pay a Base x402 endpoint.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| url | string | Yes | Public HTTPS endpoint URL to probe. Private hosts, localhost, and IP literals are rejected. |
| method | string | No | Probe method. POST sends the supplied JSON body; GET sends no body. (default: POST) |
| body | object | No | JSON body for POST probes. Do not include secrets; custom headers are intentionally not supported. (default: {}) |
| timeoutMs | integer | No | Probe timeout in milliseconds. (default: 8000) |

```bash
curl "https://www.clawbots.org/api/tools/x402-preflight?url=https%3A%2F%2Fwww.clawbots.org%2Fapi%2Ftools%2Fgas-oracle"
```

#### x402 Cost Guard
Budget guard for x402 quotes. Pass one or more payment requirements from a 402 envelope and get a deterministic spend/no-spend decision, cheapest compatible requirement, Base USDC compatibility checks, per-quote USDC normalization, and warnings before an agent pays. $0.01 USDC per call; AXIOM Tool Pass holders bypass via SIWE.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| accepts | array | Yes | Payment requirements copied from an x402 envelope's accepts/paymentRequirements array. |
| maxUsdc | number | No | Maximum acceptable spend in decimal USDC. (default: 0.05) |
| preferredNetwork | string | No | Preferred payment network. Defaults to Base mainnet CAIP-2. (default: eip155:8453) |
| preferredAsset | string | No | Preferred asset. Defaults to Base USDC. (default: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) |
| allowMissingPayTo | boolean | No | If false, requirements missing a payTo/recipient are not eligible. (default: false) |

```bash
curl -X POST "https://www.clawbots.org/api/tools/x402-cost-guard" \
  -H "Content-Type: application/json" \
  -d '{"accepts":[{}]}'
```


### NFT & Agents
| Tool | Endpoint | Price |
|------|----------|-------|
| Collection Stats | GET/POST /api/tools/collection-stats | $0.02 |
| NFT Collection Intel | GET/POST /api/tools/nft-collection-intel | $0.03 |
| NFT Holder Overlap | GET/POST /api/tools/nft-holder-overlap | $0.05 |
| rarity-rank | GET/POST /api/tools/rarity-rank | $0.03 |
| Sweep Quote | GET/POST /api/tools/sweep-quote | $0.03 |
| trait-floor | GET/POST /api/tools/trait-floor | $0.03 |
| wallet-holdings | GET/POST /api/tools/wallet-holdings | $0.05 |
| Normie Identity | GET/POST /api/tools/normie-identity | Free / $0.002 |
| Agent Binding Scout | GET/POST /api/tools/agent-binding-scout | $0.01 |

#### Collection Stats
NFT collection health snapshot from OpenSea: floor price, 24h volume, total sales, owner count with distribution percentage, creator royalty vs protocol fee split, and top-5 live bids. Multi-slug compare supported (up to 5 slugs per request). 5-minute cache.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| slug | string | Yes | OpenSea collection slug(s). Pass ?slug=x or ?slug=x&slug=y or POST { slugs: [...] }. |
| slugs | array | No | Alias for `slug` when passed as an array (preferred in POST bodies). |

```bash
curl "https://www.clawbots.org/api/tools/collection-stats?slug=wallet-action-ledger"
```

#### NFT Collection Intel
NFT collection intelligence via OpenSea. Returns floor price, volume, holder distribution, listing depth, wash trading indicators, and sweep probability for any collection. 5min cache. $0.03 USDC per call; AXIOM Tool Pass holders get free access.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| slug | string | Yes | OpenSea collection slug (e.g. 'normies', 'axiom-tool-pass') |
| chain | string | No | Chain name (default: ethereum) (default: ethereum) |

```bash
curl "https://www.clawbots.org/api/tools/nft-collection-intel?slug=wallet-action-ledger"
```

#### NFT Holder Overlap
Computes holder overlap between two OpenSea NFT collections. Returns the number of wallets that hold both, overlap as a percentage of the smaller holder set, the Jaccard similarity index, and the top-25 shared wallets by combined holdings. Useful for cross-marketing analysis, airdrop targeting, and community overlap research.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| collectionA | string | Yes | First OpenSea collection slug (lowercase a-z, 0-9, dash). E.g. 'normies-art'. |
| collectionB | string | Yes | Second OpenSea collection slug to compare against. Must differ from collectionA. |
| maxPages | integer | No | Max Blockscout holder pages to walk per collection (default 10, max 30). Higher = more complete holder set but slower. (default: 10) |

```bash
curl "https://www.clawbots.org/api/tools/nft-holder-overlap?collectionA=normies&collectionB=pudgypenguins"
```

#### rarity-rank
OpenSea rarity rank for a specific NFT token, with each trait annotated by collection-wide frequency and the current best ask. Useful for deciding whether a listing price is justified by rarity.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| collection | string | Yes | OpenSea collection slug (lowercase a-z, 0-9, dash). |
| tokenId | string | Yes | Numeric token ID within the collection. |
| chain | string | No |  (default: ethereum) |

```bash
curl "https://www.clawbots.org/api/tools/rarity-rank?collection=normies&tokenId=1"
```

#### Sweep Quote
Quote a real NFT sweep cost on OpenSea. Walks up the best-listing curve for a collection, deduplicates by token ID, and returns how many NFTs fit a given ETH budget — with average, floor, ceiling, slippage, budget utilization, and the token IDs that would be acquired.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| collection | string | Yes | OpenSea collection slug (lowercase a-z, 0-9, dash). Legacy alias: `slug`. |
| budgetEth | number | Yes | ETH budget for the sweep (0 < x ≤ 10000). Legacy alias: `budget`. |
| maxPages | integer | No | Max OpenSea pages to walk (default 30, max 60). (default: 30) |

```bash
curl -X POST "https://www.clawbots.org/api/tools/sweep-quote" \
  -H "Content-Type: application/json" \
  -d '{"collection":"normies","budgetEth":1}'
```

#### trait-floor
Trait-filtered floor price for an OpenSea collection. The collection floor is the cheapest *anything* listed — useless when traits are rarity-priced. This tool walks best-listings filtered by a Trait:Value combination and returns the trait-specific floor plus premium vs collection floor.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| collection | string | Yes | OpenSea collection slug. |
| traits | array | Yes | Array of {traitType, value} objects. Strings 'Type:Value' also accepted. |
| limit | integer | No | Max listings to fetch (default 5, max 50). (default: 5) |

```bash
curl -X POST "https://www.clawbots.org/api/tools/trait-floor" \
  -H "Content-Type: application/json" \
  -d '{"collection":"normies","traits":[{"traitType":"Background","value":"Blue"}]}'
```

#### wallet-holdings
NFT portfolio snapshot for a wallet address. Fetches all NFTs held (paginated), groups by collection, prices each at current floor, and totals estimated value. Useful for portfolio appraisals and position sizing.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| address | string | Yes | 0x + 40 hex wallet address. |
| chain | string | No |  (default: ethereum) |
| limit | integer,null | No | Truncate to top-N collections by est. value (1-500). null = no truncation. (default: null) |
| maxPages | integer | No | Max pages of 200 NFTs to walk (1-20, default 5). (default: 5) |

```bash
curl "https://www.clawbots.org/api/tools/wallet-holdings?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
```

#### Normie Identity
Normie persona lookup. Given a Normies NFT tokenId (0-9999), returns persona name, type (Human/Cat/Alien/Agent), and visual traits. Free tier returns identity basics. Premium tier ($0.002 USDC or AXIOM Tool Pass) adds the full agent persona: backstory, greeting, personality traits, communication style, and quirks. Data sourced from api.normies.art with a 5-minute upstream cache.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| tokenId | integer | Yes | Normies NFT token ID (e.g. 7593). Required. |

```bash
curl -X POST "https://www.clawbots.org/api/tools/normie-identity" \
  -H "Content-Type: application/json" \
  -d '{"tokenId":1}'
```

#### Agent Binding Scout
Discovery primitive for ERC-8217 agent-bound NFTs in any OpenSea collection. Given a collection slug, returns the subset of NFTs with an agent binding, each enriched with the inline binding payload (agent_id, binding_contract, agent { chain, token_id, contract_address }, registered_by). Built on OpenSea's `has_agent_binding=true` filter (May 2026). Per-NFT enrichment is serialized to dodge OpenSea's stale-cache bug on parallel fan-out. 60s in-memory cache per (collection, chain, limit).

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| collection | string | Yes | OpenSea collection slug (e.g. 'normies'). Required. |
| chain | string | No | Chain identifier used for the per-NFT enrichment fetch. Defaults to 'ethereum'. (default: ethereum) |
| limit | integer | No | Number of bound NFTs to return. Capped at 10 — each entry costs one additional OpenSea call. (default: 5) |

```bash
curl "https://www.clawbots.org/api/tools/agent-binding-scout?collection=normies"
```


### Security & Analysis
| Tool | Endpoint | Price |
|------|----------|-------|
| Contract Safety Scanner | GET/POST /api/tools/contract-safety-scanner | $0.10 |
| Token Due Diligence | GET/POST /api/tools/token-due-diligence | $0.05 |
| Wallet Risk Score | GET/POST /api/tools/wallet-risk-score | $0.05 |
| Agent Cert Check | GET/POST /api/tools/agent-cert-check | Free |

#### Contract Safety Scanner
Smart contract safety analysis on Base. Checks verification status, EIP-1967 proxy patterns, admin/owner functions, upgrade capabilities, self-destruct risk, and bytecode size. Returns a 0-100 safety score with risks + positives. $0.10 USDC per call; AXIOM Tool Pass holders get free access.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| address | string | Yes | Smart contract address on Base (0x...) |

```bash
curl "https://www.clawbots.org/api/tools/contract-safety-scanner?address=0x4200000000000000000000000000000000000006"
```

#### Token Due Diligence
Token safety and quality analysis on Base. Checks holder concentration, verification status, transfer activity, top holder distribution, and red flags. Returns a 0-100 safety score with verdict (likely_safe/moderate_risk/high_risk/avoid). 2min cache. $0.05 USDC per call; AXIOM Tool Pass holders get free access.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| token | string | Yes | ERC-20 token contract address on Base (0x...) |

```bash
curl "https://www.clawbots.org/api/tools/token-due-diligence?token=0x4200000000000000000000000000000000000006"
```

#### Wallet Risk Score
Wallet risk scoring for agent-to-agent trust decisions on Base. Analyzes ETH balance, transaction count, token transfer activity, contract-vs-EOA status, ENS ownership, and known Blockscout labels to produce a 0-100 risk score with flags and positives. 5min cache. $0.05 USDC per call; AXIOM Tool Pass holders get free access.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| address | string | Yes | Wallet address to analyze (0x...) |

```bash
curl "https://www.clawbots.org/api/tools/wallet-risk-score?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
```

#### Agent Cert Check
Live on-chain AgentCheck certification status for any Base address. Queries the AgentCheck registry (0x803A) at call time — not a cached snapshot — returning isCertified, certHash, and batteryHash as of the current block. Use this to gate agent-to-agent interactions on real-time trust state rather than a stale grade. Free.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| address | string | Yes | Base address to check certification for (0x...) |

```bash
curl "https://www.clawbots.org/api/tools/agent-cert-check?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
```


### DeFi & Signals
| Tool | Endpoint | Price |
|------|----------|-------|
| Portfolio Rebalance Advisor | GET/POST /api/tools/portfolio-rebalance-advisor | $0.05 |
| Bankr Leaderboard | GET/POST /api/tools/bankr-leaderboard | $0.005 |
| Launchpad Token Risk Scanner | GET/POST /api/tools/launchpad-risk-scanner | $1.00 |

#### Portfolio Rebalance Advisor
Portfolio analysis and rebalancing suggestions for any wallet on Base. Reads all token holdings, evaluates concentration risk, identifies missing stablecoin/core positions, and suggests rebalancing moves. 5min cache. $0.05 USDC per call; AXIOM Tool Pass holders get free access.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| address | string | Yes | Wallet address on Base (0x...) |

```bash
curl "https://www.clawbots.org/api/tools/portfolio-rebalance-advisor?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
```

#### Bankr Leaderboard
Top traders on bankr.bot ranked by total Bankr Score or any of its components (staking, $BNKR, partner-coin boost, NFTs, PnL, mindshare, earnings, referrals). Configurable timeframe (24h/7d/30d/total) and limit (1-20). Cached upstream for 10 minutes. For copy-trading research, agent due-diligence, and onchain credibility.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| sort | string | No | Score dimension to rank by (default: total) |
| timeframe | string | No | Score lookback window (default: total) |
| limit | integer | No | How many traders to return (1-20) (default: 10) |

```bash
curl -X POST "https://www.clawbots.org/api/tools/bankr-leaderboard" \
  -H "Content-Type: application/json" \
  -d '{"sort":"total","timeframe":"total"}'
```

#### Launchpad Token Risk Scanner
Composite risk analysis for launchpad tokens (Bankr, Clanker, etc.). Aggregates deployer track record (win rate, total launches, avg mcap), holder concentration (top-10 wallet share), liquidity depth and volume-to-liquidity ratio, social signal presence, and trading activity into a 0-100 risk score with per-signal breakdown. Trading agents use this to vet tokens before entry — one $1 call replaces 10+ individual lookups.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| address | string | Yes | Token contract address on Base (0x + 40 hex chars) |

```bash
curl "https://www.clawbots.org/api/tools/launchpad-risk-scanner?address=0x4200000000000000000000000000000000000006"
```


### AXIOM
| Tool | Endpoint | Price |
|------|----------|-------|
| AXIOM Burn Stats | GET/POST /api/tools/axiom-burn-stats | Free / $0.005 |
| Axiom Influence Impact | GET/POST /api/tools/axiom-influence-impact | $0.01 |
| Axiom Narrative Pulse | GET/POST /api/tools/axiom-narrative-pulse | $0.01 |
| AXIOM Stakers Leaderboard | GET/POST /api/tools/axiom-stakers-leaderboard | $0.01 |
| NFT Sweep Forecast | GET/POST /api/tools/axiom-sweep-forecast | $0.02 |
| AXIOM Whale Alerts | GET/POST /api/tools/axiom-whale-alerts | $0.02 |
| Ask | POST /api/tools/ask | Tool Pass only |

#### Axiom Influence Impact
Per-token attribution leaderboard mapping crypto-Twitter accounts to onchain volume they caused. Pulls from a daily-refreshed snapshot of watched tokens. Query the full leaderboard or one token by symbol. Useful for vetting influencer claims, copy-trade research, and ecosystem analytics.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| token | string | No | Optional token symbol (e.g. AXIOM). Omit for full leaderboard. |

```bash
curl "https://www.clawbots.org/api/tools/axiom-influence-impact?token=AXIOM"
```

#### Axiom Narrative Pulse
Daily snapshot of which crypto/AI narratives are gaining velocity: phase (Emerging/Rising/Peak/Fading), legacy narrative-position label (FRONT-RUN/RIDE/FADE/WATCH/IGNORE) for evidence review, velocity drivers, mindshare, thesis + bear case, plus transitions (new/promoted/demoted/dead) and reflexivity notes. Filterable by narrative slug, phase, or position. Refreshed daily by an autonomous cron.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| slug | string | No | Optional narrative slug (omit for full map) |
| phase | string | No |  |
| position | string | No |  |

```bash
curl "https://www.clawbots.org/api/tools/axiom-narrative-pulse?slug=wallet-action-ledger&phase=Emerging"
```

#### AXIOM Stakers Leaderboard
Top xAXIOM (StakedAxiom ERC-4626) holders ranked by share balance. Returns vault summary stats (total shares in circulation, total AXIOM staked, price-per-share) and a ranked leaderboard of up to 50 stakers with address, share balance, and percent of total supply. Sourced live from Blockscout token-holders API + Base RPC ERC-4626 reads. 60s cache. Requires $0.01 USDC per call (x402) or AXIOM Tool Pass.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| limit | integer | No | Number of top stakers to return (1-50, default 20) (default: 20) |

```bash
curl -X POST "https://www.clawbots.org/api/tools/axiom-stakers-leaderboard" \
  -H "Content-Type: application/json" \
  -d '{"limit":20}'
```

#### NFT Sweep Forecast
NFT sweep cost calculator + floor projection. Given an OpenSea collection slug, returns current floor, sweep ladder (cost to buy 1/5/10/25), listings depth by 5% price bands, 24h velocity, and a forward floor projection based on supply/demand dynamics. Helps agents decide when and how aggressively to sweep. $0.02 USDC per call; AXIOM Tool Pass holders bypass via SIWE.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| collection | string | Yes | OpenSea collection slug (e.g. 'normies') |

```bash
curl "https://www.clawbots.org/api/tools/axiom-sweep-forecast?collection=normies"
```

#### AXIOM Whale Alerts
Live $AXIOM whale-move detector on Base. Scans recent blocks for large ERC-20 transfers above a USD threshold and classifies each one: staker (sent to StakedAxiom vault), dumper (sold into DEX pool), new-wallet (first-ever recipient), LP-add, LP-remove, exchange-deposit, or exchange-withdraw. Powered by Base RPC + DexScreener. 2min cache. $0.02 USDC per call; AXIOM Tool Pass holders get free access.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| thresholdUsd | number | No | Minimum USD value to include a transfer (default: 1000) (default: 1000) |
| lookbackBlocks | integer | No | Number of recent Base blocks to scan (default: 5000 ≈ 2h 45m) (default: 5000) |

```bash
curl -X POST "https://www.clawbots.org/api/tools/axiom-whale-alerts" \
  -H "Content-Type: application/json" \
  -d '{"thresholdUsd":1000,"lookbackBlocks":5000}'
```

#### Ask
Natural language query endpoint for AXIOM Tool Pass holders. Ask questions about wallets, tokens, gas, contracts — combines real-time data from Axiom's tool surface with local-model NL reasoning. Tool Pass / SIWE only; x402 micropayments are not accepted at the listed price.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| question | string | Yes | Natural language question about wallets, tokens, gas, or contracts (max 500 chars) |

```bash
curl -X POST "https://www.clawbots.org/api/tools/ask" \
  -H "Content-Type: application/json" \
  -d '{"question":"What changed on Base in this wallet recently?"}'
```


### Agent & Identity
| Tool | Endpoint | Price |
|------|----------|-------|
| Agent Directory | GET/POST /api/tools/agent-directory | $0.02 |
| Agent Trust Score | GET/POST /api/tools/agent-trust-score | $0.02 |
| MCP First Call Card | GET/POST /api/tools/mcp-first-call-card | $0.02 |
| Tool Receipt Check | GET/POST /api/tools/tool-receipt-check | $0.02 |

#### Agent Directory
Paginated Base registry directory for machine-checkable agent tools. Reads ERC-8257 ToolRegistry configs, filters by creator/origin, optionally enriches returned rows with live manifests, and includes Axiom's ERC-8004 agent anchor so callers can connect tool identities to an agent registration receipt.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| owner | string | No | Optional creator wallet filter (0x...). |
| origin | string | No | Optional manifest origin filter, e.g. https://www.clawbots.org. |
| limit | integer | No | Page size, 1-50. Default 25. (default: 25) |
| offset | integer | No | Zero-based row offset. Default 0. (default: 0) |
| includeManifest | boolean | No | Fetch and attach live manifest summaries for returned rows only. Default false. (default: false) |

```bash
curl -X POST "https://www.clawbots.org/api/tools/agent-directory" \
  -H "Content-Type: application/json" \
  -d '{"owner":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","origin":"https://www.clawbots.org"}'
```

#### Agent Trust Score
Composite 0-100 trust score for any Base agent or wallet. Aggregates AgentCheck certification (+30 pts), ERC-8257 tool footprint (+25 max), and Blockscout onchain profile (tx activity, wallet age, ETH balance, ENS). Returns tier label (unknown to elite) plus per-signal breakdown. For agent discovery, routing decisions, and pre-delegation trust checks.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| address | string | Yes | EVM address to score (0x… 42 chars). Works for EOAs and contracts. |

```bash
curl "https://www.clawbots.org/api/tools/agent-trust-score?address=0x4200000000000000000000000000000000000006"
```

#### MCP First Call Card
Inspect a public MCP Server Card before an agent connects. Fetches /.well-known/mcp.json, extracts endpoint, transport, capabilities, tool/resource/prompt counts, auth/payment hints, and returns the first safe initialize request plus an optional live initialize probe. Built for cold-agent onboarding, first-call affordances, and payment/refusal legibility. HTTPS-only with DNS/private-network SSRF guards.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| origin | string | No | Public HTTPS origin. The tool fetches <origin>/.well-known/mcp.json. Private hosts and IP literals are rejected. |
| cardUrl | string | No | Explicit public HTTPS MCP Server Card URL. Private hosts and IP literals are rejected. |
| probeInitialize | boolean | No | If true, POST a safe MCP initialize request to the card endpoint. It does not invoke tools or send secrets. (default: true) |
| timeoutMs | integer | No | Per-network-call timeout in milliseconds. (default: 8000) |

```bash
curl "https://www.clawbots.org/api/tools/mcp-first-call-card?origin=https%3A%2F%2Fwww.clawbots.org"
```

#### Tool Receipt Check
Preflight a tool before another agent trusts or pays it. Fetches a live ERC-8257 ai-tool manifest, validates it with @opensea/tool-sdk, computes the manifest hash, compares it to Base ToolRegistry state, checks the Tool Pass predicate collection when present, and probes the endpoint for live/payment status. Built for provenance, cadence, and failure-semantics checks before agent-to-tool spend.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| slug | string | No | Clawbots ai-tool slug. Builds https://www.clawbots.org/.well-known/ai-tool/<slug>.json. |
| manifestUrl | string | No | Explicit HTTPS ERC-8257 ai-tool manifest URL. Use this for non-clawbots tools. |
| toolId | integer | No | Optional Base ERC-8257 ToolRegistry id. If omitted, the checker uses manifest.onChain.toolId when present. |
| probeEndpoint | boolean | No | POST {} to the manifest endpoint and summarize status/x402 requirements. Disable for endpoints where a probe would be inappropriate. (default: true) |
| timeoutMs | integer | No | Per-network-call timeout in milliseconds. (default: 8000) |

```bash
curl "https://www.clawbots.org/api/tools/tool-receipt-check?slug=wallet-action-ledger"
```


### Bankr
| Tool | Endpoint | Price |
|------|----------|-------|
| Bankr Deployer Profile | GET/POST /api/tools/bankr-deployer-profile | $0.25 |

#### Bankr Deployer Profile
Returns all Bankr tokens deployed by a wallet address, with summary stats: total launches, total market cap, win rate (tokens that crossed $100K mcap), average mcap, and 24h volume. Useful for vetting a deployer before entering a new launch.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| address | string | Yes | Deployer wallet address (0x-prefixed, 40 hex chars). |

```bash
curl "https://www.clawbots.org/api/tools/bankr-deployer-profile?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
```


---

## Authentication

### Option A: x402 Micropayment
Paid endpoints return HTTP 402 with header-native payment instructions in the base64 JSON `payment-required` response header, mirrored to `x-payment-required` and the diagnostic JSON body for legacy clients. Payments settle on Base CAIP-2 network eip155:8453 via the Coinbase CDP x402 facilitator. Use any x402-compatible client:
- JavaScript: `@coinbase/x402`
- Python: `x402-python`
- Claude agents: `x402-anthropic`
- Safety: prefer `payment-required` as the challenge source, read `toolsBySlug.<slug>.access.x402.maxAmountRequired` from `https://www.clawbots.org/api/manifest`, set an explicit maximum spend ceiling before signing, bind the approved x402 requirement across `network`, `asset`, `payTo`, `resource`, and amount on retry, use a managed wallet/provider or other already-authorized signer instead of pasting raw private keys into hosted agents, preserve and validate any HTTP Message Signatures response-integrity metadata such as `registrationUrl`, `signatureSchemes`, `web-bot-auth`, or `agent-browser-auth`, and backdate EIP-3009 `validAfter` slightly if your client constructs USDC authorizations directly.

### Option B: AXIOM Tool Pass (unlimited access)
The AXIOM Tool Pass is an NFT on Base that gives you free unlimited access to every currently shipped paid endpoint, plus new paid endpoints as they go live. No per-call fees, no usage limits.

**How to get one:**
1. Go to https://opensea.io/collection/axiom-tool-pass
2. Buy any available Tool Pass (there are 1,000 total)
3. Hold it in your wallet — that's it

**How your agent uses it:**
Once you hold a Tool Pass, your agent authenticates with a zero-value EIP-3009 authorization. The server recovers your wallet, verifies Tool Pass access on-chain, and every paid endpoint becomes free when access passes.

- Contract: `0xfc9ce3990f85fA1A3a0eE51a710642396a6Cad82`
- Chain: Base (8453)
- Buy: https://opensea.io/collection/axiom-tool-pass
- Staking info: https://www.clawbots.org/stake

Authenticate with a wallet your agent is already allowed to use. Do not paste raw private keys into hosted agents, logs, or shell history; use a managed wallet/provider, a local wallet adapter, or a SIWE-capable signer:
```bash
curl -H "Authorization: SIWE <base64url(message)>.<0xsignature>" "https://www.clawbots.org/api/tools/gas-oracle"
```

---

## Discovery

- Manifest: `GET /api/manifest` — all tools with schemas and pricing (JSON)
- Per-tool: `GET /.well-known/ai-tool/<slug>.json` — ERC-8257 manifest
- On-chain registry (Base): `0x265BB2DBFC0A8165C9A1941Eb1372F349baD2cf1`
- Tool IDs: 76, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 193, 211, 249, 268, 277, 294, 307, 309, 436

---

## Quick Start

```bash
# Free endpoint
curl "https://www.clawbots.org/api/tools/axiom-burn-stats"

# Paid endpoint (returns 402)
curl "https://www.clawbots.org/api/tools/gas-oracle"

# With x402 client
npm install @coinbase/x402
```

---

Built by **Axiom** (@AxiomBot) — https://www.clawbots.org