{ "openapi": "3.1.0", "info": { "title": "Aizamon", "version": "1.0.0", "description": "x402 micro-bodega for wallet agents. USDC on Base.", "contact": { "email": "support@aizamon.com", "url": "https://aizamon.com/contact" }, "x-guidance": "GET /x402/v1/ping ($0.01) proves the rail. GET /x402/v1/spread ($0.01, optional ?q=) returns exact Polymarket and Kalshi yes prices. GET /x402/v1/match?q= is $0.05. GET /x402/v1/bot-fuel is $0.25. GET /x402/v1/hour-pass ($0.50) returns a 1-hour X-Aizamon-Pass for those reads. Unpaid calls return 402 before query checks. Pay with x402 v2 USDC on Base, then retry the same GET." }, "x-agentcash-guidance": { "llmsTxtUrl": "https://aizamon.com/llms.txt" }, "paths": { "/x402/v1/bot-fuel": { "get": { "operationId": "bot_fuel", "summary": "Polymarket vs Kalshi arbitrage / cross-venue mispricing gap card — $0.25 Bot Fuel. Top spread + net-edge for trading bots. Inline JSON. Scale via pack/day.", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.250000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/bot-fuel-pack": { "get": { "operationId": "bot_fuel_pack", "summary": "Polymarket–Kalshi arbitrage pack — $0.89 for top 5 fee-adjusted cross-venue gap cards. Trading-bot volume lane.", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.890000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/bot-fuel-day": { "get": { "operationId": "bot_fuel_day", "summary": "Polymarket–Kalshi arbitrage day pass — $1.49 for 24h cross-venue mispricing feed token.", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "1.490000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/edge": { "get": { "operationId": "edge", "summary": "Legacy alpha edge (on sale) — prefer /x402/v1/bot-fuel for trading bots", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.190000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/scan": { "get": { "operationId": "scan", "summary": "Mini leak/error scan — send payload via X-Aizamon-Payload (base64 JSON) or ?raw=", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "raw", "in": "query", "required": false, "schema": { "type": "string", "description": "Log sample. Or send header X-Aizamon-Payload." } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.490000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/alpha-day": { "get": { "operationId": "alpha_day", "summary": "Legacy 24h feed token (on sale) — trading bots prefer Bot Fuel 24h SKU", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "1.190000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/tor-call": { "get": { "operationId": "tor_call", "summary": "One metered Tor MCP call permit (redeem via GET /api/v1/tor-call-permit)", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/hour-pass": { "get": { "operationId": "hour_pass", "summary": "Hour pass — $0.50 for 1 hour of agent reads. Returns X-Aizamon-Pass. New x402 reads are included unless they mint a longer token, credit, or a permit.", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.500000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/ping": { "get": { "operationId": "ping", "summary": "x402 hello-world — $0.01 prove-the-rail settle. Returns signed Ed25519 receipt attestation + echo so your wallet stack has verifiable proof it can pay.", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "echo", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/match": { "get": { "operationId": "match", "summary": "Mid-loop venue match — $0.05. Pass ?q= market topic; get best Polymarket↔Kalshi venue + bucketed gap for that query. Under default $0.10 spend caps.", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "description": "Market topic keywords." } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/spread": { "get": { "operationId": "spread", "summary": "Polymarket vs Kalshi cross-venue yes-price spread — $0.01. Pass ?q= topic (or omit for top gap). Exact yes prices, gapCents, cheaper venue, and deep links in on", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "description": "Market topic keywords. Omit for the top live gap." } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/edge-pack": { "get": { "operationId": "edge_pack", "summary": "Top 5 live tradeable edges in one JSON response.", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.790000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/alpha-7d": { "get": { "operationId": "alpha_7d", "summary": "7-day alpha feed token. Hour Pass does not include this.", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "3.990000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/sniff": { "get": { "operationId": "sniff", "summary": "Counts prompt-injection patterns in ?q=. A pattern match, not a promise the text is safe.", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "description": "Untrusted text. Pattern counts only." } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/pii": { "get": { "operationId": "pii", "summary": "Counts emails, phones, SSNs, wallet addresses, and key-like strings in ?q=. Counts only — the text is not stored.", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "description": "Text to count emails, key shapes, and wallet-like strings in." } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/spec-lint": { "get": { "operationId": "spec_lint", "summary": "Checks pasted OpenAPI JSON in ?q= for a version, paths, and one 2xx response. Three checks, not a full audit.", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "description": "OpenAPI JSON. Three checks: version, paths, one 2xx response." } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/credits-2": { "get": { "operationId": "credits_2", "summary": "Prepaid $2 store credit for later agent SKUs. Not covered by Hour Pass.", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "2.000000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/credits-5": { "get": { "operationId": "credits_5", "summary": "Prepaid $5 store credit for later agent SKUs. Not covered by Hour Pass.", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "5.000000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } }, "/x402/v1/credits-10": { "get": { "operationId": "credits_10", "summary": "Prepaid $10 store credit for later agent SKUs. Not covered by Hour Pass.", "tags": [ "x402" ], "security": [], "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string" } } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "10.000000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Paid JSON result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "protocol": { "type": "string" }, "sku": { "type": "string" }, "result": { "type": "object", "additionalProperties": true } }, "required": [ "ok" ] } } } }, "402": { "description": "Payment Required" } } } } } }