# 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

---

# HOW TO USE THESE TOOLS

1. Make a standard HTTP GET 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' });

All 17 tools have ERC721OwnerPredicate set on-chain via the ERC-8257 registry (ens-resolver is free, no predicate needed). tool-sdk's built-in predicate gate recognizes Tool Pass holders automatically.

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/tools/../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.

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

---

# ENDPOINTS

## Wallet Risk Score
- Endpoint: GET https://www.clawbots.org/api/tools/wallet-risk-score?address=0x...
- Price: $0.05 USDC (or free with Tool Pass)
- Category: Infrastructure
- Description: Risk scoring for agent-to-agent trust decisions. Analyzes wallet age, tx history, known labels, token diversity, and NFT holdings to produce a 0-100 risk score on Base.
- Example: curl "https://www.clawbots.org/api/tools/wallet-risk-score?address=0x..."

## Token Due Diligence
- Endpoint: GET https://www.clawbots.org/api/tools/token-due-diligence?token=0x...
- Price: $0.05 USDC (or free with Tool Pass)
- Category: Infrastructure
- Description: Token safety analysis for agents considering a buy. Checks holder concentration, liquidity depth, contract verification, deployer history, and red flags.
- Example: curl "https://www.clawbots.org/api/tools/token-due-diligence?token=0x..."

## Contract Safety Scanner
- Endpoint: GET https://www.clawbots.org/api/tools/contract-safety-scanner?contract=0x...
- Price: $0.10 USDC (or free with Tool Pass)
- Category: Infrastructure
- Description: Smart contract risk analysis on Base. Checks verification status, proxy patterns, admin/owner functions, known exploit signatures, and code quality indicators.
- Example: curl "https://www.clawbots.org/api/tools/contract-safety-scanner?contract=0x..."

## Gas Oracle
- Endpoint: GET https://www.clawbots.org/api/tools/gas-oracle
- Price: $0.01 USDC (or free with Tool Pass)
- Category: Infrastructure
- Description: Base chain gas prices with timing recommendations. Returns current gas, L1 data fee estimate, historical averages, and best-time-to-transact heuristics.

## Portfolio Advisor
- Endpoint: GET https://www.clawbots.org/api/tools/portfolio-rebalance-advisor?address=0x...
- Price: $0.05 USDC (or free with Tool Pass)
- Category: Infrastructure
- Description: Portfolio analysis and rebalancing suggestions for any Base wallet. Reads token holdings, evaluates concentration risk, and suggests optimal rebalancing moves.
- Example: curl "https://www.clawbots.org/api/tools/portfolio-rebalance-advisor?address=0x..."

## Ask (NL Query)
- Endpoint: POST https://www.clawbots.org/api/tools/ask (body: {"question":"..."})
- Price: Tool Pass only USDC (or free with Tool Pass)
- Category: Infrastructure
- Description: Natural language query endpoint. Ask questions about wallets, tokens, gas, contracts — combines real-time tool data with NL reasoning. Tool Pass holders only.
- Example: curl "https://www.clawbots.org/api/tools/ask (body: {"question":"..."})"

## ENS Resolver
- Endpoint: GET https://www.clawbots.org/api/tools/ens-resolver?items=vitalik.eth,0xd8dA...
- Price: Free
- Category: Infrastructure
- Description: Batch ENS name/address resolution on Ethereum mainnet. Forward: .eth name → address. Reverse: address → primary ENS name. Avatar URL included. Up to 20 items per request. Free.
- Example: curl "https://www.clawbots.org/api/tools/ens-resolver?items=vitalik.eth,0xd8dA..."

## Collection Stats
- Endpoint: GET https://www.clawbots.org/api/tools/collection-stats?slug=normies
- Price: $0.02 USDC (or free with Tool Pass)
- Category: NFT & Agents
- Description: Collection health snapshot from OpenSea: floor, 24h volume, owner count/distribution, creator royalty vs protocol fee split, and top-5 live bids. Multi-slug compare supported.
- Example: curl "https://www.clawbots.org/api/tools/collection-stats?slug=normies"

## Sweep Quote
- Endpoint: GET https://www.clawbots.org/api/tools/sweep-quote?slug=normies&budget=5
- Price: $0.03 USDC (or free with Tool Pass)
- Category: NFT & Agents
- Description: Quote a real NFT sweep cost. Walks up the OpenSea listing curve, deduplicates by token ID, returns count + cost + slippage for a given ETH budget.
- Example: curl "https://www.clawbots.org/api/tools/sweep-quote?slug=normies&budget=5"

## NFT Collection Intel
- Endpoint: GET https://www.clawbots.org/api/tools/nft-collection-intel?collection=normies&chain=ethereum
- Price: $0.03 USDC (or free with Tool Pass)
- Category: NFT & Agents
- Description: Collection analytics via OpenSea: floor price, holder distribution, listing velocity, wash trading indicators, and sweep probability.
- Example: curl "https://www.clawbots.org/api/tools/nft-collection-intel?collection=normies&chain=ethereum"

## Agent Binding Scout
- Endpoint: GET https://www.clawbots.org/api/tools/agent-binding-scout?collection=normies&chain=ethereum&limit=5
- Price: $0.01 USDC (or free with Tool Pass)
- Category: NFT & Agents
- Description: Discovery for ERC-8217 agent-bound NFTs in any OpenSea collection. Returns NFTs with active agent bindings, enriched with the full binding payload.
- Example: curl "https://www.clawbots.org/api/tools/agent-binding-scout?collection=normies&chain=ethereum&limit=5"

## Normie Identity
- Endpoint: GET https://www.clawbots.org/api/tools/normie-identity?tokenId=7593
- Price: Free / $0.002
- Category: NFT & Agents
- Description: Normie NFT persona lookup by token ID. Free tier: name, type, traits. Paid tier ($0.002): full agent persona with backstory, personality, greeting, communication style.
- Example: curl "https://www.clawbots.org/api/tools/normie-identity?tokenId=7593"

## Narrative Pulse
- Endpoint: GET https://www.clawbots.org/api/tools/axiom-narrative-pulse?phase=&position=
- Price: $0.01 USDC (or free with Tool Pass)
- Category: Signals
- Description: Daily crypto/AI narrative map. Each narrative gets a phase, velocity arrow, named drivers, and a position call.
- Example: curl "https://www.clawbots.org/api/tools/axiom-narrative-pulse?phase=&position="

## Influence Impact
- Endpoint: GET https://www.clawbots.org/api/tools/axiom-influence-impact?token=AXIOM
- Price: $0.01 USDC (or free with Tool Pass)
- Category: Signals
- Description: Which CT accounts posts correlate with the largest onchain volume spikes for a Base token. Ranks by USD volume attributed per post.
- Example: curl "https://www.clawbots.org/api/tools/axiom-influence-impact?token=AXIOM"

## Bankr Leaderboard
- Endpoint: GET https://www.clawbots.org/api/tools/bankr-leaderboard?sort=total&timeframe=7d&limit=10
- Price: $0.005 USDC (or free with Tool Pass)
- Category: Signals
- Description: Top traders on bankr.bot ranked by Bankr Score or any component dimension. Useful for copy-trading research and agent credibility lookups.
- Example: curl "https://www.clawbots.org/api/tools/bankr-leaderboard?sort=total&timeframe=7d&limit=10"

## Burn Stats
- Endpoint: GET https://www.clawbots.org/api/tools/axiom-burn-stats
- Price: Free
- Category: AXIOM
- Description: Live $AXIOM burn data from Base. Total burned, percent of supply, and recent burn transactions.

## Stakers Leaderboard
- Endpoint: GET https://www.clawbots.org/api/tools/axiom-stakers-leaderboard?limit=20
- Price: $0.01 USDC (or free with Tool Pass)
- Category: AXIOM
- Description: Top xAXIOM stakers ranked by share balance. Includes vault summary and per-staker share breakdown.
- Example: curl "https://www.clawbots.org/api/tools/axiom-stakers-leaderboard?limit=20"

---

# ON-CHAIN REGISTRY

All tools are registered on the ERC-8257 Tool Registry on Base.
Registry contract: 0x265BB2DBFC0A8165C9A1941Eb1372F349baD2cf1
Tool IDs: 9 (burn-stats), 10 (narrative-pulse), 11 (influence-impact), 12 (bankr-leaderboard), 14 (agent-binding-scout), 16 (normie-identity), 17 (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)

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

---

# QUICK START FOR AGENTS

Step 1: Try a free endpoint to confirm connectivity.
  curl "https://www.clawbots.org/api/tools/axiom-burn-stats"

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 clawbots.org/tools. Re-fetch it periodically to pick up new endpoints.
Last updated: 2026-05-29