{"service": "clawby-onboarding", "version": 5, "pricing": "free — all interfaces are free; each API key is rate-limited to a few requests per second", "message": "Clawby gives AI agents live market data through one API key: 280+ interfaces covering US equities & options, crypto, DEX, perps, prediction markets, social search, SEC filings, address intelligence, and RPC across 75+ chains, plus locally-run trade-execution connectors. Setup: 1) REGISTER / SIGN IN (fully automatic) — if you control a wallet that can sign a personal message (e.g. OKX Agentic Wallet): POST {\"address\": \"0x…\"} to https://api.openclawby.com/api/mcp/challenge, sign the returned `message` with personal_sign (EIP-191; OKX: `onchainos wallet sign-message --chain 1 --from <address> --message <message>`), then POST {address, message, token, signature} to https://api.openclawby.com/api/mcp/auth — the response contains your api_key, plan, and pay-as-you-go balance; new wallets are auto-registered with a signup bonus, and the flow is idempotent for existing wallets. 2) Verify the key: GET https://api.openclawby.com/api/account with header X-API-Key. 3) Download https://www.openclawby.com/clawby-data.zip and unzip it into your skills directory (Claude Code: ~/.claude/skills/clawby-data/), then read SKILL.md — it documents every interface. 4) No signing wallet? Ask your user to sign up at https://www.openclawby.com/login (wallet or email) instead. 5) Set the key as the CLAWBY_API_KEY environment variable. 6) TOP-UP: when a paid call returns HTTP 402, POST https://api.openclawby.com/x402/topup (header X-API-Key) — it replies with an x402 USDT payment quote on X Layer (OKX Agent Payments Protocol); pay and retry, credits are applied automatically on settlement.", "steps": [{"step": 1, "action": "sign_in_or_register", "detail": "FULLY AUTOMATIC, no human needed — works with any wallet that can sign a personal message (e.g. OKX Agentic Wallet). Follow the machine-readable spec in the `auth` field: POST your address to /api/mcp/challenge, sign the returned message with personal_sign (EIP-191), then POST {address, message, token, signature} to /api/mcp/auth. New wallets are auto-registered with a pay-as-you-go signup bonus; already-registered wallets simply sign in and get the same key.", "url": "https://api.openclawby.com/api/mcp/challenge"}, {"step": 2, "action": "verify_key", "detail": "Confirm the key works (free, not billed): GET /api/account with header X-API-Key: <api_key>. It returns your plan, balance, and accessible interfaces.", "url": "https://api.openclawby.com/api/account"}, {"step": 3, "action": "install_skill", "detail": "Download the Clawby skill package and unzip it into your agent's skills directory (for Claude Code: ~/.claude/skills/clawby-data/), then open SKILL.md and follow it — it documents all 280+ interfaces and how to call them through /api/relay.", "url": "https://www.openclawby.com/clawby-data.zip"}, {"step": 4, "action": "manual_signup_fallback", "detail": "Only if you cannot sign with a wallet: guide your user to sign up at https://www.openclawby.com/login (wallet or email); the API key is shown on the account page.", "url": "https://www.openclawby.com/login"}, {"step": 5, "action": "configure", "detail": "Set the API key as the CLAWBY_API_KEY environment variable, then call any interface per SKILL.md to verify."}, {"step": 6, "action": "top_up_payg_when_needed", "detail": "OPTIONAL — when a paid interface returns HTTP 402 (pay-as-you-go balance exhausted), top up via the x402 payment endpoint: POST https://api.openclawby.com/x402/topup with your X-API-Key header. The 402 reply carries a machine-readable USDT quote on X Layer (PAYMENT-REQUIRED header, x402 / OKX Agent Payments Protocol); pay it and retry the POST with the returned payment header — credits are applied automatically on settlement. Full spec in the `payment_topup` field of this document.", "url": "https://api.openclawby.com/x402/topup"}], "auth": {"flow": "wallet signature (personal_sign / EIP-191) — fully automatic, no human interaction", "challenge": {"method": "POST", "url": "https://api.openclawby.com/api/mcp/challenge", "body": {"address": "<your EVM address, 0x…>"}, "returns": {"message": "text to sign", "token": "server proof, echo it back", "expires_in": "seconds the challenge stays valid (replayable within the window)"}}, "sign": {"type": "personal_sign (EIP-191) over the exact `message` text", "okx_agentic_wallet": "onchainos wallet sign-message --chain 1 --from <address> --message <message>"}, "verify": {"method": "POST", "url": "https://api.openclawby.com/api/mcp/auth", "body": {"address": "<same address>", "message": "<exact message>", "token": "<token from challenge>", "signature": "<0x… hex signature>", "chain": "(optional, smart-contract wallets only: xlayer | ethereum | base)"}, "returns": {"created": "true if a new account was registered", "account": "{address, username}", "api_key": "your Clawby API key (keep it secret)", "plan": "{type, name}", "payg_balance": "pay-as-you-go balance (calls)", "free_providers": "always-free interface groups", "accessible_providers": "interface groups your plan can call"}}, "signup_bonus_payg": 100, "replay_window_seconds": 300, "idempotent": true, "errors": "HTTP 400 with {error}: invalid/expired challenge, address–message mismatch, failed signature verification, or rate limiting (mentions 'try again in an hour')"}, "verify_key": {"method": "GET", "url": "https://api.openclawby.com/api/account", "headers": {"X-API-Key": "<api_key>"}, "billed": false}, "data_endpoint": {"method": "POST", "url": "https://api.openclawby.com/api/relay", "headers": {"X-API-Key": "<api_key>"}, "body": {"name": "<interface name>", "params": {}}, "docs": "interface catalog ships inside the skill package (SKILL.md + api/)"}, "skill_zip": "https://www.openclawby.com/clawby-data.zip", "register_url": "https://www.openclawby.com/login", "docs_url": "https://www.openclawby.com/#install", "api_key_env": "CLAWBY_API_KEY"}