{"openapi":"3.1.0","info":{"title":"BlockRun AI Gateway","version":"1.0.0","description":"Agent-native AI gateway. Pay-per-request with USDC on Base. No accounts or API keys required.","x-logo":{"url":"https://blockrun.ai/brand/logo-256.png","altText":"BlockRun"}},"servers":[{"url":"https://blockrun.ai"}],"paths":{"/api/v1/chat/completions":{"post":{"operationId":"chatCompletions","summary":"Chat Completions","description":"Access 40+ frontier LLMs with OpenAI-compatible API. Price depends on model and token usage.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.0001","max":"5.00"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","description":"Model ID to use for completion","enum":["openai/gpt-5.5","openai/gpt-5.4","openai/gpt-5.4-pro","openai/gpt-5.3","openai/gpt-5.2","openai/gpt-5.4-mini","openai/gpt-5-mini","openai/gpt-5.4-nano","openai/gpt-5.2-pro","openai/gpt-5.3-codex","openai/o1","openai/o1-mini","openai/o3","openai/o3-mini","anthropic/claude-haiku-4.5","anthropic/claude-sonnet-4.6","anthropic/claude-opus-4.5","anthropic/claude-opus-4.7","google/gemini-3.1-pro","google/gemini-3-pro-preview","google/gemini-3-flash-preview","google/gemini-2.5-pro","google/gemini-2.5-flash","google/gemini-3.1-flash-lite","google/gemini-2.5-flash-lite","deepseek/deepseek-v4-pro","deepseek/deepseek-chat","deepseek/deepseek-reasoner","moonshot/kimi-k2.6","zai/glm-5.1","zai/glm-5","zai/glm-5-turbo","minimax/minimax-m2.7","nvidia/deepseek-v4-flash","nvidia/nemotron-3-nano-omni-30b-a3b-reasoning","nvidia/qwen3-coder-480b","nvidia/llama-4-maverick","nvidia/qwen3-next-80b-a3b-thinking","nvidia/mistral-small-4-119b"]},"messages":{"type":"array","description":"Array of chat messages","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant"]},"content":{"type":"string"}}}},"max_tokens":{"type":"integer","description":"Maximum tokens to generate","minimum":1,"maximum":128000},"temperature":{"type":"number","description":"Sampling temperature (0-2)","minimum":0,"maximum":2},"stream":{"type":"boolean","description":"Enable streaming responses"}}}}}},"responses":{"200":{"description":"Successful completion"},"402":{"description":"Payment Required"}}}},"/api/v1/messages":{"post":{"operationId":"anthropicMessages","summary":"Anthropic Messages","description":"Anthropic-shaped Messages API. Send Claude-style requests (system + messages array, tools, tool_choice) and BlockRun routes them through the right upstream provider. Token-priced like /chat/completions.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.0001","max":"5.00"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages","max_tokens"],"properties":{"model":{"type":"string","description":"Anthropic model id (or any BlockRun-routable Anthropic alias).","enum":["anthropic/claude-haiku-4.5","anthropic/claude-sonnet-4.6","anthropic/claude-opus-4.5","anthropic/claude-opus-4.7"]},"messages":{"type":"array","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["user","assistant"]},"content":{"description":"String, or array of Anthropic content blocks (text/image/tool_use/tool_result).","oneOf":[{"type":"string"},{"type":"array","items":{"type":"object"}}]}}}},"system":{"description":"System prompt — string, or array of { type: 'text', text }.","oneOf":[{"type":"string"},{"type":"array","items":{"type":"object"}}]},"max_tokens":{"type":"integer","minimum":1,"description":"Maximum tokens to generate."},"temperature":{"type":"number","minimum":0,"maximum":1},"top_p":{"type":"number","minimum":0,"maximum":1},"top_k":{"type":"integer","minimum":0},"stop_sequences":{"type":"array","items":{"type":"string"}},"stream":{"type":"boolean","description":"Server-Sent Events stream of Anthropic-style deltas."},"tools":{"type":"array","items":{"type":"object"},"description":"Anthropic tool definitions."},"tool_choice":{"type":"object","description":"Anthropic tool_choice spec."},"metadata":{"type":"object","properties":{"user_id":{"type":"string"}}}}}}}},"responses":{"200":{"description":"Anthropic-shaped Message response (or SSE stream when stream=true)."},"402":{"description":"Payment Required"}}}},"/api/v1/search":{"post":{"operationId":"search","summary":"Grok Live Search","description":"Real-time web and news search powered by xAI Grok with live data access.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.025","max":"1.25"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Search query","minLength":1,"maxLength":1000},"sources":{"type":"array","description":"Data sources to search","items":{"type":"string","enum":["x","web","news"]},"default":["x","web"]},"max_results":{"type":"integer","description":"Maximum number of results per source","minimum":1,"maximum":50,"default":10}}}}}},"responses":{"200":{"description":"Search results"},"402":{"description":"Payment Required"}}}},"/api/v1/images/generations":{"post":{"operationId":"imageGenerations","summary":"Image Generation","description":"Generate images with DALL-E 3, GPT Image 1, or ChatGPT Images 2.0.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.02","max":"0.08"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"model":{"type":"string","description":"Image model to use","enum":["openai/dall-e-3","openai/gpt-image-1","openai/gpt-image-2"]},"prompt":{"type":"string","description":"Text description of the image to generate","minLength":1,"maxLength":4000},"size":{"type":"string","description":"Image dimensions","enum":["1024x1024","1792x1024","1024x1792"],"default":"1024x1024"},"n":{"type":"integer","description":"Number of images to generate","minimum":1,"maximum":4,"default":1}}}}}},"responses":{"200":{"description":"Generated images"},"402":{"description":"Payment Required"}}}},"/api/v1/images/generations/{id}":{"get":{"operationId":"imageGenerationsPoll","summary":"Poll Image Generation Job","description":"Poll an in-flight image generation job. Send the SAME x-payment header used in the POST that created this job. Returns { status: 'queued' | 'in_progress' } until upstream finishes; on the first poll where upstream=completed we settle payment and return the image URLs.","x-agentcash-auth":{"mode":"paid"},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Job id returned from POST /api/v1/images/generations."}],"responses":{"200":{"description":"Job completed — response body contains image URLs and the settlement receipt (or 'already_settled' on idempotent re-poll)."},"202":{"description":"Job still queued or in_progress — poll again."},"402":{"description":"Payment verification or settlement failed."},"404":{"description":"Job not found (expired or never created)."}}}},"/api/v1/images/image2image":{"post":{"operationId":"imageEdit","summary":"Image-to-Image Edit","description":"Edit or vary an existing image with a text prompt. Send the source image (and optional mask) as a base64 data URI. Powered by OpenAI gpt-image-1 / gpt-image-2.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.02","max":"0.08"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt","image"],"properties":{"model":{"type":"string","enum":["openai/gpt-image-1","openai/gpt-image-2"],"default":"openai/gpt-image-2"},"prompt":{"type":"string","description":"Edit instructions for the image."},"image":{"type":"string","description":"Source image as base64 data URI (data:image/png;base64,...).","pattern":"^data:image/"},"mask":{"type":"string","description":"Optional mask as base64 data URI; transparent pixels mark the editable region.","pattern":"^data:image/"},"size":{"type":"string","enum":["1024x1024","1792x1024","1024x1792"],"default":"1024x1024"},"n":{"type":"integer","minimum":1,"maximum":4,"default":1}}}}}},"responses":{"200":{"description":"Edited image(s)"},"402":{"description":"Payment Required"}}}},"/api/v1/audio/generations":{"post":{"operationId":"audioGenerations","summary":"Music Generation","description":"Generate music tracks with Minimax Music 2.5 / 2.5+. Provide a text prompt describing the song; optionally supply lyrics or set instrumental=true. Price scales with duration.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.02","max":"0.84"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"model":{"type":"string","enum":["minimax/music-2.5+"],"default":"minimax/music-2.5+"},"prompt":{"type":"string","description":"High-level description of the song (genre, mood, instrumentation)."},"lyrics":{"type":"string","description":"Optional song lyrics. Ignored when instrumental=true."},"instrumental":{"type":"boolean","default":false,"description":"If true, generate an instrumental track."},"duration_seconds":{"type":"integer","minimum":5,"maximum":240,"default":30}}}}}},"responses":{"200":{"description":"Generated audio (MP3 URL + metadata)."},"402":{"description":"Payment Required"}}}},"/api/v1/videos/generations":{"post":{"operationId":"videoGenerationsSubmit","summary":"Submit Video Generation Job","description":"Submit an async video generation job with xAI Grok Imagine or ByteDance Seedance (1.5 Pro / 2.0 Fast / 2.0 Pro). Billed per second. Returns `{ id, poll_url }` in ~3-20s with payment verified but NOT settled. Poll GET /api/v1/videos/generations/{id} with the same x-payment header until status=completed — settlement fires on that poll. If upstream fails or you never poll, you are not charged.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.15","max":"3.15"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"model":{"type":"string","description":"Video model to use","enum":["xai/grok-imagine-video","bytedance/seedance-1.5-pro","bytedance/seedance-2.0-fast","bytedance/seedance-2.0"],"default":"xai/grok-imagine-video"},"prompt":{"type":"string","description":"Text description of the video to generate","minLength":1,"maxLength":4000},"image_url":{"type":"string","format":"uri","description":"Optional seed image URL for image-to-video. Mutually exclusive with real_face_asset_id."},"real_face_asset_id":{"type":"string","pattern":"^ta_[A-Za-z0-9]+$","description":"Optional BytePlus RealFace asset id (format `ta_xxxxxxxx`) for consistent real-person character video. Only Seedance 2.0 / 2.0-fast support it. Get the id from token360's Asset UI after H5 verification. Mutually exclusive with image_url."},"duration_seconds":{"type":"integer","minimum":1,"maximum":60,"description":"Duration billed for (defaults to model default)"}}}}}},"responses":{"202":{"description":"Job accepted. Response body contains { id, poll_url, status: 'queued' }. Payment verified, not yet settled."},"402":{"description":"Payment Required"},"504":{"description":"Upstream submit timed out (no payment taken)"}}}},"/api/v1/videos/generations/{id}":{"get":{"operationId":"videoGenerationsPoll","summary":"Poll Video Generation Job","description":"Poll an in-flight video generation job. Send the SAME x-payment header used in the POST that created this job. Returns { status: 'queued' | 'in_progress' } until upstream finishes; on the first poll where upstream=completed we settle payment and return the MP4 URL.","x-agentcash-auth":{"mode":"paid"},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Composite job id returned from the POST (format: '{provider}:{upstreamId}')."},{"name":"model","in":"query","required":true,"schema":{"type":"string"},"description":"Same model id used in the POST."},{"name":"duration","in":"query","required":true,"schema":{"type":"integer"},"description":"Same duration_seconds used in the POST."}],"responses":{"200":{"description":"Job completed — response body contains the video URL and settlement receipt (or 'already_settled' on idempotent re-poll)."},"202":{"description":"Job still queued or in_progress — poll again."},"402":{"description":"Payment verification or settlement failed."},"504":{"description":"Upstream poll timed out — retry in a few seconds."}}}},"/api/v1/exa/search":{"post":{"operationId":"exaSearch","summary":"Exa Web Search","description":"Neural and keyword web search powered by Exa. Optional category filter: company, research paper, news, pdf, github, tweet, personal site, linkedin profile, financial report.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Search query."},"type":{"type":"string","enum":["neural","keyword","auto"],"default":"auto"},"numResults":{"type":"integer","minimum":1,"maximum":100,"default":10},"category":{"type":"string","description":"Optional category filter (company, research paper, news, pdf, github, tweet, personal site, linkedin profile, financial report)."},"includeDomains":{"type":"array","items":{"type":"string"}},"excludeDomains":{"type":"array","items":{"type":"string"}},"startPublishedDate":{"type":"string","description":"ISO-8601 date."},"endPublishedDate":{"type":"string","description":"ISO-8601 date."}}}}}},"responses":{"200":{"description":"Exa search results."},"402":{"description":"Payment Required"}}}},"/api/v1/exa/find-similar":{"post":{"operationId":"exaFindSimilar","summary":"Exa Find Similar","description":"Find pages semantically similar to a given URL.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Source URL to find pages similar to."},"numResults":{"type":"integer","minimum":1,"maximum":100,"default":10},"excludeSourceDomain":{"type":"boolean","default":true}}}}}},"responses":{"200":{"description":"Similar pages."},"402":{"description":"Payment Required"}}}},"/api/v1/exa/contents":{"post":{"operationId":"exaContents","summary":"Exa Contents","description":"Extract full text content from one or more URLs. Priced per URL ($0.002 each).","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.002","max":"0.20"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["urls"],"properties":{"urls":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"string","format":"uri"},"description":"List of URLs to extract content from. Price scales linearly: $0.002 × number of URLs."},"text":{"type":"boolean","default":true,"description":"Include extracted text."},"highlights":{"type":"object","description":"Exa highlights config."},"summary":{"type":"object","description":"Exa summary config."}}}}}},"responses":{"200":{"description":"Extracted page contents."},"402":{"description":"Payment Required"}}}},"/api/v1/exa/answer":{"post":{"operationId":"exaAnswer","summary":"Exa Answer","description":"Get an AI-generated answer to a question grounded in live web search results.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Question to answer with grounded search."},"text":{"type":"boolean","default":false,"description":"Include full text of cited pages in response."}}}}}},"responses":{"200":{"description":"Generated answer with citations."},"402":{"description":"Payment Required"}}}},"/api/v1/modal/sandbox/create":{"post":{"operationId":"modalSandboxCreate","summary":"Create Modal Sandbox","description":"Create a managed Python 3.11 sandbox with bounded CPU, memory, and lifetime limits. GPU sandboxes (T4/L4/A10G/A100/H100) upgrade to per-type pricing — see `/pricing`.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.01","max":"1.50"},"protocols":[{"x402":{}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"image":{"type":"string","enum":["python:3.11"],"default":"python:3.11","description":"Managed image. Only python:3.11 is currently available."},"timeout":{"type":"integer","minimum":1,"maximum":300,"default":300,"description":"Sandbox lifetime in seconds."},"cpu":{"type":"number","minimum":0.1,"maximum":8,"default":1,"description":"CPU cores. CPU-only max is 1; GPU sandboxes can request up to 8."},"memory":{"type":"integer","minimum":128,"maximum":16384,"default":512,"description":"Memory in MB. CPU-only max is 1024; GPU sandboxes can request up to 16384."},"gpu":{"type":"string","enum":["T4","L4","A10G","A100","H100"],"description":"Optional GPU type. Pricing replaces the CPU base price for the full sandbox lifetime."}}}}}},"responses":{"200":{"description":"Sandbox created"},"400":{"description":"Invalid request body"},"402":{"description":"Payment Required"}}}},"/api/v1/modal/sandbox/exec":{"post":{"operationId":"modalSandboxExec","summary":"Execute In Modal Sandbox","description":"Execute a command inside an existing managed Modal sandbox.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["sandbox_id","command"],"properties":{"sandbox_id":{"type":"string","description":"Sandbox ID returned by /api/v1/modal/sandbox/create"},"command":{"type":"array","minItems":1,"maxItems":32,"items":{"type":"string","minLength":1,"maxLength":2000},"description":"Command segments to execute, e.g. ['python', '-c', 'print(1)']"},"timeout":{"type":"integer","minimum":1,"maximum":60,"default":60,"description":"Execution timeout in seconds."}}}}}},"responses":{"200":{"description":"Command output"},"400":{"description":"Invalid request body"},"402":{"description":"Payment Required"}}}},"/api/v1/modal/sandbox/status":{"post":{"operationId":"modalSandboxStatus","summary":"Check Modal Sandbox Status","description":"Check whether a sandbox is still running or has terminated.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["sandbox_id"],"properties":{"sandbox_id":{"type":"string","description":"Sandbox ID returned by /api/v1/modal/sandbox/create"}}}}}},"responses":{"200":{"description":"Sandbox status"},"400":{"description":"Invalid request body"},"402":{"description":"Payment Required"}}}},"/api/v1/modal/sandbox/terminate":{"post":{"operationId":"modalSandboxTerminate","summary":"Terminate Modal Sandbox","description":"Terminate a running sandbox and release its resources.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["sandbox_id"],"properties":{"sandbox_id":{"type":"string","description":"Sandbox ID returned by /api/v1/modal/sandbox/create"}}}}}},"responses":{"200":{"description":"Sandbox terminated"},"400":{"description":"Invalid request body"},"402":{"description":"Payment Required"}}}},"/api/v1/voice/call":{"post":{"operationId":"voiceCallInitiate","summary":"Initiate AI Voice Call","description":"Place an outbound AI conversation call via Bland.ai. The agent calls the recipient and converses based on `task` (natural-language instructions). Requires `from` — a wallet-owned phone number provisioned via /api/v1/phone/numbers/buy. Returns a call_id immediately; poll GET /api/v1/voice/call/{call_id} for status, transcript, and recording.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.54"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["to","task","from"],"properties":{"to":{"type":"string","description":"Destination phone number in E.164 format, e.g. +14155552671."},"task":{"type":"string","minLength":10,"maxLength":4000,"description":"Natural-language description of what the AI agent should do on the call."},"from":{"type":"string","description":"Wallet-owned phone number used as caller ID (E.164). Required — purchase one via /api/v1/phone/numbers/buy first."},"voice":{"type":"string","description":"Voice preset: nat, josh, maya, june, paige, derek, florian — or a Bland.ai voice ID."},"max_duration":{"type":"integer","minimum":1,"maximum":30,"default":5,"description":"Maximum call length in minutes."},"language":{"type":"string","default":"en-US","description":"Language code for STT/TTS."},"first_sentence":{"type":"string","maxLength":500,"description":"Optional fixed opening line spoken before the AI takes over."},"wait_for_greeting":{"type":"boolean","description":"If true, AI waits for the recipient to speak first."},"interruption_threshold":{"type":"integer","minimum":50,"maximum":500,"description":"How aggressive the AI is about interrupting (ms)."},"model":{"type":"string","enum":["base","enhanced","turbo"],"description":"Bland conversation model tier."}}}}}},"responses":{"200":{"description":"Call initiated; returns call_id"},"400":{"description":"Invalid request body (e.g. missing `from`)"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden (emergency number or `from` not owned)"},"502":{"description":"Bland.ai rejected the call (payment NOT charged)"}}}},"/api/v1/voice/call/{call_id}":{"get":{"operationId":"voiceCallStatus","summary":"Poll Voice Call Status","description":"Poll status, duration, full transcript, recording URL, and answered_by (human / voicemail / no-answer) for a previously initiated call. Free — no payment required.","parameters":[{"name":"call_id","in":"path","required":true,"schema":{"type":"string"},"description":"Call ID returned by POST /api/v1/voice/call."}],"responses":{"200":{"description":"Call status payload"},"404":{"description":"Unknown call_id"}}}},"/api/v1/phone/numbers/buy":{"post":{"operationId":"phoneNumbersBuy","summary":"Provision Phone Number (30-day lease)","description":"Lease a US or Canadian phone number for 30 days, wallet-bound. Auto-registered with Bland on purchase so it can be used as outbound caller-ID via /api/v1/voice/call. Twilio purchase runs before settlement — failed Twilio purchases are not charged.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"5.00"},"protocols":[{"x402":{}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","enum":["US","CA"],"default":"US","description":"ISO country code: US or CA."},"areaCode":{"type":"string","description":"Optional preferred 3-digit area code (availability not guaranteed)."}}}}}},"responses":{"200":{"description":"Number provisioned"},"402":{"description":"Payment Required"},"404":{"description":"No numbers available for the country/areaCode"},"502":{"description":"Twilio purchase failed (payment NOT charged)"}}}},"/api/v1/phone/numbers/renew":{"post":{"operationId":"phoneNumbersRenew","summary":"Renew Phone Number Lease","description":"Extend an existing wallet-owned number lease by 30 days.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"5.00"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["phoneNumber"],"properties":{"phoneNumber":{"type":"string","description":"Number to renew (E.164, must be owned by the calling wallet)."}}}}}},"responses":{"200":{"description":"Lease extended"},"402":{"description":"Payment Required"},"403":{"description":"Not owned by wallet, or expired"}}}},"/api/v1/phone/numbers/list":{"post":{"operationId":"phoneNumbersList","summary":"List Wallet-Owned Phone Numbers","description":"Return all active numbers leased to the calling wallet. Tiny x402 charge confirms wallet identity.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}},"responses":{"200":{"description":"Array of phone numbers + expiry"},"402":{"description":"Payment Required"}}}},"/api/v1/phone/numbers/release":{"post":{"operationId":"phoneNumbersRelease","summary":"Release Phone Number","description":"Release a wallet-owned number back to the Twilio pool. Free, but still goes through x402 so the wallet identity is verified.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["phoneNumber"],"properties":{"phoneNumber":{"type":"string","description":"Number to release (E.164, must be owned by the calling wallet)."}}}}}},"responses":{"200":{"description":"Number released"},"403":{"description":"Not owned by wallet"},"404":{"description":"Number not found"}}}},"/api/v1/phone/lookup":{"post":{"operationId":"phoneLookup","summary":"Phone Number Carrier Lookup","description":"Look up carrier and line type (landline / mobile / VoIP) for any phone number via Twilio Lookup.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["phoneNumber"],"properties":{"phoneNumber":{"type":"string","description":"Phone number to look up (E.164)."}}}}}},"responses":{"200":{"description":"Carrier + line type"},"402":{"description":"Payment Required"}}}},"/api/v1/phone/lookup/fraud":{"post":{"operationId":"phoneLookupFraud","summary":"Phone Number Fraud Lookup","description":"Carrier + fraud signals (SIM swap, call forwarding) via Twilio Lookup. Useful for KYC and account-takeover defenses.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["phoneNumber"],"properties":{"phoneNumber":{"type":"string","description":"Phone number to look up (E.164)."}}}}}},"responses":{"200":{"description":"Carrier + fraud signals"},"402":{"description":"Payment Required"}}}},"/api/v1/surf/exchange/price":{"get":{"operationId":"surfExchangePrice","summary":"Surf — CEX Ticker Price","description":"Live ticker price for a CEX trading pair (Binance, OKX, Bybit, Coinbase, …).","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Ticker price"},"402":{"description":"Payment Required"}}}},"/api/v1/surf/exchange/klines":{"get":{"operationId":"surfExchangeKlines","summary":"Surf — CEX OHLCV Candlesticks","description":"OHLCV candlesticks for a CEX pair at any interval.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Candles"},"402":{"description":"Payment Required"}}}},"/api/v1/surf/exchange/funding-history":{"get":{"operationId":"surfExchangeFunding","summary":"Surf — Perp Funding Rate History","description":"Funding rate history for a perpetual contract.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Funding history"},"402":{"description":"Payment Required"}}}},"/api/v1/surf/market/price":{"get":{"operationId":"surfMarketPrice","summary":"Surf — Token Price History","description":"Token price history. Pass ?symbol=BTC.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Price history"},"402":{"description":"Payment Required"}}}},"/api/v1/surf/market/ranking":{"get":{"operationId":"surfMarketRanking","summary":"Surf — Token Rankings","description":"Token rankings by market cap, volume, or change.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Ranking list"},"402":{"description":"Payment Required"}}}},"/api/v1/surf/market/fear-greed":{"get":{"operationId":"surfFearGreed","summary":"Surf — Fear & Greed Index History","description":"Daily Fear & Greed index history.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Index history"},"402":{"description":"Payment Required"}}}},"/api/v1/surf/market/etf":{"get":{"operationId":"surfMarketEtf","summary":"Surf — Spot ETF Flow History","description":"BTC/ETH spot ETF flow history (daily inflows / outflows).","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"ETF flows"},"402":{"description":"Payment Required"}}}},"/api/v1/surf/market/onchain-indicator":{"get":{"operationId":"surfOnchainIndicator","summary":"Surf — On-Chain Indicator","description":"NUPL, SOPR, MVRV, Puell Multiple, NVT.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Indicator"},"402":{"description":"Payment Required"}}}},"/api/v1/surf/onchain/gas-price":{"get":{"operationId":"surfGasPrice","summary":"Surf — Current Gas Price","description":"Current gas price across supported chains.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Gas snapshot"},"402":{"description":"Payment Required"}}}},"/api/v1/surf/onchain/tx":{"get":{"operationId":"surfOnchainTx","summary":"Surf — Transaction Details by Hash","description":"Transaction details by hash.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Tx detail"},"402":{"description":"Payment Required"}}}},"/api/v1/surf/onchain/sql":{"post":{"operationId":"surfOnchainSql","summary":"Surf — Raw SQL on Blockchain Tables","description":"Raw SQL query against 80+ analyst-ready ClickHouse tables (DEX trades, transfers, lending, staking, bridges). Sub-second.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["sql"],"properties":{"sql":{"type":"string","description":"ClickHouse SQL — see /api/v1/surf/onchain/schema for tables."}}}}}},"responses":{"200":{"description":"Query rows"},"402":{"description":"Payment Required"}}}},"/api/v1/surf/wallet/detail":{"get":{"operationId":"surfWalletDetail","summary":"Surf — Aggregated Wallet Profile","description":"Cross-chain wallet profile + labels + balances.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Wallet detail"},"402":{"description":"Payment Required"}}}},"/api/v1/surf/wallet/labels/batch":{"get":{"operationId":"surfWalletLabelsBatch","summary":"Surf — Batch Wallet Labels","description":"Batch lookup wallet labels (CEX, Whale, Bridge, MEV, Bot, Fund) across 13 chains. 100M+ labeled addresses.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Labels"},"402":{"description":"Payment Required"}}}},"/api/v1/surf/social/mindshare":{"get":{"operationId":"surfSocialMindshare","summary":"Surf — Project Mindshare Time Series","description":"Project mindshare on Crypto Twitter over time.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Mindshare series"},"402":{"description":"Payment Required"}}}},"/api/v1/surf/news/feed":{"get":{"operationId":"surfNewsFeed","summary":"Surf — AI-Curated News Feed","description":"AI-curated crypto news feed aggregated from 30+ sources.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"News feed"},"402":{"description":"Payment Required"}}}},"/api/v1/surf/prediction-market/polymarket/markets":{"get":{"operationId":"surfPolymarketMarkets","summary":"Surf — Polymarket Markets","description":"Polymarket markets list. Cross-platform with /prediction-market/kalshi/* for arbitrage.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Markets"},"402":{"description":"Payment Required"}}}},"/api/v1/surf/search/wallet":{"get":{"operationId":"surfSearchWallet","summary":"Surf — Wallet Search","description":"Wallet search by address, ENS, or label (CEX, Whale, etc.).","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Wallet matches"},"402":{"description":"Payment Required"}}}},"/api/v1/defillama/protocols":{"get":{"operationId":"defiLlamaProtocols","summary":"DefiLlama Protocols — list","description":"List of every DeFi protocol DefiLlama tracks, with current and historical TVL across chains. DefiLlama is open Apache 2.0; this endpoint is a paid wrapper that adds metering and reliability.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Array of protocols with TVL and chain breakdown."},"402":{"description":"Payment Required"}}}},"/api/v1/defillama/protocol/{slug}":{"get":{"operationId":"defiLlamaProtocol","summary":"DefiLlama Protocol — single","description":"Detailed TVL + breakdown for a single protocol identified by DefiLlama slug.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"DefiLlama protocol slug, e.g. `aave`, `uniswap`, `lido`."}],"responses":{"200":{"description":"Protocol details (passthrough)."},"402":{"description":"Payment Required"},"404":{"description":"Protocol slug not found."}}}},"/api/v1/defillama/chains":{"get":{"operationId":"defiLlamaChains","summary":"DefiLlama Chains — TVL by chain","description":"TVL for every chain DefiLlama tracks.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Array of chains with TVL."},"402":{"description":"Payment Required"}}}},"/api/v1/defillama/yields":{"get":{"operationId":"defiLlamaYields","summary":"DefiLlama Yields — pools","description":"Every tracked DeFi yield pool (lending / LP / staking / vaults) with current APY and TVL.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Array of pools with APY/TVL."},"402":{"description":"Payment Required"}}}},"/api/v1/defillama/prices/{coins}":{"get":{"operationId":"defiLlamaPrices","summary":"DefiLlama Prices — token price lookup","description":"Token price lookup. `coins` accepts comma-separated identifiers in DefiLlama's coin syntax (e.g. `coingecko:bitcoin`, `ethereum:0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2`, `solana:So11111111111111111111111111111111111111112`).","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"parameters":[{"name":"coins","in":"path","required":true,"schema":{"type":"string"},"description":"Comma-separated coin identifiers."}],"responses":{"200":{"description":"Object keyed by coin id with price/symbol/timestamp."},"402":{"description":"Payment Required"}}}},"/api/v1/solana/rpc":{"post":{"operationId":"solanaRpc","summary":"Solana JSON-RPC passthrough","description":"Standard Solana JSON-RPC fronted by BlockRun. Forwards your call to public mainnet-beta and bills $0.0005 per call (or per element of a JSON-RPC batch). Use any documented Solana RPC method (getAccountInfo, getTokenSupply, sendTransaction, etc.). v1 is single-provider passthrough; future iterations will load-balance across multiple public RPCs and cache hot reads.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0005"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"}]},"method":{"type":"string","description":"Solana RPC method."},"params":{"type":"array","items":{}}}},{"type":"array","items":{"type":"object"},"description":"JSON-RPC batch — billed per element."}]}}}},"responses":{"200":{"description":"Solana RPC response (passthrough)."},"400":{"description":"Body is not a valid JSON-RPC request."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/polymarket/markets":{"get":{"operationId":"predexon_polymarket_markets","summary":"Query Polymarket markets with filtering, sorting, and pagination","description":"Query Polymarket markets with filtering, sorting, and pagination Provider: Predexon (polymarket). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/polymarket/markets/keyset":{"get":{"operationId":"predexon_polymarket_markets_keyset","summary":"List Polymarket markets with cursor-based keyset pagination (same filters as /polymarket/markets)","description":"List Polymarket markets with cursor-based keyset pagination (same filters as /polymarket/markets) Provider: Predexon (polymarket). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/polymarket/events":{"get":{"operationId":"predexon_polymarket_events","summary":"List Polymarket events with filtering and sorting","description":"List Polymarket events with filtering and sorting Provider: Predexon (polymarket). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/polymarket/events/keyset":{"get":{"operationId":"predexon_polymarket_events_keyset","summary":"List Polymarket events with cursor-based keyset pagination","description":"List Polymarket events with cursor-based keyset pagination Provider: Predexon (polymarket). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/polymarket/crypto-updown":{"get":{"operationId":"predexon_polymarket_crypto_updown","summary":"List crypto up/down prediction markets","description":"List crypto up/down prediction markets Provider: Predexon (polymarket). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/polymarket/orderbooks":{"get":{"operationId":"predexon_polymarket_orderbooks","summary":"Get historical orderbook snapshots for a token","description":"Get historical orderbook snapshots for a token Provider: Predexon (polymarket). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/polymarket/trades":{"get":{"operationId":"predexon_polymarket_trades","summary":"Query historical Polymarket trade data with flexible filtering","description":"Query historical Polymarket trade data with flexible filtering Provider: Predexon (polymarket). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/polymarket/activity":{"get":{"operationId":"predexon_polymarket_activity","summary":"Fetch trading activity (merges, splits, redeems) for a user","description":"Fetch trading activity (merges, splits, redeems) for a user Provider: Predexon (polymarket). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/polymarket/positions":{"get":{"operationId":"predexon_polymarket_positions","summary":"Fetch all user positions with filtering and pagination","description":"Fetch all user positions with filtering and pagination Provider: Predexon (polymarket). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/polymarket/leaderboard":{"get":{"operationId":"predexon_polymarket_leaderboard","summary":"Get the global leaderboard of smart wallets","description":"Get the global leaderboard of smart wallets Provider: Predexon (polymarket). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/polymarket/cohorts/stats":{"get":{"operationId":"predexon_polymarket_cohorts_stats","summary":"Compare performance across trading style cohorts","description":"Compare performance across trading style cohorts Provider: Predexon (polymarket). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/polymarket/wallets/profiles":{"get":{"operationId":"predexon_polymarket_wallets_profiles","summary":"Batch retrieve wallet profiles for multiple addresses","description":"Batch retrieve wallet profiles for multiple addresses Provider: Predexon (polymarket). Tier 2 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/polymarket/wallets/filter":{"get":{"operationId":"predexon_polymarket_wallets_filter","summary":"Filter wallets by market trades with AND/OR logic","description":"Filter wallets by market trades with AND/OR logic Provider: Predexon (polymarket). Tier 2 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/polymarket/markets/smart-activity":{"get":{"operationId":"predexon_polymarket_markets_smart_activity","summary":"Discover markets where high-performing wallets are active","description":"Discover markets where high-performing wallets are active Provider: Predexon (polymarket). Tier 2 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/kalshi/markets":{"get":{"operationId":"predexon_kalshi_markets","summary":"Query Kalshi markets with filtering, sorting, and pagination","description":"Query Kalshi markets with filtering, sorting, and pagination Provider: Predexon (kalshi). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/kalshi/trades":{"get":{"operationId":"predexon_kalshi_trades","summary":"Fetch historical Kalshi trade data","description":"Fetch historical Kalshi trade data Provider: Predexon (kalshi). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/kalshi/orderbooks":{"get":{"operationId":"predexon_kalshi_orderbooks","summary":"Fetch historical orderbook snapshots for a Kalshi market","description":"Fetch historical orderbook snapshots for a Kalshi market Provider: Predexon (kalshi). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/dflow/trades":{"get":{"operationId":"predexon_dflow_trades","summary":"Fetch trade history for a wallet on dFlow","description":"Fetch trade history for a wallet on dFlow Provider: Predexon (dflow). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/matching-markets":{"get":{"operationId":"predexon_matching_markets","summary":"Find equivalent markets across Polymarket and Kalshi","description":"Find equivalent markets across Polymarket and Kalshi Provider: Predexon (matching). Tier 2 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/matching-markets/pairs":{"get":{"operationId":"predexon_matching_markets_pairs","summary":"Get all active exact-matched market pairs","description":"Get all active exact-matched market pairs Provider: Predexon (matching). Tier 2 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/markets/search":{"get":{"operationId":"predexon_markets_search","summary":"Search markets across Polymarket, Kalshi, Limitless, Opinion, and Predict.Fun in a single call","description":"Search markets across Polymarket, Kalshi, Limitless, Opinion, and Predict.Fun in a single call Provider: Predexon (matching). Tier 2 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/limitless/markets":{"get":{"operationId":"predexon_limitless_markets","summary":"List Limitless markets with filtering and sorting","description":"List Limitless markets with filtering and sorting Provider: Predexon (limitless). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/limitless/orderbooks":{"get":{"operationId":"predexon_limitless_orderbooks","summary":"Fetch historical orderbook snapshots for a Limitless market","description":"Fetch historical orderbook snapshots for a Limitless market Provider: Predexon (limitless). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/opinion/markets":{"get":{"operationId":"predexon_opinion_markets","summary":"List Opinion markets with filtering and sorting","description":"List Opinion markets with filtering and sorting Provider: Predexon (opinion). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/opinion/orderbooks":{"get":{"operationId":"predexon_opinion_orderbooks","summary":"Fetch historical orderbook snapshots for an Opinion market","description":"Fetch historical orderbook snapshots for an Opinion market Provider: Predexon (opinion). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/predictfun/markets":{"get":{"operationId":"predexon_predictfun_markets","summary":"List Predict.Fun markets with filtering and sorting","description":"List Predict.Fun markets with filtering and sorting Provider: Predexon (predictfun). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/predictfun/orderbooks":{"get":{"operationId":"predexon_predictfun_orderbooks","summary":"Fetch historical orderbook snapshots for a Predict.Fun market","description":"Fetch historical orderbook snapshots for a Predict.Fun market Provider: Predexon (predictfun). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/polymarket/uma/markets":{"get":{"operationId":"predexon_polymarket_uma_markets","summary":"List UMA oracle questions filtered by state (proposed, disputed, resolved, …)","description":"List UMA oracle questions filtered by state (proposed, disputed, resolved, …) Provider: Predexon (uma). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/polymarket/wallet/identities":{"post":{"operationId":"predexon_polymarket_wallet_identities","summary":"Bulk identity lookup for up to 200 wallet addresses (POST body: {addresses: [..]})","description":"Bulk identity lookup for up to 200 wallet addresses (POST body: {addresses: [..]}) Provider: Predexon (wallet). Tier 2 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/markets":{"get":{"operationId":"predexon_markets","summary":"List canonical market/question containers with cross-venue Predexon IDs","description":"List canonical market/question containers with cross-venue Predexon IDs Provider: Predexon (matching). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/markets/listings":{"get":{"operationId":"predexon_markets_listings","summary":"List venue-native executable listings flattened across canonical markets","description":"List venue-native executable listings flattened across canonical markets Provider: Predexon (matching). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/sports/categories":{"get":{"operationId":"predexon_sports_categories","summary":"List available sports categories","description":"List available sports categories Provider: Predexon (sports). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/pm/sports/markets":{"get":{"operationId":"predexon_sports_markets","summary":"List sports markets grouped by game","description":"List sports markets grouped by game Provider: Predexon (sports). Tier 1 pricing — payment goes directly to the Predexon recipient wallet.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Predexon response (passthrough)."},"402":{"description":"Payment Required"}}}},"/api/v1/crypto/list":{"get":{"operationId":"cryptoList","summary":"List Crypto Symbols","description":"List available Crypto symbols from Pyth feeds. Free discovery endpoint. Supports `q` (search) and `limit` (max 2000) query params.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Optional substring filter on symbol or display name."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2000,"default":100}}],"responses":{"200":{"description":"Crypto symbols list"}}}},"/api/v1/crypto/price/BTC-USD":{"get":{"operationId":"cryptoPrice","summary":"Crypto Spot Price","description":"Current spot price for one Crypto symbol from Pyth Network. Symbol format: Crypto pair `BASE-QUOTE` (e.g. BTC-USD, ETH-USD, SOL-USD). Example: `BTC-USD`. Substitute the path tail with any valid symbol from /list.","parameters":[{"name":"session","in":"query","required":false,"schema":{"type":"string","enum":["regular","extended"]},"description":"Trading session hint."}],"responses":{"200":{"description":"Spot price for Crypto"},"404":{"description":"Symbol not found"}}}},"/api/v1/crypto/history/BTC-USD":{"get":{"operationId":"cryptoHistory","summary":"Crypto OHLC History","description":"Historical OHLC bars for one Crypto symbol. Symbol format: Crypto pair `BASE-QUOTE` (e.g. BTC-USD, ETH-USD, SOL-USD). Example: `BTC-USD`. Substitute the path tail with any valid symbol from /list.","parameters":[{"name":"resolution","in":"query","required":false,"schema":{"type":"string","default":"D"},"description":"Bar resolution. Common values: 1, 5, 15, 60, 240, D, W."},{"name":"from","in":"query","required":false,"schema":{"type":"integer"},"description":"Start unix timestamp (seconds)."},{"name":"to","in":"query","required":false,"schema":{"type":"integer"},"description":"End unix timestamp (seconds). Defaults to now."},{"name":"session","in":"query","required":false,"schema":{"type":"string","enum":["regular","extended"]}}],"responses":{"200":{"description":"OHLC history for Crypto"},"404":{"description":"Symbol not found"}}}},"/api/v1/fx/list":{"get":{"operationId":"fxList","summary":"List FX Symbols","description":"List available FX symbols from Pyth feeds. Free discovery endpoint. Supports `q` (search) and `limit` (max 2000) query params.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Optional substring filter on symbol or display name."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2000,"default":100}}],"responses":{"200":{"description":"FX symbols list"}}}},"/api/v1/fx/price/EUR-USD":{"get":{"operationId":"fxPrice","summary":"FX Spot Price","description":"Current spot price for one FX symbol from Pyth Network. Symbol format: Currency pair `BASE-QUOTE` (e.g. EUR-USD, GBP-USD, JPY-USD). Example: `EUR-USD`. Substitute the path tail with any valid symbol from /list.","parameters":[{"name":"session","in":"query","required":false,"schema":{"type":"string","enum":["regular","extended"]},"description":"Trading session hint."}],"responses":{"200":{"description":"Spot price for FX"},"404":{"description":"Symbol not found"}}}},"/api/v1/fx/history/EUR-USD":{"get":{"operationId":"fxHistory","summary":"FX OHLC History","description":"Historical OHLC bars for one FX symbol. Symbol format: Currency pair `BASE-QUOTE` (e.g. EUR-USD, GBP-USD, JPY-USD). Example: `EUR-USD`. Substitute the path tail with any valid symbol from /list.","parameters":[{"name":"resolution","in":"query","required":false,"schema":{"type":"string","default":"D"},"description":"Bar resolution. Common values: 1, 5, 15, 60, 240, D, W."},{"name":"from","in":"query","required":false,"schema":{"type":"integer"},"description":"Start unix timestamp (seconds)."},{"name":"to","in":"query","required":false,"schema":{"type":"integer"},"description":"End unix timestamp (seconds). Defaults to now."},{"name":"session","in":"query","required":false,"schema":{"type":"string","enum":["regular","extended"]}}],"responses":{"200":{"description":"OHLC history for FX"},"404":{"description":"Symbol not found"}}}},"/api/v1/commodity/list":{"get":{"operationId":"commodityList","summary":"List Commodity Symbols","description":"List available Commodity symbols from Pyth feeds. Free discovery endpoint. Supports `q` (search) and `limit` (max 2000) query params.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Optional substring filter on symbol or display name."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2000,"default":100}}],"responses":{"200":{"description":"Commodity symbols list"}}}},"/api/v1/commodity/price/XAU-USD":{"get":{"operationId":"commodityPrice","summary":"Commodity Spot Price","description":"Current spot price for one Commodity symbol from Pyth Network. Symbol format: Commodity ticker `BASE-QUOTE` (e.g. XAU-USD for gold, WTI-USD for oil). Example: `XAU-USD`. Substitute the path tail with any valid symbol from /list.","parameters":[{"name":"session","in":"query","required":false,"schema":{"type":"string","enum":["regular","extended"]},"description":"Trading session hint."}],"responses":{"200":{"description":"Spot price for Commodity"},"404":{"description":"Symbol not found"}}}},"/api/v1/commodity/history/XAU-USD":{"get":{"operationId":"commodityHistory","summary":"Commodity OHLC History","description":"Historical OHLC bars for one Commodity symbol. Symbol format: Commodity ticker `BASE-QUOTE` (e.g. XAU-USD for gold, WTI-USD for oil). Example: `XAU-USD`. Substitute the path tail with any valid symbol from /list.","parameters":[{"name":"resolution","in":"query","required":false,"schema":{"type":"string","default":"D"},"description":"Bar resolution. Common values: 1, 5, 15, 60, 240, D, W."},{"name":"from","in":"query","required":false,"schema":{"type":"integer"},"description":"Start unix timestamp (seconds)."},{"name":"to","in":"query","required":false,"schema":{"type":"integer"},"description":"End unix timestamp (seconds). Defaults to now."},{"name":"session","in":"query","required":false,"schema":{"type":"string","enum":["regular","extended"]}}],"responses":{"200":{"description":"OHLC history for Commodity"},"404":{"description":"Symbol not found"}}}},"/api/v1/usstock/list":{"get":{"operationId":"usstockList","summary":"List US Stock Symbols","description":"List available US Stock symbols from Pyth feeds. Free discovery endpoint. Supports `q` (search) and `limit` (max 2000) query params.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Optional substring filter on symbol or display name."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2000,"default":100}}],"responses":{"200":{"description":"US Stock symbols list"}}}},"/api/v1/usstock/price/AAPL":{"get":{"operationId":"usstockPrice","summary":"US Stock Spot Price","description":"Current spot price for one US Stock symbol from Pyth Network. Symbol format: US ticker (e.g. AAPL, TSLA, NVDA, SPY). Example: `AAPL`. Substitute the path tail with any valid symbol from /list.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"parameters":[{"name":"session","in":"query","required":false,"schema":{"type":"string","enum":["regular","extended"]},"description":"Trading session hint."}],"responses":{"200":{"description":"Spot price for US Stock"},"402":{"description":"Payment Required"},"404":{"description":"Symbol not found"}}}},"/api/v1/usstock/history/AAPL":{"get":{"operationId":"usstockHistory","summary":"US Stock OHLC History","description":"Historical OHLC bars for one US Stock symbol. Symbol format: US ticker (e.g. AAPL, TSLA, NVDA, SPY). Example: `AAPL`. Substitute the path tail with any valid symbol from /list.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"parameters":[{"name":"resolution","in":"query","required":false,"schema":{"type":"string","default":"D"},"description":"Bar resolution. Common values: 1, 5, 15, 60, 240, D, W."},{"name":"from","in":"query","required":false,"schema":{"type":"integer"},"description":"Start unix timestamp (seconds)."},{"name":"to","in":"query","required":false,"schema":{"type":"integer"},"description":"End unix timestamp (seconds). Defaults to now."},{"name":"session","in":"query","required":false,"schema":{"type":"string","enum":["regular","extended"]}}],"responses":{"200":{"description":"OHLC history for US Stock"},"402":{"description":"Payment Required"},"404":{"description":"Symbol not found"}}}},"/api/v1/stocks/us/list":{"get":{"operationId":"stocksmarketList","summary":"List Global Stock Symbols","description":"List available Global Stock symbols from Pyth feeds. Free discovery endpoint. Supports `q` (search) and `limit` (max 2000) query params.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Optional substring filter on symbol or display name."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2000,"default":100}}],"responses":{"200":{"description":"Global Stock symbols list"}}}},"/api/v1/stocks/us/price/AAPL":{"get":{"operationId":"stocksmarketPrice","summary":"Global Stock Spot Price","description":"Current spot price for one Global Stock symbol from Pyth Network. Symbol format: Ticker matching the chosen market (HKEX -HK suffix, TSE 4-digit, KRX 6-digit, LSE/XETRA/Euronext alpha). Example: `AAPL`. Substitute the path tail with any valid symbol from /list.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"parameters":[{"name":"session","in":"query","required":false,"schema":{"type":"string","enum":["regular","extended"]},"description":"Trading session hint."}],"responses":{"200":{"description":"Spot price for Global Stock"},"402":{"description":"Payment Required"},"404":{"description":"Symbol not found"}}}},"/api/v1/stocks/us/history/AAPL":{"get":{"operationId":"stocksmarketHistory","summary":"Global Stock OHLC History","description":"Historical OHLC bars for one Global Stock symbol. Symbol format: Ticker matching the chosen market (HKEX -HK suffix, TSE 4-digit, KRX 6-digit, LSE/XETRA/Euronext alpha). Example: `AAPL`. Substitute the path tail with any valid symbol from /list.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"parameters":[{"name":"resolution","in":"query","required":false,"schema":{"type":"string","default":"D"},"description":"Bar resolution. Common values: 1, 5, 15, 60, 240, D, W."},{"name":"from","in":"query","required":false,"schema":{"type":"integer"},"description":"Start unix timestamp (seconds)."},{"name":"to","in":"query","required":false,"schema":{"type":"integer"},"description":"End unix timestamp (seconds). Defaults to now."},{"name":"session","in":"query","required":false,"schema":{"type":"string","enum":["regular","extended"]}}],"responses":{"200":{"description":"OHLC history for Global Stock"},"402":{"description":"Payment Required"},"404":{"description":"Symbol not found"}}}}}}