# 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: 41 endpoints — 37 priced x402, 1 pass-only, 2 tiered, 3 free.
Pricing range: $0.002–$1 USDC per call.
On-chain: 41 of 41 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 mainnet (eip155:8453), verified and settled by the Coinbase CDP x402 facilitator (https://api.cdp.coinbase.com/platform/v2/x402).

---

# 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.

Buyer safety guardrails:
- Read maxAmountRequired from https://www.clawbots.org/api/manifest at toolsBySlug.<slug>.access.x402.maxAmountRequired before signing.
- Set an explicit maximum spend ceiling in your x402 client that covers the expected quote and rejects higher quotes.
- Bind the approved x402 requirement into the retry signature: network, asset, payTo, resource, and amount must still match after any 402 re-read.
- Use a managed wallet/provider, browser wallet, or local signer your agent is already authorized to use. Do not paste raw private keys into hosted agents, logs, source files, or shell history.
- If the 402 envelope or facilitator response advertises HTTP Message Signatures, registrationUrl, signatureSchemes, web-bot-auth, or agent-browser-auth, preserve those response-integrity fields, validate advertised signature coverage when supported, and fail closed on missing or inconsistent metadata.
- If constructing USDC EIP-3009 authorization fields directly, backdate validAfter by a small clock-skew window. Base compares validAfter with block timestamp, not your agent's wall clock.

## Option B: AXIOM Tool Pass auth (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:
1. Your agent wallet holds a Tool Pass NFT.
2. Call any endpoint. If paid, you get a 402 response.
3. Authenticate with either Authorization: SIWE <base64url(message)>.<0xsignature> or @opensea/tool-sdk's zero-value EIP-3009 proof.
4. The server recovers your wallet, checks Tool Pass access on-chain, and skips per-call payment when access passes.
5. If you hold a Tool Pass, access is granted WITHOUT charging USDC.

Pass-only tools, such as ask, still return HTTP 402 when unauthenticated. That 402 is an identity challenge, not a paid quote: accepts[0].maxAmountRequired is "0" on eip155:8453, so @opensea/tool-sdk can attach a zero-value EIP-3009 x-payment proof before the server checks Tool Pass ownership.

Programmatic (SIWE header):
  Authorization: SIWE <base64url(message)>.<0xsignature>

Programmatic signer boundary:
  Use a managed wallet/provider, browser wallet, or local signer your agent is already authorized to use.
  Do not paste raw private keys into hosted agents, logs, source files, or shell history.
  Attach either Authorization: SIWE <base64url(message)>.<0xsignature> or a zero-value EIP-3009 proof from an approved wallet provider, then retry the same endpoint.

41 of 41 tools have their ERC721OwnerPredicate set on-chain via the ERC-8257 registry. tool-sdk's built-in predicate gate recognizes Tool Pass holders for the full catalog.

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, endpoint URLs, executable call examples, stats, and lookup maps.
Resolve by slug: toolsBySlug.<slug>.
Resolve by ERC-8257 id: toolsByOnChainId.<toolId>.
For paid tools, read access.x402 for network eip155:8453, facilitator provider/URL, verify/settle paths, responseIntegrity metadata, price, and Tool Pass SIWE metadata beside the call envelope.
For pass-only tools, read access.identityProof for the zero-value x-payment identity challenge and access.toolPass for the holder predicate.
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
- Slug: collection-stats
- Endpoint: GET/POST https://www.clawbots.org/api/tools/collection-stats
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/collection-stats.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/collection-stats?slug=wallet-action-ledger'
- Price: $0.02 USDC
- Category: NFT & Agents
- On-chain: ERC-8257 #112 (ToolId 112)
- 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
- Slug: contract-safety-scanner
- Endpoint: GET/POST https://www.clawbots.org/api/tools/contract-safety-scanner
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/contract-safety-scanner.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/contract-safety-scanner?address=0x4200000000000000000000000000000000000006'
- Price: $0.10 USDC (or free with Tool Pass)
- Category: Security
- On-chain: ERC-8257 #115 (ToolId 115)
- 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
- Slug: nft-collection-intel
- Endpoint: GET/POST https://www.clawbots.org/api/tools/nft-collection-intel
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/nft-collection-intel.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/nft-collection-intel?slug=wallet-action-ledger'
- Price: $0.03 USDC (or free with Tool Pass)
- Category: NFT & Agents
- On-chain: ERC-8257 #117 (ToolId 117)
- 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
- Slug: nft-holder-overlap
- Endpoint: GET/POST https://www.clawbots.org/api/tools/nft-holder-overlap
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/nft-holder-overlap.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/nft-holder-overlap?collectionA=normies&collectionB=pudgypenguins'
- Price: $0.05 USDC
- Category: NFT & Agents
- On-chain: ERC-8257 #129 (ToolId 129)
- 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
- Slug: rarity-rank
- Endpoint: GET/POST https://www.clawbots.org/api/tools/rarity-rank
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/rarity-rank.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/rarity-rank?collection=normies&tokenId=1'
- Price: $0.03 USDC
- Category: NFT & Agents
- On-chain: ERC-8257 #124 (ToolId 124)
- 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
- Slug: sweep-quote
- Endpoint: GET/POST https://www.clawbots.org/api/tools/sweep-quote
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/sweep-quote.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/sweep-quote' -X POST -H 'content-type: application/json' -d '{"collection":"normies","budgetEth":1}'
- Price: $0.03 USDC
- Category: NFT & Agents
- On-chain: ERC-8257 #113 (ToolId 113)
- 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
- Slug: trait-floor
- Endpoint: GET/POST https://www.clawbots.org/api/tools/trait-floor
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/trait-floor.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/trait-floor' -X POST -H 'content-type: application/json' -d '{"collection":"normies","traits":[{"traitType":"Background","value":"Blue"}]}'
- Price: $0.03 USDC
- Category: NFT & Agents
- On-chain: ERC-8257 #125 (ToolId 125)
- 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
- Slug: wallet-holdings
- Endpoint: GET/POST https://www.clawbots.org/api/tools/wallet-holdings
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/wallet-holdings.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/wallet-holdings?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
- Price: $0.05 USDC
- Category: NFT & Agents
- On-chain: ERC-8257 #126 (ToolId 126)
- 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
- Slug: axiom-burn-stats
- Endpoint: GET/POST https://www.clawbots.org/api/tools/axiom-burn-stats
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/axiom-burn-stats.json
- Call example: curl -s '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 #105 (ToolId 105)
- 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
- Slug: axiom-influence-impact
- Endpoint: GET/POST https://www.clawbots.org/api/tools/axiom-influence-impact
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/axiom-influence-impact.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/axiom-influence-impact?token=AXIOM'
- Price: $0.01 USDC
- Category: AXIOM
- On-chain: ERC-8257 #107 (ToolId 107)
- 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
- Slug: axiom-narrative-pulse
- Endpoint: GET/POST https://www.clawbots.org/api/tools/axiom-narrative-pulse
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/axiom-narrative-pulse.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/axiom-narrative-pulse?slug=wallet-action-ledger&phase=Emerging'
- Price: $0.01 USDC (or free with Tool Pass)
- Category: AXIOM
- On-chain: ERC-8257 #106 (ToolId 106)
- 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
- Slug: axiom-stakers-leaderboard
- Endpoint: GET/POST https://www.clawbots.org/api/tools/axiom-stakers-leaderboard
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/axiom-stakers-leaderboard.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/axiom-stakers-leaderboard' -X POST -H 'content-type: application/json' -d '{"limit":20}'
- Price: $0.01 USDC (or free with Tool Pass)
- Category: AXIOM
- On-chain: ERC-8257 #111 (ToolId 111)
- 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.

## NFT Sweep Forecast
- Slug: axiom-sweep-forecast
- Endpoint: GET/POST https://www.clawbots.org/api/tools/axiom-sweep-forecast
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/axiom-sweep-forecast.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/axiom-sweep-forecast?collection=normies'
- Price: $0.02 USDC (or free with Tool Pass)
- Category: AXIOM
- On-chain: ERC-8257 #134 (ToolId 134)
- Tags: nft, opensea, sweep, floor, forecast, listings
- Description: 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.

## AXIOM Whale Alerts
- Slug: axiom-whale-alerts
- Endpoint: GET/POST https://www.clawbots.org/api/tools/axiom-whale-alerts
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/axiom-whale-alerts.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/axiom-whale-alerts' -X POST -H 'content-type: application/json' -d '{"thresholdUsd":1000,"lookbackBlocks":5000}'
- Price: $0.02 USDC (or free with Tool Pass)
- Category: AXIOM
- On-chain: ERC-8257 #128 (ToolId 128)
- 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
- Slug: ask
- Endpoint: POST https://www.clawbots.org/api/tools/ask
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/ask.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/ask' -X POST -H 'content-type: application/json' -d '{"question":"What changed on Base in this wallet recently?"}'
- Price: Tool Pass only (or free with Tool Pass)
- Category: AXIOM
- On-chain: ERC-8257 #114 (ToolId 114)
- 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.

## Base Ecosystem Radar
- Slug: base-ecosystem-radar
- Endpoint: GET/POST https://www.clawbots.org/api/tools/base-ecosystem-radar
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/base-ecosystem-radar.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/base-ecosystem-radar'
- Price: $0.03 USDC (or free with Tool Pass)
- Category: Base
- On-chain: ERC-8257 #193 (ToolId 193)
- Tags: base, ecosystem, trending, contracts, tokens, tvl, gas, radar
- Description: Real-time Base ecosystem intelligence. Returns new verified smart contracts (name, address, proxy status), top-15 tokens by holder count (price, volume, market cap), network stats (gas prices, total addresses, block time, TVL), and 14-day transaction trend chart. No input required. Powered by Blockscout. 5min cache. $0.03 USDC per call; AXIOM Tool Pass holders get free access.

## Contract ABI Inspector
- Slug: contract-abi-inspector
- Endpoint: GET/POST https://www.clawbots.org/api/tools/contract-abi-inspector
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/contract-abi-inspector.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/contract-abi-inspector?address=0x4200000000000000000000000000000000000006'
- Price: $0.02 USDC (or free with Tool Pass)
- Category: Base
- On-chain: ERC-8257 #277 (ToolId 277)
- Tags: base, contract, abi, verification, blockscout, preflight, proxy
- Description: 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.

## ENS Resolver
- Slug: ens-resolver
- Endpoint: GET/POST https://www.clawbots.org/api/tools/ens-resolver
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/ens-resolver.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/ens-resolver' -X POST -H 'content-type: application/json' -d '{"items":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"]}'
- Price: Free
- Category: Infrastructure
- On-chain: ERC-8257 #121 (ToolId 121)
- 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.

## ERC-20 Approval Audit
- Slug: erc20-approval-audit
- Endpoint: GET/POST https://www.clawbots.org/api/tools/erc20-approval-audit
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/erc20-approval-audit.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/erc20-approval-audit?owner=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
- Price: $0.03 USDC (or free with Tool Pass)
- Category: Base
- On-chain: ERC-8257 #268 (ToolId 268)
- Tags: base, erc20, approval, allowance, wallet, risk, preflight
- Description: 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.

## Gas Oracle
- Slug: gas-oracle
- Endpoint: GET/POST https://www.clawbots.org/api/tools/gas-oracle
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/gas-oracle.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/gas-oracle'
- Price: $0.01 USDC (or free with Tool Pass)
- Category: Infrastructure
- On-chain: ERC-8257 #116 (ToolId 116)
- 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
- Slug: portfolio-rebalance-advisor
- Endpoint: GET/POST https://www.clawbots.org/api/tools/portfolio-rebalance-advisor
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/portfolio-rebalance-advisor.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/portfolio-rebalance-advisor?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
- Price: $0.05 USDC (or free with Tool Pass)
- Category: DeFi
- On-chain: ERC-8257 #118 (ToolId 118)
- 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
- Slug: token-due-diligence
- Endpoint: GET/POST https://www.clawbots.org/api/tools/token-due-diligence
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/token-due-diligence.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/token-due-diligence?token=0x4200000000000000000000000000000000000006'
- Price: $0.05 USDC (or free with Tool Pass)
- Category: Security
- On-chain: ERC-8257 #119 (ToolId 119)
- 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
- Slug: tx-decoder
- Endpoint: GET/POST https://www.clawbots.org/api/tools/tx-decoder
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/tx-decoder.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/tx-decoder?hash=0x8e7d48c25768bec80dfeafd3cbe5c3b12df2d0b8f9786fa035e002b53d966ba0'
- Price: Free
- Category: Blockchain
- On-chain: ERC-8257 #123 (ToolId 123)
- 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
- Slug: wallet-risk-score
- Endpoint: GET/POST https://www.clawbots.org/api/tools/wallet-risk-score
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/wallet-risk-score.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/wallet-risk-score?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
- Price: $0.05 USDC (or free with Tool Pass)
- Category: Security
- On-chain: ERC-8257 #120 (ToolId 120)
- 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
- Slug: wallet-profile
- Endpoint: GET/POST https://www.clawbots.org/api/tools/wallet-profile
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/wallet-profile.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/wallet-profile?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
- Price: $0.02 USDC (or free with Tool Pass)
- Category: Base
- On-chain: ERC-8257 #127 (ToolId 127)
- 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.

## Wallet Action Ledger
- Slug: wallet-action-ledger
- Endpoint: GET/POST https://www.clawbots.org/api/tools/wallet-action-ledger
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/wallet-action-ledger.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/wallet-action-ledger?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
- Price: $0.02 USDC (or free with Tool Pass)
- Category: Base
- On-chain: ERC-8257 #309 (ToolId 309)
- Tags: base, wallet, transactions, receipt, activity, preflight, blockscout
- Description: 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.

## Token Safety Check
- Slug: token-safety
- Endpoint: GET/POST https://www.clawbots.org/api/tools/token-safety
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/token-safety.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/token-safety?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
- Price: $0.02 USDC
- Category: Base
- On-chain: ERC-8257 #130 (ToolId 130)
- 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
- Slug: erc20-holder-overlap
- Endpoint: GET/POST https://www.clawbots.org/api/tools/erc20-holder-overlap
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/erc20-holder-overlap.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/erc20-holder-overlap?tokenA=0x4200000000000000000000000000000000000006&tokenB=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
- Price: $0.05 USDC
- Category: Base
- On-chain: ERC-8257 #131 (ToolId 131)
- 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
- Slug: token-info
- Endpoint: GET/POST https://www.clawbots.org/api/tools/token-info
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/token-info.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/token-info?token=0x4200000000000000000000000000000000000006'
- Price: $0.02 USDC (or free with Tool Pass)
- Category: Base
- On-chain: ERC-8257 #104 (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.

## x402 Preflight
- Slug: x402-preflight
- Endpoint: GET/POST https://www.clawbots.org/api/tools/x402-preflight
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/x402-preflight.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/x402-preflight?url=https%3A%2F%2Fwww.clawbots.org%2Fapi%2Ftools%2Fgas-oracle'
- Price: $0.02 USDC (or free with Tool Pass)
- Category: Base
- On-chain: ERC-8257 #249 (ToolId 249)
- Tags: x402, base, payment, preflight, agent, safety
- Description: 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.

## x402 Cost Guard
- Slug: x402-cost-guard
- Endpoint: POST https://www.clawbots.org/api/tools/x402-cost-guard
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/x402-cost-guard.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/x402-cost-guard' -X POST -H 'content-type: application/json' -d '{"accepts":[{}]}'
- Price: $0.01 USDC (or free with Tool Pass)
- Category: Base
- On-chain: ERC-8257 #436 (ToolId 436)
- Tags: x402, budget, base, usdc, payment, guard
- Description: 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.

## Normie Identity
- Slug: normie-identity
- Endpoint: GET/POST https://www.clawbots.org/api/tools/normie-identity
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/normie-identity.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/normie-identity' -X POST -H 'content-type: application/json' -d '{"tokenId":1}'
- Price: Free / $0.002 USDC (or free with Tool Pass)
- Category: Identity
- On-chain: ERC-8257 #110 (ToolId 110)
- 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
- Slug: agent-binding-scout
- Endpoint: GET/POST https://www.clawbots.org/api/tools/agent-binding-scout
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/agent-binding-scout.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/agent-binding-scout?collection=normies'
- Price: $0.01 USDC (or free with Tool Pass)
- Category: NFT & Agents
- On-chain: ERC-8257 #109 (ToolId 109)
- 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
- Slug: agent-cert-check
- Endpoint: GET/POST https://www.clawbots.org/api/tools/agent-cert-check
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/agent-cert-check.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/agent-cert-check?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
- Price: Free
- Category: Security
- On-chain: ERC-8257 #122 (ToolId 122)
- 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 Directory
- Slug: agent-directory
- Endpoint: GET/POST https://www.clawbots.org/api/tools/agent-directory
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/agent-directory.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/agent-directory?owner=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&origin=https%3A%2F%2Fwww.clawbots.org'
- Price: $0.02 USDC (or free with Tool Pass)
- Category: Agent
- On-chain: ERC-8257 #211 (ToolId 211)
- Tags: agent, registry, erc-8257, erc-8004, base, directory, receipts
- Description: 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.

## Agent Trust Score
- Slug: agent-trust-score
- Endpoint: GET/POST https://www.clawbots.org/api/tools/agent-trust-score
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/agent-trust-score.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/agent-trust-score?address=0x4200000000000000000000000000000000000006'
- Price: $0.02 USDC
- Category: Agent
- On-chain: ERC-8257 #132 (ToolId 132)
- 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.

## MCP First Call Card
- Slug: mcp-first-call-card
- Endpoint: GET/POST https://www.clawbots.org/api/tools/mcp-first-call-card
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/mcp-first-call-card.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/mcp-first-call-card?origin=https%3A%2F%2Fwww.clawbots.org'
- Price: $0.02 USDC (or free with Tool Pass)
- Category: Agent
- On-chain: ERC-8257 #307 (ToolId 307)
- Tags: mcp, agent, server-card, first-call, preflight, x402, onboarding
- Description: 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.

## Tool Receipt Check
- Slug: tool-receipt-check
- Endpoint: GET/POST https://www.clawbots.org/api/tools/tool-receipt-check
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/tool-receipt-check.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/tool-receipt-check?slug=wallet-action-ledger'
- Price: $0.02 USDC (or free with Tool Pass)
- Category: Agent
- On-chain: ERC-8257 #294 (ToolId 294)
- Tags: agent, erc-8257, registry, manifest, provenance, x402, preflight, base
- Description: 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.

## Bankr Leaderboard
- Slug: bankr-leaderboard
- Endpoint: GET/POST https://www.clawbots.org/api/tools/bankr-leaderboard
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/bankr-leaderboard.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/bankr-leaderboard?sort=total&timeframe=total'
- Price: $0.005 USDC (or free with Tool Pass)
- Category: DeFi
- On-chain: ERC-8257 #108 (ToolId 108)
- 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
- Slug: bankr-deployer-profile
- Endpoint: GET/POST https://www.clawbots.org/api/tools/bankr-deployer-profile
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/bankr-deployer-profile.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/bankr-deployer-profile?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
- Price: $0.25 USDC
- Category: Bankr
- On-chain: ERC-8257 #133 (ToolId 133)
- 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
- Slug: launchpad-risk-scanner
- Endpoint: GET/POST https://www.clawbots.org/api/tools/launchpad-risk-scanner
- Manifest: GET https://www.clawbots.org/.well-known/ai-tool/launchpad-risk-scanner.json
- Call example: curl -s 'https://www.clawbots.org/api/tools/launchpad-risk-scanner?address=0x4200000000000000000000000000000000000006'
- Price: $1.00 USDC
- Category: DeFi
- On-chain: ERC-8257 #76 (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

41 of 41 tools are registered on the ERC-8257 Tool Registry on Base.
Registry contract: 0x265BB2DBFC0A8165C9A1941Eb1372F349baD2cf1
Registered Tool IDs: 76 (launchpad-risk-scanner), 104 (token-info), 105 (axiom-burn-stats), 106 (axiom-narrative-pulse), 107 (axiom-influence-impact), 108 (bankr-leaderboard), 109 (agent-binding-scout), 110 (normie-identity), 111 (axiom-stakers-leaderboard), 112 (collection-stats), 113 (sweep-quote), 114 (ask), 115 (contract-safety-scanner), 116 (gas-oracle), 117 (nft-collection-intel), 118 (portfolio-rebalance-advisor), 119 (token-due-diligence), 120 (wallet-risk-score), 121 (ens-resolver), 122 (agent-cert-check), 123 (tx-decoder), 124 (rarity-rank), 125 (trait-floor), 126 (wallet-holdings), 127 (wallet-profile), 128 (axiom-whale-alerts), 129 (nft-holder-overlap), 130 (token-safety), 131 (erc20-holder-overlap), 132 (agent-trust-score), 133 (bankr-deployer-profile), 134 (axiom-sweep-forecast), 193 (base-ecosystem-radar), 211 (agent-directory), 249 (x402-preflight), 268 (erc20-approval-audit), 277 (contract-abi-inspector), 294 (tool-receipt-check), 307 (mcp-first-call-card), 309 (wallet-action-ledger), 436 (x402-cost-guard)

All 41 tools are served from the same endpoint surface and listed on-chain.

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 -s "https://www.clawbots.org/api/tools/ens-resolver" -X POST -H 'content-type: application/json' -d '{"items":["vitalik.eth"]}'

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

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-08-24