# Axiom Tools — Agent Reference
# Fetch this file: curl https://www.clawbots.org/tools.llms.txt
# Human-readable page: https://www.clawbots.org/tools

Base URL: https://www.clawbots.org/api/tools

Catalog: 31 endpoints — 26 paid, 2 tiered, 3 free.
Pricing range: $0.002–$1 USDC per call.
On-chain: 31 of 31 registered on Base ERC-8257 ToolRegistry 0x265BB2DBFC0A8165C9A1941Eb1372F349baD2cf1.

---

# HOW TO USE THESE TOOLS

1. Make a standard HTTP GET or POST request to any endpoint URL below.
2. Free endpoints return data immediately.
3. Paid endpoints return HTTP 402 with a JSON body containing payment instructions.
4. To pay, use any x402-compatible client. The payment is USDC on Base, settled automatically.

---

# AUTHENTICATION (choose one)

## Option A: x402 Micropayment (pay per call)
Paid endpoints return HTTP 402 with payment details. Use an x402 client library:
- JavaScript: @coinbase/x402
- Python: x402-python
- Claude agents: x402-anthropic (wraps Anthropic SDK, auto-pays 402s)

Your agent makes the call, gets 402, the x402 client settles USDC on Base, retries with the payment header, gets the data. No human in the loop.

## Option B: AXIOM Tool Pass + SIWE (unlimited access)
Hold an AXIOM Tool Pass NFT on Base. 1,000 supply, minted out — available on secondary.

Contract: 0xfc9ce3990f85fA1A3a0eE51a710642396a6Cad82
Chain: Base (chain ID 8453)
Buy: https://opensea.io/collection/axiom-tool-pass

How it works (SIWE — Sign In With Ethereum):
1. Your agent wallet holds a Tool Pass NFT.
2. Call any endpoint. If paid, you get a 402 response.
3. Use @opensea/tool-sdk to authenticate:
   npx tool-sdk pay --auth siwe "<endpoint-url>" --wallet-provider private-key
4. tool-sdk creates a SIWE message, signs it with your wallet, and sends it as:
   Authorization: SIWE <base64url(message)>.<signature>
5. The server verifies the signature, recovers your wallet, checks Tool Pass balance on-chain.
6. If you hold a Tool Pass, access is granted WITHOUT charging USDC.

Programmatic (no CLI):
  import { authenticatedFetch } from '@opensea/tool-sdk';
  import { privateKeyToAccount } from 'viem/accounts';
  const account = privateKeyToAccount('0x...');
  const res = await authenticatedFetch(url, { account, method: 'POST' });

31 of 31 tools have their ERC721OwnerPredicate set on-chain via the ERC-8257 registry. tool-sdk's built-in predicate gate recognizes Tool Pass holders automatically for those tools. The remaining 0 accept Tool Pass auth at the application layer.

This means an agent can buy a Tool Pass once and get unlimited access to every endpoint — current and future — with no per-call payment.

---

# DISCOVERY

GET https://www.clawbots.org/api/manifest — returns all tools with schemas, pricing, and endpoint URLs (JSON).
GET https://www.clawbots.org/.well-known/ai-tool/<slug>.json — per-tool ERC-8257 manifest.
GET https://www.clawbots.org/.well-known/mcp.json — MCP server card.
GET https://www.clawbots.org/.well-known/agent-registration.json — ERC-8004 agent registration.

On-chain registry (ERC-8257 on Base): 0x265BB2DBFC0A8165C9A1941Eb1372F349baD2cf1
ERC-8004 agent ID: 1183 on registry 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
Use @opensea/tool-sdk to inspect: npx @opensea/tool-sdk inspect --tool-id <id> --network base

---

# ENDPOINTS

## Collection Stats
- Endpoint: GET/POST https://www.clawbots.org/api/tools/collection-stats
- Price: $0.02 USDC
- Category: NFT & Agents
- On-chain: ERC-8257 ToolId 18
- Tags: opensea, nft, collection, floor, volume, base
- Description: 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.

## Contract Safety Scanner
- Endpoint: GET/POST https://www.clawbots.org/api/tools/contract-safety-scanner
- Price: $0.10 USDC (or free with Tool Pass)
- Category: Security
- On-chain: ERC-8257 ToolId 21
- Tags: contract, security, audit, base, proxy-detection
- Description: 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.

## NFT Collection Intel
- Endpoint: GET/POST https://www.clawbots.org/api/tools/nft-collection-intel
- Price: $0.03 USDC (or free with Tool Pass)
- Category: NFT & Agents
- On-chain: ERC-8257 ToolId 23
- Tags: nft, collection, floor-price, opensea, analytics, base
- Description: 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.

## NFT Holder Overlap
- Endpoint: GET/POST https://www.clawbots.org/api/tools/nft-holder-overlap
- Price: $0.05 USDC
- Category: NFT & Agents
- On-chain: ERC-8257 ToolId 61
- Tags: opensea, nft, holders, overlap, analysis, airdrop, community
- Description: 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.

## rarity-rank
- Endpoint: GET/POST https://www.clawbots.org/api/tools/rarity-rank
- Price: $0.03 USDC
- Category: NFT & Agents
- On-chain: ERC-8257 ToolId 56
- Tags: opensea, nft, rarity, traits, ethereum, base
- Description: 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.

## Sweep Quote
- Endpoint: GET/POST https://www.clawbots.org/api/tools/sweep-quote
- Price: $0.03 USDC
- Category: NFT & Agents
- On-chain: ERC-8257 ToolId 19
- Tags: opensea, nft, sweep, floor, trading, base
- Description: 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.

## trait-floor
- Endpoint: GET/POST https://www.clawbots.org/api/tools/trait-floor
- Price: $0.03 USDC
- Category: NFT & Agents
- On-chain: ERC-8257 ToolId 57
- Tags: opensea, nft, floor, trait, rarity, pricing
- Description: 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.

## wallet-holdings
- Endpoint: GET/POST https://www.clawbots.org/api/tools/wallet-holdings
- Price: $0.05 USDC
- Category: NFT & Agents
- On-chain: ERC-8257 ToolId 58
- Tags: opensea, nft, portfolio, wallet, holdings, appraisal
- Description: 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.

## AXIOM Burn Stats
- Endpoint: GET/POST https://www.clawbots.org/api/tools/axiom-burn-stats
- Price: Free / $0.005 USDC (or free with Tool Pass)
- Category: AXIOM
- On-chain: ERC-8257 ToolId 9
- Tags: axiom, base, burn, token-stats, free
- Description: Live $AXIOM burn stats on Base — total burned, percent of supply, recent burn events. 30 s cache. Free tier returns aggregates; AXIOM Tool Pass holders (SIWE) or x402 micropayments unlock the recentBurns array (last 20 burn txs from Blockscout).

## Axiom Influence Impact
- Endpoint: GET/POST https://www.clawbots.org/api/tools/axiom-influence-impact
- Price: $0.01 USDC
- Category: AXIOM
- On-chain: ERC-8257 ToolId 11
- Tags: axiom, base, attribution, crypto-twitter, x402
- Description: 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.

## Axiom Narrative Pulse
- Endpoint: GET/POST https://www.clawbots.org/api/tools/axiom-narrative-pulse
- Price: $0.01 USDC (or free with Tool Pass)
- Category: AXIOM
- On-chain: ERC-8257 ToolId 10
- Tags: axiom, base, narratives, market-signal, x402
- Description: Daily snapshot of which crypto/AI narratives are gaining velocity: phase (Emerging/Rising/Peak/Fading), position call (FRONT-RUN/RIDE/FADE/WATCH/IGNORE), 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.

## AXIOM Stakers Leaderboard
- Endpoint: GET/POST https://www.clawbots.org/api/tools/axiom-stakers-leaderboard
- Price: $0.01 USDC (or free with Tool Pass)
- Category: AXIOM
- On-chain: ERC-8257 ToolId 17
- Tags: axiom, base, staking, xaxiom, leaderboard, erc4626
- Description: 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.

## AXIOM Whale Alerts
- Endpoint: GET/POST https://www.clawbots.org/api/tools/axiom-whale-alerts
- Price: $0.02 USDC (or free with Tool Pass)
- Category: AXIOM
- On-chain: ERC-8257 ToolId 60
- Tags: axiom, base, whale, token-analytics, transfers, staking
- Description: 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.

## Ask
- Endpoint: POST https://www.clawbots.org/api/tools/ask
- Price: Tool Pass only (or free with Tool Pass)
- Category: AXIOM
- On-chain: ERC-8257 ToolId 20
- Tags: axiom, nlp, multi-tool, tool-pass-only
- Description: 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.

## ENS Resolver
- Endpoint: GET/POST https://www.clawbots.org/api/tools/ens-resolver
- Price: Free
- Category: Infrastructure
- On-chain: ERC-8257 ToolId 27
- Tags: ens, ethereum, identity, resolver, address, free
- Description: 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.

## Gas Oracle
- Endpoint: GET/POST https://www.clawbots.org/api/tools/gas-oracle
- Price: $0.01 USDC (or free with Tool Pass)
- Category: Infrastructure
- On-chain: ERC-8257 ToolId 22
- Tags: gas, oracle, base, timing, fees
- Description: Base chain gas oracle with timing recommendations. Returns current gas price, base fee, block utilization, priority fee suggestions (slow/normal/fast), recent-block aggregates, trend, and a best-time-to-transact heuristic. 15s cache. $0.01 USDC per call; AXIOM Tool Pass holders bypass via SIWE.

## Portfolio Rebalance Advisor
- Endpoint: GET/POST https://www.clawbots.org/api/tools/portfolio-rebalance-advisor
- Price: $0.05 USDC (or free with Tool Pass)
- Category: DeFi
- On-chain: ERC-8257 ToolId 24
- Tags: portfolio, rebalance, defi, base, risk-management
- Description: 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.

## Token Due Diligence
- Endpoint: GET/POST https://www.clawbots.org/api/tools/token-due-diligence
- Price: $0.05 USDC (or free with Tool Pass)
- Category: Security
- On-chain: ERC-8257 ToolId 25
- Tags: token, due-diligence, safety, base, defi
- Description: 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.

## TX Decoder
- Endpoint: GET/POST https://www.clawbots.org/api/tools/tx-decoder
- Price: Free
- Category: Blockchain
- On-chain: ERC-8257 ToolId 42
- Tags: base, transaction, decoder, evm, token-transfers, debug
- Description: 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.

## Wallet Risk Score
- Endpoint: GET/POST https://www.clawbots.org/api/tools/wallet-risk-score
- Price: $0.05 USDC (or free with Tool Pass)
- Category: Security
- On-chain: ERC-8257 ToolId 26
- Tags: wallet, risk, trust, base, security
- Description: 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.

## Wallet Profile
- Endpoint: GET/POST https://www.clawbots.org/api/tools/wallet-profile
- Price: $0.02 USDC (or free with Tool Pass)
- Category: Base
- On-chain: ERC-8257 ToolId 59
- Tags: wallet, profile, ens, tokens, nft, base, identity
- Description: 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.

## Token Safety Check
- Endpoint: GET/POST https://www.clawbots.org/api/tools/token-safety
- Price: $0.02 USDC
- Category: Base
- On-chain: ERC-8257 ToolId 62
- Tags: security, token, honeypot, safety, goplus, pre-trade, agent
- Description: 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.

## ERC-20 Holder Overlap
- Endpoint: GET/POST https://www.clawbots.org/api/tools/erc20-holder-overlap
- Price: $0.05 USDC
- Category: Base
- On-chain: ERC-8257 ToolId 63
- Tags: erc20, token, holders, overlap, analysis, airdrop, base
- Description: 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.

## Token Info
- Endpoint: GET/POST https://www.clawbots.org/api/tools/token-info
- Price: $0.02 USDC (or free with Tool Pass)
- Category: Base
- On-chain: ERC-8257 ToolId 104
- Tags: token, erc20, base, metadata, holders, supply, price
- Description: 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.

## Normie Identity
- Endpoint: GET/POST https://www.clawbots.org/api/tools/normie-identity
- Price: Free / $0.002 USDC (or free with Tool Pass)
- Category: Identity
- On-chain: ERC-8257 ToolId 16
- Tags: normies, nft, identity, persona, erc-8004, agent, x402, base
- Description: 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.

## Agent Binding Scout
- Endpoint: GET/POST https://www.clawbots.org/api/tools/agent-binding-scout
- Price: $0.01 USDC (or free with Tool Pass)
- Category: NFT & Agents
- On-chain: ERC-8257 ToolId 14
- Tags: nft, agent-binding, erc-8217, erc-8004, opensea, discovery, x402, base
- Description: 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).

## Agent Cert Check
- Endpoint: GET/POST https://www.clawbots.org/api/tools/agent-cert-check
- Price: Free
- Category: Security
- On-chain: ERC-8257 ToolId 40
- Tags: agent, cert, trust, agentcheck, base, free
- Description: 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.

## Agent Trust Score
- Endpoint: GET/POST https://www.clawbots.org/api/tools/agent-trust-score
- Price: $0.02 USDC
- Category: Agent
- On-chain: ERC-8257 ToolId 64
- Tags: agent, trust, erc-8257, agentcheck, reputation, scoring, base, x402
- Description: 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.

## Bankr Leaderboard
- Endpoint: GET/POST https://www.clawbots.org/api/tools/bankr-leaderboard
- Price: $0.005 USDC (or free with Tool Pass)
- Category: DeFi
- On-chain: ERC-8257 ToolId 12
- Tags: bankr, base, leaderboard, traders, x402
- Description: 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.

## Bankr Deployer Profile
- Endpoint: GET/POST https://www.clawbots.org/api/tools/bankr-deployer-profile
- Price: $0.25 USDC
- Category: Bankr
- On-chain: ERC-8257 ToolId 75
- Tags: bankr, deployer, token, risk, base
- Description: 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.

## Launchpad Token Risk Scanner
- Endpoint: GET/POST https://www.clawbots.org/api/tools/launchpad-risk-scanner
- Price: $1.00 USDC
- Category: DeFi
- On-chain: ERC-8257 ToolId 76
- Tags: bankr, launchpad, risk, token, due-diligence, base, defi
- Description: 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.

---

# ON-CHAIN REGISTRY

31 of 31 tools are registered on the ERC-8257 Tool Registry on Base.
Registry contract: 0x265BB2DBFC0A8165C9A1941Eb1372F349baD2cf1
Registered Tool IDs: 9 (axiom-burn-stats), 10 (axiom-narrative-pulse), 11 (axiom-influence-impact), 12 (bankr-leaderboard), 14 (agent-binding-scout), 16 (normie-identity), 17 (axiom-stakers-leaderboard), 18 (collection-stats), 19 (sweep-quote), 20 (ask), 21 (contract-safety-scanner), 22 (gas-oracle), 23 (nft-collection-intel), 24 (portfolio-rebalance-advisor), 25 (token-due-diligence), 26 (wallet-risk-score), 27 (ens-resolver), 40 (agent-cert-check), 42 (tx-decoder), 56 (rarity-rank), 57 (trait-floor), 58 (wallet-holdings), 59 (wallet-profile), 60 (axiom-whale-alerts), 61 (nft-holder-overlap), 62 (token-safety), 63 (erc20-holder-overlap), 64 (agent-trust-score), 75 (bankr-deployer-profile), 76 (launchpad-risk-scanner), 104 (token-info)

The remaining 0 tool(s) are served from the same endpoint surface but are not yet listed on-chain. Tool Pass auth still works for them at the application layer.

Verify any registered tool: npx @opensea/tool-sdk inspect --tool-id <id> --network base

---

# QUICK START FOR AGENTS

Step 1: Try the free endpoint to confirm connectivity.
  curl "https://www.clawbots.org/api/tools/ens-resolver?items=vitalik.eth"

Step 2: Try a paid endpoint to see the 402 response.
  curl "https://www.clawbots.org/api/tools/gas-oracle"
  (Returns 402 with payment instructions)

Step 3: Install x402 client and make a paid call.
  npm install @coinbase/x402
  (See x402 docs for integration)

Step 4 (optional): Buy a Tool Pass for unlimited access.
  Go to https://opensea.io/collection/axiom-tool-pass
  After purchase, all paid endpoints become free for your wallet.

---

# UPDATES

This file is generated from https://www.clawbots.org/tools-data.json (built from the canonical tool registry via scripts/generate-tool-surfaces.mjs). Re-fetch periodically to pick up new endpoints.
Last updated: 2026-06-06