# klymax402 — Full API Reference for AI Agents

> Complete technical reference for klymax402.com — 100 pay-per-call APIs for autonomous AI agents. Covers authentication, integration patterns, per-API documentation with request/response examples, pricing, and SDK usage. This file is the machine-readable companion to llms.txt and is intended for LLMs generating integration code.

klymax402 provides 100 specialized APIs callable by AI agents via two payment methods: (1) x402 on-chain micropayments (EIP-3009 USDC on Base, no registration), (2) prepaid credits with a `klyx_xxx` API key (register once, top up USDC). All APIs return structured JSON. Median latency P50 57ms, P95 104ms, uptime 99.9% over 24h rolling window.


## Authentication

### Method A — x402 on-chain (recommended for agents with wallets)

No registration. The agent pays per request automatically using `@x402/fetch`.

```typescript
import { wrapFetchWithPayment } from "@x402/fetch";
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";

const account = privateKeyToAccount("0xYOUR_PRIVATE_KEY");
const walletClient = createWalletClient({ account, chain: base, transport: http() });
const fetch = wrapFetchWithPayment(globalThis.fetch, walletClient);

// All subsequent fetch() calls auto-pay USDC on 402 response
const res = await fetch("https://web-search.api.klymax402.com/search?q=latest+AI+news");
const data = await res.json();
```

```bash
# Manual curl with pre-signed X-PAYMENT header
curl https://token-price.api.klymax402.com/price?symbol=ETH \
  -H "X-PAYMENT: <eip3009-signed-payload>"
```

x402 payment flow:
1. Agent sends GET/POST to API endpoint
2. Server returns `HTTP 402 Payment Required` with `X-Payment-Requirements` header
3. `@x402/fetch` signs EIP-3009 `transferWithAuthorization` with wallet
4. Agent retries with `X-PAYMENT` header containing signed payload
5. Server verifies signature on Base, releases response

- Chain: Base mainnet (eip155:8453)
- Token: USDC — 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
- Receiver: 0x6E8B64638b24C6D625b045dD353120d850064E2E
- Method IDs: e3ee160e (transferWithAuthorization), ef55bec6 (receiveWithAuthorization)
- Facilitator: Coinbase CDP


### Method B — Prepaid Credits (recommended for agents without wallet signing)

1. Register wallet → get API key
2. Send USDC on Base to credits bank wallet
3. Use `X-Klymax-Key` header on any API call

```bash
# Step 1: Register
curl -X POST https://klymax402.com/register \
  -H "Content-Type: application/json" \
  -d '{"wallet": "0xYourBaseWallet"}'
# Response: {"api_key": "klyx_abc123...", "credits_bank": "0x7cfEcBF575F0591772E09411FDBF1b88E4a0377E"}

# Step 2: Send USDC on Base to the credits_bank address
# Starter: $10 → $11.00 credits (+10%)
# Pro:     $50 → $62.50 credits (+25%)
# Scale:  $200 → $280.00 credits (+40%)

# Step 3: Call any API
curl https://web-search.api.klymax402.com/search?q=AI+agents \
  -H "X-Klymax-Key: klyx_abc123..."

# Check balance
curl "https://klymax402.com/balance?key=klyx_abc123..."
# Response: {"balance_usd": 10.997, "transactions": 3}
```

```typescript
// TypeScript — prepaid credits
const API_KEY = process.env.KLYMAX_KEY; // klyx_...

async function callAPI(slug: string, path: string, params?: Record<string, string>) {
  const url = new URL(`https://${slug}.api.klymax402.com${path}`);
  if (params) Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, v));
  const res = await fetch(url.toString(), { headers: { "X-Klymax-Key": API_KEY! } });
  if (!res.ok) throw new Error(`API error: ${res.status}`);
  return res.json();
}

const price = await callAPI("token-price", "/price", { symbol: "ETH" });
```

Credits bank wallet: `0x7cfEcBF575F0591772E09411FDBF1b88E4a0377E`
Full pack details: https://klymax402.com/packs/


### Method C — MCP (Claude / Cursor / Codex / ElizaOS)

Add to MCP client config — all 100 APIs available as tools, no code required:

```json
{
  "mcpServers": {
    "klymax402": {
      "url": "https://app.ampersend.ai/api/hosted/klymax402/mighty-host/skill"
    }
  }
}
```

With prepaid key:
```json
{
  "mcpServers": {
    "klymax402": {
      "url": "https://app.ampersend.ai/api/hosted/klymax402/mighty-host/skill",
      "headers": { "X-Klymax-Key": "klyx_xxx" }
    }
  }
}
```

Claude Code terminal: `claude mcp add -s user -t http klymax402 https://app.ampersend.ai/api/hosted/klymax402/mighty-host/skill`
ElizaOS: `npm install eliza-plugin-klymax402` — 15 x402-pay actions, PR #10325 merged in elizaOS registry


## Error Handling

| HTTP Status | Meaning | Action |
|-------------|---------|--------|
| 200 | Success | Parse JSON response |
| 402 | Payment required | Sign payment with @x402/fetch and retry |
| 400 | Bad request | Check required parameters |
| 401 | Invalid API key | Verify X-Klymax-Key |
| 402 (credits) | Insufficient credits | Top up credits at klymax402.com/packs |
| 429 | Rate limited | Exponential backoff (rare, no hard limits) |
| 500 | Server error | Retry after 1s |

All error responses include `{"error": "message", "code": "ERROR_CODE"}`.


## SDK — x402-agent-tools

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

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

const client = createClient("0xYourPrivateKey");

// Single call
const result = await client.call("web_search", { query: "x402 protocol" });

// Vercel AI SDK integration (all 100 tools as Vercel tool objects)
import { getX402Tools } from "x402-agent-tools/ai-sdk";
const tools = getX402Tools(client, { categories: ["crypto", "defi"] });

// List tools by category
const cryptoTools = client.getToolsByCategory("hyperliquid");
```

npm: https://www.npmjs.com/package/x402-agent-tools
GitHub: https://github.com/Br0ski777/x402-agent-tools


## API Reference — Detailed Documentation

### web-search

Search the web and return structured results.

- Endpoint: `GET https://web-search.api.klymax402.com/search`
- Price: $0.003 USDC
- Auth: x402 or X-Klymax-Key

Parameters:
- `q` (required) — search query string
- `num` (optional, default 10) — number of results (max 20)
- `lang` (optional, default "en") — language code

```bash
curl "https://web-search.api.klymax402.com/search?q=ethereum+price&num=5" \
  -H "X-Klymax-Key: klyx_xxx"
```

```typescript
const res = await fetch("https://web-search.api.klymax402.com/search?q=AI+agents+2025&num=10", {
  headers: { "X-Klymax-Key": process.env.KLYMAX_KEY }
});
const { results, total } = await res.json();
// results: [{ title, url, snippet, score }]
```

Response:
```json
{
  "results": [
    { "title": "Page Title", "url": "https://...", "snippet": "...", "score": 0.92 }
  ],
  "total": 1240000,
  "query": "AI agents 2025"
}
```

---

### web-scraper

Extract clean markdown content from any URL.

- Endpoint: `POST https://web-scraper.api.klymax402.com/scrape`
- Price: $0.005 USDC
- Auth: x402 or X-Klymax-Key

Parameters (JSON body):
- `url` (required) — target URL
- `selector` (optional) — CSS selector to extract a specific element
- `wait_for` (optional) — CSS selector to wait for before scraping (JS-rendered pages)

```bash
curl -X POST https://web-scraper.api.klymax402.com/scrape \
  -H "Content-Type: application/json" \
  -H "X-Klymax-Key: klyx_xxx" \
  -d '{"url": "https://example.com/article"}'
```

Response:
```json
{
  "url": "https://example.com/article",
  "title": "Article Title",
  "markdown": "# Article Title\n\nContent in clean markdown...",
  "word_count": 842,
  "scraped_at": "2026-06-30T10:00:00Z"
}
```

---

### token-price

Real-time crypto token prices via CoinGecko.

- Endpoint: `GET https://token-price.api.klymax402.com/price`
- Price: $0.001 USDC
- Auth: x402 or X-Klymax-Key

Parameters:
- `symbol` (required) — token symbol (BTC, ETH, SOL, etc.)
- `vs_currency` (optional, default "usd") — target currency

```bash
curl "https://token-price.api.klymax402.com/price?symbol=ETH&vs_currency=usd" \
  -H "X-Klymax-Key: klyx_xxx"
```

Response:
```json
{
  "symbol": "ETH",
  "name": "Ethereum",
  "price_usd": 3412.58,
  "change_24h": 2.34,
  "market_cap": 410234000000,
  "volume_24h": 18450000000,
  "last_updated": "2026-06-30T10:00:00Z"
}
```

---

### hyperliquid-whales

Top trader positions on Hyperliquid perpetuals.

- Endpoint: `GET https://hyperliquid-whales.api.klymax402.com/whales`
- Price: $0.003 USDC
- Auth: x402 or X-Klymax-Key

Parameters:
- `coin` (required) — perpetual symbol (BTC, ETH, SOL, etc.)
- `limit` (optional, default 20) — number of positions

```bash
curl "https://hyperliquid-whales.api.klymax402.com/whales?coin=BTC&limit=10" \
  -H "X-Klymax-Key: klyx_xxx"
```

Response:
```json
{
  "coin": "BTC",
  "positions": [
    {
      "address": "0x...",
      "side": "long",
      "size_usd": 4200000,
      "entry_price": 61200,
      "unrealized_pnl": 84000,
      "leverage": 10
    }
  ],
  "total_long_usd": 42000000,
  "total_short_usd": 18000000,
  "long_short_ratio": 2.33
}
```

---

### company-enrichment

Firmographic data from a company domain.

- Endpoint: `GET https://company-enrichment.api.klymax402.com/enrich`
- Price: $0.005 USDC
- Auth: x402 or X-Klymax-Key

Parameters:
- `domain` (required) — company domain (stripe.com, openai.com, etc.)

```bash
curl "https://company-enrichment.api.klymax402.com/enrich?domain=stripe.com" \
  -H "X-Klymax-Key: klyx_xxx"
```

Response:
```json
{
  "domain": "stripe.com",
  "name": "Stripe",
  "description": "...",
  "industry": "Financial Technology",
  "employee_count": 8000,
  "founded_year": 2010,
  "linkedin_url": "https://linkedin.com/company/stripe",
  "twitter_url": "https://twitter.com/stripe",
  "phone": "+1-...",
  "email_format": "{first}@stripe.com",
  "technologies": ["React", "Ruby", "Go", "AWS"],
  "headquarters": "San Francisco, CA, US"
}
```

---

### email-finder

Find professional email addresses from name + domain.

- Endpoint: `GET https://email-finder.api.klymax402.com/find`
- Price: $0.010 USDC
- Auth: x402 or X-Klymax-Key

Parameters:
- `first_name` (required)
- `last_name` (required)
- `domain` (required)

```bash
curl "https://email-finder.api.klymax402.com/find?first_name=John&last_name=Smith&domain=stripe.com" \
  -H "X-Klymax-Key: klyx_xxx"
```

Response:
```json
{
  "email": "john.smith@stripe.com",
  "confidence": 0.91,
  "sources": 3,
  "pattern": "{first}.{last}",
  "verified": true
}
```

---

### dex-quotes

Best swap quotes across DEXes on Base and Ethereum.

- Endpoint: `POST https://dex-quotes.api.klymax402.com/quote`
- Price: $0.005 USDC
- Auth: x402 or X-Klymax-Key

Parameters (JSON body):
- `token_in` (required) — input token address or symbol
- `token_out` (required) — output token address or symbol
- `amount_in` (required) — input amount (raw units or human-readable)
- `chain` (optional, default "base") — "base" or "ethereum"

```bash
curl -X POST https://dex-quotes.api.klymax402.com/quote \
  -H "Content-Type: application/json" \
  -H "X-Klymax-Key: klyx_xxx" \
  -d '{"token_in": "ETH", "token_out": "USDC", "amount_in": "1", "chain": "base"}'
```

Response:
```json
{
  "token_in": "ETH",
  "token_out": "USDC",
  "amount_in": "1",
  "amount_out": "3412.58",
  "price_impact": 0.0012,
  "best_dex": "Aerodrome",
  "route": ["ETH", "USDC"],
  "gas_estimate_usd": 0.08,
  "quotes": [
    { "dex": "Aerodrome", "amount_out": "3412.58", "fee": 0.0005 },
    { "dex": "Uniswap V3", "amount_out": "3410.20", "fee": 0.0030 }
  ]
}
```

---

### funding-rates

Perpetual funding rates across major exchanges.

- Endpoint: `GET https://funding-rates.api.klymax402.com/rates`
- Price: $0.002 USDC
- Auth: x402 or X-Klymax-Key

Parameters:
- `symbol` (optional) — filter by symbol (BTC, ETH). Omit for all.
- `exchanges` (optional) — comma-separated exchanges (binance,bybit,okx,hyperliquid)

```bash
curl "https://funding-rates.api.klymax402.com/rates?symbol=BTC" \
  -H "X-Klymax-Key: klyx_xxx"
```

Response:
```json
{
  "symbol": "BTC",
  "rates": [
    {
      "exchange": "Binance",
      "funding_rate": 0.000125,
      "annualized": 0.1095,
      "next_funding": "2026-06-30T16:00:00Z",
      "open_interest_usd": 8200000000
    },
    {
      "exchange": "Hyperliquid",
      "funding_rate": 0.000098,
      "annualized": 0.0859,
      "next_funding": "2026-06-30T13:00:00Z",
      "open_interest_usd": 420000000
    }
  ],
  "arb_spread": 0.000027
}
```

---

### token-safety

Token safety check — honeypot, tax, blacklist, risk score.

- Endpoint: `GET https://token-safety.api.klymax402.com/check`
- Price: $0.003 USDC
- Auth: x402 or X-Klymax-Key

Parameters:
- `address` (required) — token contract address
- `chain` (optional, default "eth") — "eth", "base", "bsc", "sol"

```bash
curl "https://token-safety.api.klymax402.com/check?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&chain=base" \
  -H "X-Klymax-Key: klyx_xxx"
```

Response:
```json
{
  "address": "0x833589...",
  "symbol": "USDC",
  "is_honeypot": false,
  "buy_tax": 0,
  "sell_tax": 0,
  "is_proxy": false,
  "is_blacklisted": false,
  "owner_address": "0x...",
  "risk_score": 2,
  "risk_level": "low",
  "flags": [],
  "source": "goplus"
}
```

---

### wallet-portfolio

ERC-20 token balances and USD values for a wallet.

- Endpoint: `GET https://wallet-portfolio.api.klymax402.com/portfolio`
- Price: $0.003 USDC
- Auth: x402 or X-Klymax-Key

Parameters:
- `address` (required) — wallet address (0x...)
- `chain` (optional, default "base") — "base" or "ethereum"

```bash
curl "https://wallet-portfolio.api.klymax402.com/portfolio?address=0x...&chain=base" \
  -H "X-Klymax-Key: klyx_xxx"
```

Response:
```json
{
  "address": "0x...",
  "chain": "base",
  "total_usd": 12450.32,
  "tokens": [
    { "symbol": "USDC", "balance": "5000.00", "usd_value": 5000.00, "address": "0x8335..." },
    { "symbol": "ETH", "balance": "2.15", "usd_value": 7342.05, "address": "native" }
  ],
  "last_updated": "2026-06-30T10:00:00Z"
}
```

---

### research-report

Multi-source research report with live web synthesis.

- Endpoint: `POST https://research-report.api.klymax402.com/report`
- Price: $0.010 USDC
- Auth: x402 or X-Klymax-Key

Parameters (JSON body):
- `topic` (required) — research topic
- `depth` (optional, default "standard") — "quick" | "standard" | "deep"
- `format` (optional, default "markdown") — "markdown" | "json"

```bash
curl -X POST https://research-report.api.klymax402.com/report \
  -H "Content-Type: application/json" \
  -H "X-Klymax-Key: klyx_xxx" \
  -d '{"topic": "x402 payment protocol adoption", "depth": "standard"}'
```

Response:
```json
{
  "topic": "x402 payment protocol adoption",
  "summary": "...",
  "report": "# x402 Protocol Adoption\n\n## Overview\n...",
  "sources": [
    { "url": "https://...", "title": "...", "relevance": 0.94 }
  ],
  "word_count": 1240,
  "generated_at": "2026-06-30T10:00:00Z"
}
```

---

### screenshot-pdf

Capture screenshot or PDF from any URL.

- Endpoint: `POST https://screenshot-pdf.api.klymax402.com/capture`
- Price: $0.008 USDC
- Auth: x402 or X-Klymax-Key

Parameters (JSON body):
- `url` (required) — target URL
- `type` (optional, default "screenshot") — "screenshot" | "pdf"
- `format` (optional, default "png") — "png" | "jpeg" | "webp" (screenshot only)
- `width` (optional, default 1280) — viewport width
- `full_page` (optional, default false) — capture full page height

```bash
curl -X POST https://screenshot-pdf.api.klymax402.com/capture \
  -H "Content-Type: application/json" \
  -H "X-Klymax-Key: klyx_xxx" \
  -d '{"url": "https://klymax402.com", "type": "screenshot", "format": "png"}'
```

Response:
```json
{
  "url": "https://klymax402.com",
  "type": "screenshot",
  "format": "png",
  "image_base64": "iVBORw0KGgo...",
  "width": 1280,
  "height": 800,
  "captured_at": "2026-06-30T10:00:00Z"
}
```

---

### ip-geolocation

IP geolocation with VPN/proxy/Tor detection.

- Endpoint: `GET https://ip-geolocation.api.klymax402.com/geo`
- Price: $0.003 USDC
- Auth: x402 or X-Klymax-Key

Parameters:
- `ip` (required) — IPv4 or IPv6 address

```bash
curl "https://ip-geolocation.api.klymax402.com/geo?ip=8.8.8.8" \
  -H "X-Klymax-Key: klyx_xxx"
```

Response:
```json
{
  "ip": "8.8.8.8",
  "country": "United States",
  "country_code": "US",
  "region": "California",
  "city": "Mountain View",
  "latitude": 37.4056,
  "longitude": -122.0775,
  "isp": "Google LLC",
  "asn": "AS15169",
  "is_vpn": false,
  "is_proxy": false,
  "is_tor": false,
  "is_datacenter": true
}
```

---

### sentiment-analyzer

Text sentiment, emotions, and key phrases.

- Endpoint: `POST https://sentiment-analyzer.api.klymax402.com/analyze`
- Price: $0.005 USDC
- Auth: x402 or X-Klymax-Key

Parameters (JSON body):
- `text` (required) — text to analyze (max 10,000 chars)
- `language` (optional, default "en") — ISO 639-1 language code

```bash
curl -X POST https://sentiment-analyzer.api.klymax402.com/analyze \
  -H "Content-Type: application/json" \
  -H "X-Klymax-Key: klyx_xxx" \
  -d '{"text": "The new x402 protocol is incredibly efficient for AI agents."}'
```

Response:
```json
{
  "sentiment": "positive",
  "score": 0.87,
  "emotions": { "joy": 0.72, "trust": 0.65, "anticipation": 0.48 },
  "key_phrases": ["x402 protocol", "AI agents", "incredibly efficient"],
  "language": "en"
}
```

---

### solana-launches

New Solana token launches from pump.fun, Raydium, PumpSwap.

- Endpoint: `GET https://solana-launches.api.klymax402.com/launches`
- Price: $0.003 USDC
- Auth: x402 or X-Klymax-Key

Parameters:
- `limit` (optional, default 20) — number of tokens (max 50)
- `min_liquidity_usd` (optional) — filter by minimum liquidity
- `source` (optional) — "pumpfun" | "raydium" | "pumpswap" | "all"

```bash
curl "https://solana-launches.api.klymax402.com/launches?limit=10&min_liquidity_usd=5000" \
  -H "X-Klymax-Key: klyx_xxx"
```

Response:
```json
{
  "launches": [
    {
      "address": "...",
      "symbol": "BONK2",
      "name": "Bonk 2.0",
      "price_usd": 0.000042,
      "liquidity_usd": 18500,
      "volume_24h_usd": 42000,
      "holders": 412,
      "created_at": "2026-06-30T09:45:00Z",
      "source": "pumpfun",
      "graduated": false
    }
  ],
  "total": 847,
  "as_of": "2026-06-30T10:00:00Z"
}
```

---

### email-verification

Verify email deliverability — syntax, MX, disposable detection.

- Endpoint: `GET https://email-verification.api.klymax402.com/verify`
- Price: $0.002 USDC
- Auth: x402 or X-Klymax-Key

Parameters:
- `email` (required) — email address to verify

```bash
curl "https://email-verification.api.klymax402.com/verify?email=user@example.com" \
  -H "X-Klymax-Key: klyx_xxx"
```

Response:
```json
{
  "email": "user@example.com",
  "valid": true,
  "syntax_valid": true,
  "mx_valid": true,
  "disposable": false,
  "role_account": false,
  "quality_score": 92,
  "did_you_mean": null
}
```

---

### ssl-checker

SSL certificate validity, expiry, issuer, TLS grade.

- Endpoint: `GET https://ssl-checker.api.klymax402.com/check`
- Price: $0.002 USDC
- Auth: x402 or X-Klymax-Key

Parameters:
- `domain` (required) — domain to check (without https://)

```bash
curl "https://ssl-checker.api.klymax402.com/check?domain=klymax402.com" \
  -H "X-Klymax-Key: klyx_xxx"
```

Response:
```json
{
  "domain": "klymax402.com",
  "valid": true,
  "issuer": "Let's Encrypt",
  "subject": "klymax402.com",
  "expires_at": "2026-09-28T00:00:00Z",
  "days_remaining": 90,
  "tls_version": "TLS 1.3",
  "grade": "A+",
  "san": ["klymax402.com", "*.klymax402.com"]
}
```

---

### ai-summarizer

Summarize text or URL into key points.

- Endpoint: `POST https://ai-summarizer.api.klymax402.com/summarize`
- Price: $0.010 USDC
- Auth: x402 or X-Klymax-Key

Parameters (JSON body):
- `text` (optional) — text to summarize
- `url` (optional) — URL to fetch and summarize (use `text` or `url`, not both)
- `length` (optional, default "medium") — "short" | "medium" | "long"
- `format` (optional, default "bullets") — "bullets" | "paragraph"

```bash
curl -X POST https://ai-summarizer.api.klymax402.com/summarize \
  -H "Content-Type: application/json" \
  -H "X-Klymax-Key: klyx_xxx" \
  -d '{"url": "https://x402.org", "length": "short", "format": "bullets"}'
```

Response:
```json
{
  "summary": "- x402 is an open HTTP payment protocol\n- Uses EIP-3009 USDC micropayments on Base\n- Enables pay-per-request APIs without subscriptions",
  "key_points": ["Open payment protocol", "Base L2 micropayments", "No subscriptions"],
  "reading_time_min": 0.5,
  "compression_ratio": 0.08,
  "source": "https://x402.org"
}
```

---

### defi-yields

Best DeFi yield opportunities by token across protocols.

- Endpoint: `GET https://defi-yields.api.klymax402.com/yields`
- Price: $0.002 USDC
- Auth: x402 or X-Klymax-Key

Parameters:
- `token` (optional) — filter by token symbol (USDC, ETH, etc.)
- `chain` (optional) — filter by chain (ethereum, base, arbitrum, etc.)
- `min_apy` (optional) — minimum APY percentage
- `min_tvl_usd` (optional) — minimum protocol TVL

```bash
curl "https://defi-yields.api.klymax402.com/yields?token=USDC&min_apy=5&min_tvl_usd=1000000" \
  -H "X-Klymax-Key: klyx_xxx"
```

Response:
```json
{
  "yields": [
    {
      "protocol": "Aave V3",
      "chain": "ethereum",
      "token": "USDC",
      "apy": 8.42,
      "tvl_usd": 4200000000,
      "risk": "low",
      "pool_url": "https://app.aave.com/..."
    }
  ],
  "total": 24,
  "as_of": "2026-06-30T10:00:00Z"
}
```

---

### prediction-markets

Polymarket odds and active prediction market events.

- Endpoint: `GET https://prediction-markets.api.klymax402.com/markets`
- Price: $0.005 USDC
- Auth: x402 or X-Klymax-Key

Parameters:
- `query` (optional) — search markets by keyword
- `status` (optional, default "active") — "active" | "resolved"
- `limit` (optional, default 20)

```bash
curl "https://prediction-markets.api.klymax402.com/markets?query=bitcoin&limit=5" \
  -H "X-Klymax-Key: klyx_xxx"
```

Response:
```json
{
  "markets": [
    {
      "id": "...",
      "question": "Will BTC hit $100k by end of 2026?",
      "yes_price": 0.62,
      "no_price": 0.38,
      "volume_usd": 2400000,
      "liquidity_usd": 180000,
      "end_date": "2026-12-31T00:00:00Z",
      "category": "crypto"
    }
  ],
  "total": 12
}
```

---

### whale-alert

Large on-chain transactions on Ethereum and Base.

- Endpoint: `GET https://whale-alert.api.klymax402.com/alerts`
- Price: $0.003 USDC
- Auth: x402 or X-Klymax-Key

Parameters:
- `chain` (optional, default "all") — "ethereum" | "base" | "all"
- `min_usd` (optional, default 1000000) — minimum transaction value
- `limit` (optional, default 20)

```bash
curl "https://whale-alert.api.klymax402.com/alerts?min_usd=5000000&limit=10" \
  -H "X-Klymax-Key: klyx_xxx"
```

Response:
```json
{
  "alerts": [
    {
      "tx_hash": "0x...",
      "chain": "ethereum",
      "token": "USDC",
      "amount": 50000000,
      "amount_usd": 50000000,
      "from": { "address": "0x...", "label": "Binance" },
      "to": { "address": "0x...", "label": "Unknown" },
      "timestamp": "2026-06-30T09:58:00Z"
    }
  ],
  "total": 847
}
```

---

### text-translator

Translate text between 50+ languages with auto-detection.

- Endpoint: `POST https://text-translator.api.klymax402.com/translate`
- Price: $0.005 USDC
- Auth: x402 or X-Klymax-Key

Parameters (JSON body):
- `text` (required) — text to translate
- `target_lang` (required) — target language code (fr, es, de, zh, ja, etc.)
- `source_lang` (optional) — source language (auto-detected if omitted)

```bash
curl -X POST https://text-translator.api.klymax402.com/translate \
  -H "Content-Type: application/json" \
  -H "X-Klymax-Key: klyx_xxx" \
  -d '{"text": "Pay per call, no subscriptions.", "target_lang": "fr"}'
```

Response:
```json
{
  "original": "Pay per call, no subscriptions.",
  "translated": "Paiement à l'appel, pas d'abonnements.",
  "source_lang": "en",
  "target_lang": "fr",
  "confidence": 0.99
}
```


## Quick Reference — All 100 APIs

| API | Endpoint | Method | Price |
|-----|----------|--------|-------|
| address-validator | https://address-validator.api.klymax402.com | GET /validate | $0.005 |
| ai-summarizer | https://ai-summarizer.api.klymax402.com | POST /summarize | $0.010 |
| airdrop-checker | https://airdrop-checker.api.klymax402.com | GET /check | $0.003 |
| barcode-generator | https://barcode-generator.api.klymax402.com | GET /generate | $0.001 |
| base-defi | https://base-defi.api.klymax402.com | GET /yields | $0.003 |
| base64-codec | https://base64-codec.api.klymax402.com | POST /encode or /decode | $0.001 |
| bridge-routes | https://bridge-routes.api.klymax402.com | POST /route | $0.003 |
| code-sandbox | https://code-sandbox.api.klymax402.com | POST /execute | $0.008 |
| color-palette | https://color-palette.api.klymax402.com | GET /palette | $0.001 |
| company-enrichment | https://company-enrichment.api.klymax402.com | GET /enrich | $0.005 |
| cron-parser | https://cron-parser.api.klymax402.com | GET /parse | $0.001 |
| crontab-generator | https://crontab-generator.api.klymax402.com | POST /generate | $0.001 |
| crypto-news | https://crypto-news.api.klymax402.com | GET /news | $0.005 |
| csv-to-json | https://csv-to-json.api.klymax402.com | POST /convert | $0.001 |
| currency-converter | https://currency-converter.api.klymax402.com | GET /convert | $0.002 |
| defi-yields | https://defi-yields.api.klymax402.com | GET /yields | $0.002 |
| dex-quotes | https://dex-quotes.api.klymax402.com | POST /quote | $0.005 |
| diff-checker | https://diff-checker.api.klymax402.com | POST /diff | $0.001 |
| dns-lookup | https://dns-lookup.api.klymax402.com | GET /lookup | $0.002 |
| domain-intelligence | https://domain-intelligence.api.klymax402.com | GET /intel | $0.003 |
| email-deliverability | https://email-deliverability.api.klymax402.com | GET /audit | $0.002 |
| email-finder | https://email-finder.api.klymax402.com | GET /find | $0.010 |
| email-send | https://email-send.api.klymax402.com | POST /send | $0.005 |
| email-verification | https://email-verification.api.klymax402.com | GET /verify | $0.002 |
| ens-resolver | https://ens-resolver.api.klymax402.com | GET /resolve | $0.002 |
| event-resolver | https://event-resolver.api.klymax402.com | GET /resolve | $0.005 |
| fact-checker | https://fact-checker.api.klymax402.com | POST /check | $0.005 |
| funding-arb | https://funding-arb.api.klymax402.com | GET /scan | $0.003 |
| funding-rates | https://funding-rates.api.klymax402.com | GET /rates | $0.002 |
| gas-estimator | https://gas-estimator.api.klymax402.com | GET /estimate | $0.002 |
| gas-oracle | https://gas-oracle.api.klymax402.com | GET /gas | $0.002 |
| gdpr-scanner | https://gdpr-scanner.api.klymax402.com | POST /scan | $0.003 |
| hash-generator | https://hash-generator.api.klymax402.com | POST /hash | $0.001 |
| hl-funding | https://hl-funding.api.klymax402.com | GET /funding | $0.002 |
| hl-portfolio | https://hl-portfolio.api.klymax402.com | GET /portfolio | $0.003 |
| hl-spot | https://hl-spot.api.klymax402.com | GET /spot | $0.002 |
| hl-vaults | https://hl-vaults.api.klymax402.com | GET /vaults | $0.003 |
| html-to-markdown | https://html-to-markdown.api.klymax402.com | POST /convert | $0.001 |
| http-headers | https://http-headers.api.klymax402.com | GET /headers | $0.002 |
| hyperliquid-data | https://hyperliquid-data.api.klymax402.com | GET /data | $0.003 |
| hyperliquid-whales | https://hyperliquid-whales.api.klymax402.com | GET /whales | $0.003 |
| image-resize | https://image-resize.api.klymax402.com | POST /resize | $0.003 |
| ip-geolocation | https://ip-geolocation.api.klymax402.com | GET /geo | $0.003 |
| json-validator | https://json-validator.api.klymax402.com | POST /validate | $0.001 |
| jupiter-quotes | https://jupiter-quotes.api.klymax402.com | POST /quote | $0.003 |
| jwt-decoder | https://jwt-decoder.api.klymax402.com | POST /decode | $0.001 |
| keyword-research | https://keyword-research.api.klymax402.com | GET /research | $0.010 |
| language-detector | https://language-detector.api.klymax402.com | POST /detect | $0.001 |
| liquidation-oracle | https://liquidation-oracle.api.klymax402.com | GET /liquidations | $0.002 |
| lorem-ipsum | https://lorem-ipsum.api.klymax402.com | GET /generate | $0.001 |
| markdown-renderer | https://markdown-renderer.api.klymax402.com | POST /render | $0.001 |
| markdown-to-html | https://markdown-to-html.api.klymax402.com | POST /convert | $0.001 |
| nft-floor | https://nft-floor.api.klymax402.com | GET /floor | $0.005 |
| nft-metadata | https://nft-metadata.api.klymax402.com | GET /metadata | $0.003 |
| ocr-extract | https://ocr-extract.api.klymax402.com | POST /extract | $0.005 |
| orderbook-depth | https://orderbook-depth.api.klymax402.com | GET /depth | $0.003 |
| password-strength | https://password-strength.api.klymax402.com | POST /check | $0.001 |
| pdf-generator | https://pdf-generator.api.klymax402.com | POST /generate | $0.008 |
| person-enrichment | https://person-enrichment.api.klymax402.com | GET /enrich | $0.005 |
| phone-validation | https://phone-validation.api.klymax402.com | GET /validate | $0.025 |
| pii-detector | https://pii-detector.api.klymax402.com | POST /detect | $0.005 |
| port-scanner | https://port-scanner.api.klymax402.com | GET /scan | $0.003 |
| prediction-markets | https://prediction-markets.api.klymax402.com | GET /markets | $0.005 |
| qr-code | https://qr-code.api.klymax402.com | GET /generate | $0.001 |
| regex-generator | https://regex-generator.api.klymax402.com | POST /test | $0.001 |
| research-report | https://research-report.api.klymax402.com | POST /report | $0.010 |
| screenshot-pdf | https://screenshot-pdf.api.klymax402.com | POST /capture | $0.008 |
| sentiment-analyzer | https://sentiment-analyzer.api.klymax402.com | POST /analyze | $0.005 |
| seo-analyzer | https://seo-analyzer.api.klymax402.com | GET /analyze | $0.020 |
| slug-generator | https://slug-generator.api.klymax402.com | GET /generate | $0.001 |
| sms-validator | https://sms-validator.api.klymax402.com | GET /validate | $0.002 |
| social-profile | https://social-profile.api.klymax402.com | GET /profile | $0.008 |
| solana-fees | https://solana-fees.api.klymax402.com | GET /fees | $0.002 |
| solana-launches | https://solana-launches.api.klymax402.com | GET /launches | $0.003 |
| solana-pools | https://solana-pools.api.klymax402.com | GET /pools | $0.003 |
| ssl-checker | https://ssl-checker.api.klymax402.com | GET /check | $0.002 |
| stock-price | https://stock-price.api.klymax402.com | GET /quote | $0.002 |
| tech-enrichment | https://tech-enrichment.api.klymax402.com | GET /detect | $0.005 |
| text-classifier | https://text-classifier.api.klymax402.com | POST /classify | $0.005 |
| text-to-speech | https://text-to-speech.api.klymax402.com | POST /synthesize | $0.005 |
| text-translator | https://text-translator.api.klymax402.com | POST /translate | $0.005 |
| timezone-converter | https://timezone-converter.api.klymax402.com | GET /convert | $0.001 |
| token-holders | https://token-holders.api.klymax402.com | GET /holders | $0.003 |
| token-ohlcv | https://token-ohlcv.api.klymax402.com | GET /ohlcv | $0.003 |
| token-price | https://token-price.api.klymax402.com | GET /price | $0.001 |
| token-safety | https://token-safety.api.klymax402.com | GET /check | $0.003 |
| trust-score | https://trust-score.api.klymax402.com | GET /score | $0.010 |
| twitter-scraper | https://twitter-scraper.api.klymax402.com | GET /profile or /tweets | $0.005 |
| unit-converter | https://unit-converter.api.klymax402.com | GET /convert | $0.001 |
| url-shortener | https://url-shortener.api.klymax402.com | POST /shorten | $0.001 |
| user-agent-parser | https://user-agent-parser.api.klymax402.com | GET /parse | $0.001 |
| uuid-generator | https://uuid-generator.api.klymax402.com | GET /generate | $0.001 |
| vector-search | https://vector-search.api.klymax402.com | POST /search | $0.002 |
| wallet-portfolio | https://wallet-portfolio.api.klymax402.com | GET /portfolio | $0.003 |
| weather-api | https://weather-api.api.klymax402.com | GET /weather | $0.001 |
| webhook-tester | https://webhook-tester.api.klymax402.com | POST /test | $0.002 |
| web-scraper | https://web-scraper.api.klymax402.com | POST /scrape | $0.005 |
| web-search | https://web-search.api.klymax402.com | GET /search | $0.003 |
| whale-alert | https://whale-alert.api.klymax402.com | GET /alerts | $0.003 |
| word-counter | https://word-counter.api.klymax402.com | POST /count | $0.001 |


## Infrastructure

- Hosting: Hetzner VPS, Frankfurt (eu-central)
- CDN/TLS: Caddy with automatic HTTPS
- Uptime (24h rolling): 99.9%
- Median latency P50: 57ms
- P95 latency: 104ms
- Probe cadence: every 5 minutes across 12 APIs
- All-time transactions: 766
- Unique payers: 207 wallets
- All-time revenue settled: $2.26 USDC on Base


## Links

- Homepage: https://klymax402.com
- llms.txt: https://klymax402.com/llms.txt
- Live stats: https://klymax402.com/stats/
- Prepaid packs: https://klymax402.com/packs/
- Toolkit bundles: https://klymax402.com/bundles/
- MCP endpoint: https://app.ampersend.ai/api/hosted/klymax402/mighty-host/skill
- npm SDK: https://www.npmjs.com/package/x402-agent-tools
- GitHub / SDK: https://github.com/Br0ski777/x402-agent-tools
- ElizaOS plugin: eliza-plugin-klymax402 (npm)
- x402 protocol: https://x402.org