npm.io
1.3.6 • Published yesterday

x402-agent-tools

Licence
MIT
Version
1.3.6
Deps
3
Size
95 kB
Vulns
0
Weekly
0
Stars
19
SummaryDependencyVersions

x402-agent-tools

100 production-ready AI agent tools with x402 micropayments. Pay-per-call USDC on Base. Zero API keys. Zero subscriptions. Just a wallet.

The largest collection of x402-compatible tools for autonomous AI agents. Built for LangChain, Vercel AI SDK, CrewAI, AutoGPT, and any agent framework that supports tool calling.

3-17x cheaper than StableEnrich, httpay, BlockRun, and Nansen. Same data. Fraction of the cost. See benchmark.

Why x402-agent-tools?

Feature x402-agent-tools StableEnrich httpay BlockRun
Tools available 103 ~12 ~8 ~15
Avg price/call $0.003 $0.01-0.05 $0.01-0.03 $0.01-0.05
API keys needed None Yes Yes Yes
Subscription None Monthly Monthly Monthly
Hyperliquid data 7 APIs 0 0 0
Prediction markets 2 APIs 0 0 0
Payment USDC on Base USDC USDC USDC
Framework support LangChain, AI SDK Custom Custom Custom

Install

npm install x402-agent-tools @x402/fetch @x402/evm viem

Quick Start — 3 Lines to Your First Call

import { createClient } from "x402-agent-tools";

const client = createClient("0xYourPrivateKey");

// Crypto: whale positions on Hyperliquid
const whales = await client.call("hyperliquid_whales", { coin: "BTC" });

// B2B: enrich a company from domain
const company = await client.call("company_enrichment", { domain: "stripe.com" });

// Security: trust score any domain
const trust = await client.call("trust_score", { target: "example.com" });

// DeFi: best bridge route across 60+ chains
const route = await client.call("bridge_routes", {
  fromChain: "1", toChain: "8453", token: "USDC", amount: "1000000"
});

Vercel AI SDK Integration

Use this when building AI agents with Vercel AI SDK. Returns all 103 tools as Vercel-compatible tool objects with automatic x402 payment handling.

import { createClient } from "x402-agent-tools";
import { getX402Tools } from "x402-agent-tools/ai-sdk";
import { generateText } from "ai";
import { anthropic } from "@ai-sdk/anthropic";

const client = createClient("0xYourPrivateKey");

const { text } = await generateText({
  model: anthropic("claude-sonnet-4-20250514"),
  tools: getX402Tools(client),
  prompt: "What are the current funding rates on Hyperliquid for BTC and ETH? Also check if there are any liquidation levels near current prices on Aave.",
});
Filter by category or specific tools
// Only Hyperliquid + DeFi tools (ideal for trading agents)
const tradingTools = getX402Tools(client, {
  categories: ["hyperliquid", "defi", "crypto"]
});

// Only specific tools you need
const researchTools = getX402Tools(client, {
  tools: ["web_scraper", "web_search", "fact_checker", "research_report"]
});

LangChain.js Integration

Use this when building agents with LangChain.js. Returns DynamicStructuredTool instances compatible with all LangChain agent types.

import { createClient } from "x402-agent-tools";
import { getX402LangChainTools } from "x402-agent-tools/langchain";
import { ChatAnthropic } from "@langchain/anthropic";
import { AgentExecutor, createToolCallingAgent } from "langchain/agents";

const client = createClient("0xYourPrivateKey");
const tools = getX402LangChainTools(client);

const llm = new ChatAnthropic({ model: "claude-sonnet-4-20250514" });
const agent = createToolCallingAgent({ llm, tools, prompt: yourPrompt });
const executor = new AgentExecutor({ agent, tools });

await executor.invoke({
  input: "Find the top whale positions on Hyperliquid BTC, check token safety for the top traded token, then summarize the findings."
});

Direct HTTP (No SDK Needed)

Every tool is also available as a standalone x402 HTTP endpoint. Use @x402/fetch directly:

import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount("0xYourPrivateKey");
const paidFetch = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

// trust_score is POST /api/score. GET tools (e.g. dex_quotes -> /api/quote) take query params.
const response = await paidFetch("https://trust-score.api.klymax402.com/api/score", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ target: "example.com" }),
});
const result = await response.json();

All 103 Tools

Hyperliquid Suite — 7 tools

#1 Hyperliquid data provider on x402. Complete DEX coverage.

Tool Price What it returns
hyperliquid_data $0.003 Perp markets: prices, open interest, 24h volume, orderbook depth for 229 markets
hyperliquid_whales $0.008 Whale positions: sizes, PnL, entry prices, leverage
hl_vaults $0.008 Vault summaries: APR, TVL, PnL, depositor count
hl_funding $0.005 Funding rates: current, 1h, 8h, 24h with arb scanner
hl_portfolio $0.008 Account analysis: positions, PnL, fills, open orders, funding
hl_spot $0.005 454 spot tokens: prices, volume, wallet balances
Prediction Markets — 2 tools
Tool Price What it returns
prediction_markets $0.012 Active events from Polymarket + Kalshi: probabilities, volume, trending
event_resolver $0.012 Settlement oracle: resolve outcomes, verify claims, check thresholds
Crypto & DeFi — 16 tools
Tool Price What it returns
wallet_portfolio $0.008 Multi-chain wallet balances and token holdings
gas_oracle $0.003 Gas prices: fast/standard/slow for any EVM chain
gas_estimator $0.005 Multi-chain gas comparison in one call
dex_quotes $0.012 Best swap quotes across DEXs with price impact
token_price $0.003 Real-time crypto prices via CoinGecko
defi_yields $0.005 Best DeFi yields: APY, TVL, risk scores
whale_alert $0.008 Large crypto transactions and whale movements
crypto_news $0.005 Crypto news with sentiment scores
funding_arb $0.012 Funding rate arbitrage across exchanges
funding_rates $0.005 Live perp funding: Binance, Bybit, OKX, open interest
ens_resolver $0.005 ENS name resolution and reverse lookup
token_holders $0.012 Token holder distribution: whale count, concentration
token_ohlcv $0.005 Historical OHLCV candles
airdrop_checker $0.012 Check wallet eligibility for active airdrops
bridge_routes $0.008 Best cross-chain bridge routes via LI.FI (60+ chains)
currency_converter $0.003 Fiat (ECB) and crypto (CoinGecko) conversion
DeFi Advanced — 3 tools
Tool Price What it returns
base_defi $0.008 Base chain yields: Aerodrome LP, Moonwell lending
liquidation_oracle $0.008 Liquidation levels: Aave, Compound, Morpho positions
orderbook_depth $0.012 Uniswap V3 liquidity depth and slippage estimation
NFT — 3 tools
Tool Price What it returns
nft_collection $0.012 Collection floor price, volume, holders, rarity
nft_rarity $0.008 Token rarity rank, score, trait floor prices
nft_metadata $0.008 NFT metadata: name, image, attributes, collection info
Solana — 4 tools
Tool Price What it returns
solana_launches $0.008 New token launches: pump.fun, Raydium
jupiter_quotes $0.005 Jupiter aggregator swap quotes
solana_fees $0.003 Priority fee estimates at 6 levels
solana_pools $0.008 DEX pool liquidity: Raydium, Orca, Meteora
Trust & Security — 8 tools
Tool Price What it returns
trust_score $0.02 Unified trust scoring 0-100: domains, wallets, APIs
token_safety $0.008 Rug pull detection: honeypot, liquidity, ownership
domain_intelligence $0.012 Full domain intel: DNS, WHOIS, SSL, registrar
ssl_checker $0.005 SSL/TLS cert: validity, expiry, chain, grade
http_headers $0.003 HTTP security headers: HSTS, CSP, server detection
port_scanner $0.008 TCP port scan: open/closed, response time
password_strength $0.003 Password score 0-100, entropy, crack time
jwt_decoder $0.003 JWT decode: header, payload, claims, expiry
B2B Enrichment — 6 tools
Tool Price What it returns
email_verification $0.005 Email validation: syntax, MX, disposable, score 0-100
company_enrichment $0.02 Company data: industry, size, tech, social, founded
person_enrichment $0.02 Person data: name, role, company, social, location
email_finder $0.012 Find email from name + domain
tech_enrichment $0.012 50+ technologies detected on any website
social_profile $0.015 Social profiles: Twitter, GitHub, LinkedIn, YouTube
Email — 2 tools
Tool Price What it returns
email_deliverability $0.012 Deliverability audit: SPF, DKIM, DMARC, score 0-100
email_send $0.008 Send emails via Resend: text/HTML, delivery status
Web & SEO — 6 tools
Tool Price What it returns
web_scraper $0.012 URL to clean markdown, headless rendering
seo_analyzer $0.06 Full SEO audit: meta, headings, schema, score 0-100
screenshot_pdf $0.015 Screenshots (PNG/JPEG/WebP) and PDF capture
web_search $0.008 Web search: title, URL, snippet, 10 results
keyword_research $0.02 SEO keywords: Google Suggest, intent, long-tail
webhook_tester $0.005 Test webhooks: custom methods, headers, latency
Social — 1 tool
Tool Price What it returns
twitter_scraper $0.012 Twitter/X profiles, search, timelines. No API key
Network — 3 tools
Tool Price What it returns
dns_lookup $0.005 DNS records: A, MX, TXT, CNAME via Cloudflare DoH
ip_geolocation $0.008 IP geolocation: country, city, ISP, VPN detection
ip_geolocation_batch $0.01 Batch geolocate up to 20 IPs
NLP — 5 tools
Tool Price What it returns
ai_summarizer $0.03 Summarize text/URLs -- fast extractive summarization
sentiment_analyzer $0.015 Sentiment, emotions, confidence scores
text_translator $0.012 Translate 50+ languages with auto-detection
text_classifier $0.012 Topic classification, readability, content type
language_detector $0.005 Language detection: 30+ languages, script, confidence
Finance — 1 tool
Tool Price What it returns
stock_price $0.005 Real-time stock quotes: price, change, volume, mcap
Media — 3 tools
Tool Price What it returns
image_resize $0.008 Resize images: dimensions, format conversion
ocr_extract $0.012 OCR text extraction from images
text_to_speech $0.012 Text to speech: 20+ languages, MP3 output
Text Processing — 8 tools
Tool Price What it returns
diff_checker $0.005 Line-by-line text diff with similarity score
word_counter $0.003 Words, chars, sentences, paragraphs, reading time
lorem_ipsum $0.003 Placeholder text: paragraphs, sentences, words
slug_generator $0.003 URL-friendly slugs with transliteration
regex_tester $0.003 Regex testing: matches, groups, explanations
html_to_markdown $0.003 HTML to clean Markdown conversion
markdown_to_html $0.003 Markdown to HTML conversion
markdown_renderer $0.005 Markdown to styled HTML (light/dark/GitHub themes)
Research — 2 tools
Tool Price What it returns
fact_checker $0.012 Verify claims with evidence and sources
research_report $0.06 Multi-source research reports in markdown
Compliance — 2 tools
Tool Price What it returns
gdpr_scanner $0.03 GDPR compliance: consent, privacy, trackers
pii_detector $0.012 PII detection: emails, SSNs, credit cards, redaction
Validation — 5 tools
Tool Price What it returns
phone_validation $0.008 Phone validation: carrier, line type, E.164
phone_validation_batch $0.025 Batch validate up to 50 phones
sms_validator $0.005 SMS-capable validation with carrier type
address_validator $0.008 Postal address parsing and normalization
json_validator $0.003 JSON syntax + schema validation
Developer — 1 tool
Tool Price What it returns
code_sandbox $0.02 Execute Python/JS/SQL in sandbox with output
Generators — 5 tools
Tool Price What it returns
qr_code $0.003 QR codes as base64 PNG
barcode_generator $0.003 Barcodes: EAN-13, UPC-A, Code128, Code39
hash_generator $0.003 MD5, SHA1, SHA256, SHA512, bcrypt hashes
uuid_generator $0.003 UUID v4, v7, ULID, nanoid (batch 100)
color_palette $0.003 Harmonious color palettes from hex
Documents — 1 tool
Tool Price What it returns
pdf_generator $0.015 PDF from HTML/Markdown with custom layout
Utility — 8 tools
Tool Price What it returns
base64_codec $0.003 Base64 encode/decode (standard + URL-safe)
csv_to_json $0.003 CSV to JSON with auto-detect delimiter
cron_parser $0.003 Parse cron expressions with next run times
crontab_generator $0.003 Natural language to cron expression
timezone_converter $0.003 Datetime conversion between IANA timezones
unit_converter $0.003 Length, weight, temp, volume, speed conversion
url_shortener $0.003 URL shortening with custom aliases
user_agent_parser $0.003 Parse user agent: browser, OS, device, bot
Data — 2 tools
Tool Price What it returns
weather $0.003 Current weather + 7-day forecast
vector_search $0.012 TF-IDF cosine similarity document search

How x402 Payment Works

Your Agent                    x402-agent-tools                  API Server
    |                              |                                |
    |-- call("trust_score", {})  ->|                                |
    |                              |-- POST /api/score ------------>|
    |                              |<-- 402 Payment Required -------|
    |                              |                                |
    |                              |   [auto-signs USDC payment]    |
    |                              |                                |
    |                              |-- POST /api/score + payment -->|
    |                              |<-- 200 OK + JSON data ---------|
    |<-- structured result --------|                                |
  1. Your agent calls a tool through the SDK
  2. The SDK sends an HTTP request to our API
  3. Server responds 402 Payment Required with price in USDC
  4. @x402/fetch automatically signs a USDC micro-payment on Base L2
  5. Request retries with the signed payment header
  6. You get structured JSON data back

No API keys. No rate limits. No subscriptions. Pay per call.

Categories

const client = createClient("0xYourPrivateKey");

// List all categories
console.log(client.listCategories());
// ["hyperliquid", "prediction", "crypto", "defi", "nft", "solana",
//  "security", "enrichment", "email", "web", "social", "network",
//  "nlp", "finance", "media", "text", "research", "compliance",
//  "validation", "developer", "generator", "document", "utility", "data"]

// Get tools in a category
const cryptoTools = client.getToolsByCategory("hyperliquid");

// List all 103 tools
const all = client.listTools();

Use Cases

Trading Agent — Use hyperliquid_* + funding_rates + liquidation_oracle + prediction_markets to build autonomous trading strategies. Monitor whale positions, funding arbitrage, and prediction market odds in real-time.

Research Agent — Use web_search + web_scraper + fact_checker + research_report + ai_summarizer to build deep research pipelines. Scrape, verify, and synthesize information from multiple sources.

Security Agent — Use trust_score + token_safety + ssl_checker + port_scanner + gdpr_scanner to audit websites, tokens, and infrastructure. Generate compliance reports automatically.

Sales Agent — Use email_finder + company_enrichment + person_enrichment + email_verification + email_send to build outbound sales pipelines. Find, enrich, verify, and contact leads at scale.

DeFi Agent — Use defi_yields + base_defi + bridge_routes + dex_quotes + wallet_portfolio to optimize yield farming, find bridge routes, and manage multi-chain portfolios.

Requirements

  • Node.js >= 18
  • A wallet with USDC on Base L2 (even $1 gets you 100-1000+ calls)
  • Private key for signing payments (use a dedicated agent wallet, not your main wallet)

AI Discovery

klymax402 publishes a machine-readable catalog for AI systems and LLM crawlers:

  • llms.txt: klymax402.com/llms.txt — full API catalog in llms.txt format (100 APIs, pricing, MCP install snippets, x402 payment reference)
  • MCP endpoint: https://klymax402.com/mcp — self-hosted MCP gateway, all 100 APIs, Streamable HTTP
  • Live stats: klymax402.com/stats — 99.9% uptime, P50 57ms, P95 104ms, 766 txs on-chain

Compatible with Claude, Claude Code, Cursor, Codex, and ElizaOS (plugin: eliza-plugin-klymax402).

Links

License

MIT

Keywords

x402ai-agentlangchainvercel-ai-sdktoolsmicropaymentsusdcbasehyperliquidcryptoenrichmentweb-scrapertrust-scoremcp