{ "openapi": "3.0.3", "info": { "title": "54ch10 Toolkit API", "description": "Pre-interact risk briefs plus whois/RDAP, DNS, TLS/CT, URL normalize, public fetch, ephemeral paste, hash, and encode micropay tools for agents. Analytics-only — not financial, legal, or investment advice. Canonical paid paths return HTTP 402 + x402 PAYMENT-REQUIRED (USDC $0.001–$0.01 Base preferred) unless Bearer 54k_ or PAYMENT-SIGNATURE. Demo free: X-54ch10-Free: 1 or GET /v1//free (20/day/IP). Discovery: GET /.well-known/x402.", "version": "0.7.0-fetch-paste", "contact": { "name": "54ch10", "url": "https://54ch10.uk", "email": "brainpowerux@gmail.com" }, "license": { "name": "Proprietary", "url": "https://54ch10.uk/LEGAL_DISCLAIMER.txt" }, "x-apisguru-categories": [ "security", "cryptocurrency" ], "x-logo": { "url": "https://54ch10.uk/favicon.ico" }, "x-x402": { "discovery": "https://54ch10.uk/.well-known/x402", "pricesUsd": { "brief": "0.01", "whois": "0.005", "dns": "0.002", "tls": "0.005", "normalize-url": "0.001", "hash": "0.001", "encode": "0.001", "fetch": "0.005", "paste-write": "0.002", "paste-read": "0.001" }, "networks": [ "eip155:8453", "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp" ], "payToEvm": "0xF9eb0Caa13B78f92E2850bf5961eB9736354aA3d", "payToSolana": "EcGUGSda9VNzYgUmYA8mTg88MhNYeyA5tgaCgwzxfFNs", "facilitator": "https://facilitator.payai.network" } }, "servers": [ { "url": "https://54ch10.uk", "description": "Production" } ], "paths": { "/v1/brief": { "get": { "operationId": "getBrief", "summary": "Pre-interact risk brief", "description": "Returns score (0–100), band, flags, summary, sources[]. Unauthenticated → HTTP 402 (USDC $0.01). Demo free: X-54ch10-Free: 1 or /free sibling.", "parameters": [ { "name": "type", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "address", "token", "url" ] } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 2048 } }, { "$ref": "#/components/parameters/X54ch10Free" }, { "$ref": "#/components/parameters/PaymentSignature" } ], "responses": { "200": { "description": "JSON result" }, "401": { "description": "Invalid API key" }, "402": { "description": "Payment Required (x402). Decode PAYMENT-REQUIRED for accepts[] and extensions.bazaar.", "headers": { "PAYMENT-REQUIRED": { "description": "Base64-encoded x402 v2 PaymentRequired", "schema": { "type": "string" } } } } }, "security": [ {}, { "bearerAuth": [] } ] } }, "/v1/brief/free": { "get": { "operationId": "getBriefFree", "summary": "Demo free brief", "description": "Demo free path (20/UTC-day/IP). Not for indexer discovery.", "parameters": [ { "name": "type", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "address", "token", "url" ] } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 2048 } } ], "responses": { "200": { "description": "JSON result" }, "402": { "description": "Free quota exhausted" } } } }, "/v1/whois": { "get": { "operationId": "getWhois", "summary": "Domain WHOIS/RDAP", "description": "Domain age, registrar, status via public RDAP. Unauthenticated → HTTP 402 (USDC $0.005). Demo free: X-54ch10-Free: 1 or /free sibling.", "parameters": [ { "name": "domain", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Domain name (e.g. example.com)" }, { "$ref": "#/components/parameters/X54ch10Free" }, { "$ref": "#/components/parameters/PaymentSignature" } ], "responses": { "200": { "description": "JSON result" }, "401": { "description": "Invalid API key" }, "402": { "description": "Payment Required (x402). Decode PAYMENT-REQUIRED for accepts[] and extensions.bazaar.", "headers": { "PAYMENT-REQUIRED": { "description": "Base64-encoded x402 v2 PaymentRequired", "schema": { "type": "string" } } } } }, "security": [ {}, { "bearerAuth": [] } ] } }, "/v1/whois/free": { "get": { "operationId": "getWhoisFree", "summary": "Demo free whois", "description": "Demo free path (20/UTC-day/IP). Not for indexer discovery.", "parameters": [ { "name": "domain", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Domain name (e.g. example.com)" } ], "responses": { "200": { "description": "JSON result" }, "402": { "description": "Free quota exhausted" } } } }, "/v1/dns": { "get": { "operationId": "getDns", "summary": "DNS A/MX/NS summary", "description": "A/AAAA/MX/NS via Cloudflare DoH with fraud-signal style flags. Unauthenticated → HTTP 402 (USDC $0.002). Demo free: X-54ch10-Free: 1 or /free sibling.", "parameters": [ { "name": "domain", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Domain name (e.g. example.com)" }, { "$ref": "#/components/parameters/X54ch10Free" }, { "$ref": "#/components/parameters/PaymentSignature" } ], "responses": { "200": { "description": "JSON result" }, "401": { "description": "Invalid API key" }, "402": { "description": "Payment Required (x402). Decode PAYMENT-REQUIRED for accepts[] and extensions.bazaar.", "headers": { "PAYMENT-REQUIRED": { "description": "Base64-encoded x402 v2 PaymentRequired", "schema": { "type": "string" } } } } }, "security": [ {}, { "bearerAuth": [] } ] } }, "/v1/dns/free": { "get": { "operationId": "getDnsFree", "summary": "Demo free dns", "description": "Demo free path (20/UTC-day/IP). Not for indexer discovery.", "parameters": [ { "name": "domain", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Domain name (e.g. example.com)" } ], "responses": { "200": { "description": "JSON result" }, "402": { "description": "Free quota exhausted" } } } }, "/v1/tls": { "get": { "operationId": "getTls", "summary": "TLS cert issuer/validity", "description": "Certificate Transparency (crt.sh) issuer/notBefore/notAfter + HTTPS reachability. Unauthenticated → HTTP 402 (USDC $0.005). Demo free: X-54ch10-Free: 1 or /free sibling.", "parameters": [ { "name": "domain", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Domain name (e.g. example.com)" }, { "$ref": "#/components/parameters/X54ch10Free" }, { "$ref": "#/components/parameters/PaymentSignature" } ], "responses": { "200": { "description": "JSON result" }, "401": { "description": "Invalid API key" }, "402": { "description": "Payment Required (x402). Decode PAYMENT-REQUIRED for accepts[] and extensions.bazaar.", "headers": { "PAYMENT-REQUIRED": { "description": "Base64-encoded x402 v2 PaymentRequired", "schema": { "type": "string" } } } } }, "security": [ {}, { "bearerAuth": [] } ] } }, "/v1/tls/free": { "get": { "operationId": "getTlsFree", "summary": "Demo free tls", "description": "Demo free path (20/UTC-day/IP). Not for indexer discovery.", "parameters": [ { "name": "domain", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Domain name (e.g. example.com)" } ], "responses": { "200": { "description": "JSON result" }, "402": { "description": "Free quota exhausted" } } } }, "/v1/normalize-url": { "get": { "operationId": "getNormalizeUrl", "summary": "Canonicalize URL", "description": "Normalize scheme/host/path/query (fragment stripped, query sorted). Unauthenticated → HTTP 402 (USDC $0.001). Demo free: X-54ch10-Free: 1 or /free sibling.", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 4096 }, "description": "URL to canonicalize" }, { "$ref": "#/components/parameters/X54ch10Free" }, { "$ref": "#/components/parameters/PaymentSignature" } ], "responses": { "200": { "description": "JSON result" }, "401": { "description": "Invalid API key" }, "402": { "description": "Payment Required (x402). Decode PAYMENT-REQUIRED for accepts[] and extensions.bazaar.", "headers": { "PAYMENT-REQUIRED": { "description": "Base64-encoded x402 v2 PaymentRequired", "schema": { "type": "string" } } } } }, "security": [ {}, { "bearerAuth": [] } ] } }, "/v1/normalize-url/free": { "get": { "operationId": "getNormalizeUrlFree", "summary": "Demo free normalize-url", "description": "Demo free path (20/UTC-day/IP). Not for indexer discovery.", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 4096 }, "description": "URL to canonicalize" } ], "responses": { "200": { "description": "JSON result" }, "402": { "description": "Free quota exhausted" } } } }, "/v1/hash": { "get": { "operationId": "getHash", "summary": "Hash data (sha256|sha1|md5)", "description": "Hash UTF-8 data. Query algo=&q=. Also accepts POST JSON {algo,data}. Unauthenticated → HTTP 402 (USDC $0.001). Demo free: X-54ch10-Free: 1 or /free sibling.", "parameters": [ { "name": "algo", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "sha256", "sha1", "md5" ] } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 65536 }, "description": "UTF-8 data to hash" }, { "$ref": "#/components/parameters/X54ch10Free" }, { "$ref": "#/components/parameters/PaymentSignature" } ], "responses": { "200": { "description": "JSON result" }, "401": { "description": "Invalid API key" }, "402": { "description": "Payment Required (x402).", "headers": { "PAYMENT-REQUIRED": { "description": "Base64-encoded x402 v2 PaymentRequired", "schema": { "type": "string" } } } } }, "security": [ {}, { "bearerAuth": [] } ] }, "post": { "operationId": "postHash", "summary": "Hash data via JSON body", "description": "POST JSON {algo, data}. USDC $0.001.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "algo", "data" ], "properties": { "algo": { "type": "string", "enum": [ "sha256", "sha1", "md5" ] }, "data": { "type": "string" } } } } } }, "parameters": [ { "$ref": "#/components/parameters/X54ch10Free" }, { "$ref": "#/components/parameters/PaymentSignature" } ], "responses": { "200": { "description": "JSON result" }, "402": { "description": "Payment Required (x402)." } }, "security": [ {}, { "bearerAuth": [] } ] } }, "/v1/hash/free": { "get": { "operationId": "getHashFree", "summary": "Demo free hash", "description": "Demo free path (20/UTC-day/IP). Not for indexer discovery.", "parameters": [ { "name": "algo", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "sha256", "sha1", "md5" ] } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 65536 } } ], "responses": { "200": { "description": "JSON result" }, "402": { "description": "Free quota exhausted" } } } }, "/v1/encode": { "get": { "operationId": "getEncode", "summary": "Encode data (base64|hex|url)", "description": "Encode UTF-8 data. Query format=&q=. Also accepts POST JSON {format,data}. Unauthenticated → HTTP 402 (USDC $0.001). Demo free: X-54ch10-Free: 1 or /free sibling.", "parameters": [ { "name": "format", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "base64", "hex", "url" ] } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 65536 }, "description": "UTF-8 data to encode" }, { "$ref": "#/components/parameters/X54ch10Free" }, { "$ref": "#/components/parameters/PaymentSignature" } ], "responses": { "200": { "description": "JSON result" }, "401": { "description": "Invalid API key" }, "402": { "description": "Payment Required (x402).", "headers": { "PAYMENT-REQUIRED": { "description": "Base64-encoded x402 v2 PaymentRequired", "schema": { "type": "string" } } } } }, "security": [ {}, { "bearerAuth": [] } ] }, "post": { "operationId": "postEncode", "summary": "Encode data via JSON body", "description": "POST JSON {format, data}. USDC $0.001.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "format", "data" ], "properties": { "format": { "type": "string", "enum": [ "base64", "hex", "url" ] }, "data": { "type": "string" } } } } } }, "parameters": [ { "$ref": "#/components/parameters/X54ch10Free" }, { "$ref": "#/components/parameters/PaymentSignature" } ], "responses": { "200": { "description": "JSON result" }, "402": { "description": "Payment Required (x402)." } }, "security": [ {}, { "bearerAuth": [] } ] } }, "/v1/encode/free": { "get": { "operationId": "getEncodeFree", "summary": "Demo free encode", "description": "Demo free path (20/UTC-day/IP). Not for indexer discovery.", "parameters": [ { "name": "format", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "base64", "hex", "url" ] } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 65536 } } ], "responses": { "200": { "description": "JSON result" }, "402": { "description": "Free quota exhausted" } } } }, "/.well-known/x402": { "get": { "operationId": "getX402Discovery", "summary": "x402 service discovery manifest", "description": "Machine-readable x402 manifest for agent402.tools / bazaar indexers. Alias: /.well-known/x402.json", "responses": { "200": { "description": "Discovery JSON" } } } }, "/health": { "get": { "operationId": "getHealth", "summary": "Health check", "responses": { "200": { "description": "OK" } } } }, "/v1/fetch": { "get": { "operationId": "getFetch", "summary": "Fetch public URL (SSRF-safe)", "description": "Fetch public http(s) URL; return status/contentType/markdown|text. Private IPs blocked. Cap 200KB, ~10s. Unauthenticated → HTTP 402 (USDC $0.005).", "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 4096 } }, { "name": "format", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "markdown", "text" ], "default": "markdown" } }, { "$ref": "#/components/parameters/X54ch10Free" }, { "$ref": "#/components/parameters/PaymentSignature" } ], "responses": { "200": { "description": "JSON result" }, "401": { "description": "Invalid API key" }, "402": { "description": "Payment Required (x402). Decode PAYMENT-REQUIRED for accepts[] and extensions.bazaar.", "headers": { "PAYMENT-REQUIRED": { "description": "Base64-encoded x402 v2 PaymentRequired", "schema": { "type": "string" } } } } }, "security": [ {}, { "bearerAuth": [] } ] }, "post": { "operationId": "postFetch", "summary": "Fetch public URL (POST body)", "description": "Same as GET; body {url, format?}. USDC $0.005.", "parameters": [ { "$ref": "#/components/parameters/X54ch10Free" }, { "$ref": "#/components/parameters/PaymentSignature" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string" }, "format": { "type": "string", "enum": [ "markdown", "text" ] } } } } } }, "responses": { "200": { "description": "JSON result" }, "401": { "description": "Invalid API key" }, "402": { "description": "Payment Required (x402). Decode PAYMENT-REQUIRED for accepts[] and extensions.bazaar.", "headers": { "PAYMENT-REQUIRED": { "description": "Base64-encoded x402 v2 PaymentRequired", "schema": { "type": "string" } } } } }, "security": [ {}, { "bearerAuth": [] } ] } }, "/v1/fetch/free": { "get": { "operationId": "getFetchFree", "summary": "Demo free fetch", "description": "Demo free path (20/UTC-day/IP). Not for indexer discovery.", "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "format", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "markdown", "text" ] } } ], "responses": { "200": { "description": "JSON result" }, "402": { "description": "Free quota exhausted" } } } }, "/v1/paste": { "post": { "operationId": "postPaste", "summary": "Ephemeral paste write", "description": "Store short plaintext in KV with TTL (default 1h, max 24h). NOT a vault — ephemeral agent handoff only. Unauthenticated → HTTP 402 (USDC $0.002).", "parameters": [ { "$ref": "#/components/parameters/X54ch10Free" }, { "$ref": "#/components/parameters/PaymentSignature" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "content" ], "properties": { "content": { "type": "string", "maxLength": 64000 }, "ttl_seconds": { "type": "integer", "minimum": 60, "maximum": 86400 } } } } } }, "responses": { "200": { "description": "JSON result" }, "401": { "description": "Invalid API key" }, "402": { "description": "Payment Required (x402). Decode PAYMENT-REQUIRED for accepts[] and extensions.bazaar.", "headers": { "PAYMENT-REQUIRED": { "description": "Base64-encoded x402 v2 PaymentRequired", "schema": { "type": "string" } } } } }, "security": [ {}, { "bearerAuth": [] } ] }, "get": { "operationId": "getPaste", "summary": "Ephemeral paste read", "description": "Retrieve paste by id. TTL-bound; NOT a vault. Unauthenticated → HTTP 402 (USDC $0.001).", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/X54ch10Free" }, { "$ref": "#/components/parameters/PaymentSignature" } ], "responses": { "200": { "description": "JSON result" }, "401": { "description": "Invalid API key" }, "402": { "description": "Payment Required (x402). Decode PAYMENT-REQUIRED for accepts[] and extensions.bazaar.", "headers": { "PAYMENT-REQUIRED": { "description": "Base64-encoded x402 v2 PaymentRequired", "schema": { "type": "string" } } } } }, "security": [ {}, { "bearerAuth": [] } ] } }, "/v1/paste/free": { "post": { "operationId": "postPasteFree", "summary": "Demo free paste write", "description": "Demo free write (20/UTC-day/IP). NOT a vault.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "content" ], "properties": { "content": { "type": "string" }, "ttl_seconds": { "type": "integer" } } } } } }, "responses": { "200": { "description": "JSON result" }, "402": { "description": "Free quota exhausted" } } }, "get": { "operationId": "getPasteFree", "summary": "Demo free paste read", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "JSON result" }, "402": { "description": "Free quota exhausted" } } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "54k_", "description": "Optional paid API key (54k_…). Alternatively pay per call with x402 USDC." } }, "parameters": { "X54ch10Free": { "name": "X-54ch10-Free", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Explicit human/demo free tier opt-in (20/UTC-day/IP). Indexers must NOT send this." }, "PaymentSignature": { "name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "schema": { "type": "string" }, "description": "Base64-encoded x402 v2 PaymentPayload after client signs USDC authorization" } } } }