{"components":{"securitySchemes":{"apiKey":{"description":"API key issued after USDC payment at /pay. Format: an_<64hex>. Bypasses x402 for all paid endpoints.","in":"header","name":"X-API-Key","type":"apiKey"},"x402":{"description":"x402 micropayment: receive 402 challenge, send Base USDC to treasury, retry with PAYMENT-SIGNATURE: <sig>;<pk>;<txid>;<amount> header. SDK: npm install aethel-nexus-sdk","scheme":"x402","type":"http"}}},"info":{"contact":{"email":"atomadic@proton.me"},"description":"Autonomous A2A API with x402 USDC micropayment gating, tensor compression, and topological identity verification. 75+ live endpoints (public + paid).","title":"Aethel-Nexus AAAA API","version":"0.4.0"},"openapi":"3.1.0","paths":{"/.well-known/agent.json":{"get":{"operationId":"agentCard","responses":{"200":{"description":"A2A-compliant agent descriptor with skills and payment terms"}},"summary":"Google A2A agent card","tags":["discovery","public"]}},"/.well-known/mcp.json":{"get":{"operationId":"mcpManifest","responses":{"200":{"description":"MCP transport metadata and tool list"}},"summary":"MCP server discovery manifest","tags":["discovery","public"]}},"/a2a":{"post":{"operationId":"a2a","requestBody":{"content":{"application/json":{"schema":{"properties":{"message":{"description":"A2A message with text parts — intent is extracted and routed to the matching skill","properties":{"parts":{"items":{"properties":{"text":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"}},"required":["message"],"type":"object"}}},"required":true},"responses":{"200":{"description":"A2A Task object with skill result, task_id, epoch, artifacts"},"402":{"description":"x402 payment challenge"},"405":{"description":"Method not allowed (POST only)"}},"security":[{"x402":[]}],"summary":"Google A2A protocol handler — intent-routed skill dispatch ($0.002)","tags":["a2a","paid"]}},"/health":{"get":{"operationId":"health","responses":{"200":{"description":"OK — version, guardrails, and runtime limits"}},"summary":"System health + platform constants","tags":["public"]}},"/mcp":{"get":{"operationId":"mcpInfo","responses":{"200":{"description":"Basic MCP endpoint info"}},"summary":"MCP endpoint metadata","tags":["mcp","public"]},"post":{"operationId":"mcpRpc","requestBody":{"content":{"application/json":{"schema":{"properties":{"id":{},"jsonrpc":{"example":"2.0","type":"string"},"method":{"example":"tools/list","type":"string"},"params":{"type":"object"}},"required":["jsonrpc","method"],"type":"object"}}},"required":true},"responses":{"200":{"description":"JSON-RPC response"},"400":{"description":"Invalid JSON-RPC request"}},"summary":"Model Context Protocol JSON-RPC endpoint","tags":["mcp","public"]}},"/pay":{"get":{"operationId":"payPage","parameters":[{"description":"Product slug (for example: helix-balanced, dev, pro, model-qwen25-7b)","in":"query","name":"product","required":true,"schema":{"type":"string"}},{"description":"Checkout amount in USD","in":"query","name":"amount","required":true,"schema":{"type":"integer"}},{"description":"Optional display name override","in":"query","name":"name","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Checkout HTML page"},"400":{"description":"Invalid or missing checkout parameters"}},"summary":"Create checkout for model/API products","tags":["payments","public"]}},"/v1/agent/quarantine":{"post":{"operationId":"agentQuarantine","responses":{"200":{"description":"quarantine_id, reason, isolation_level, recovery_path"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"SEC-309 Agent Quarantine Manager — isolate drifted/malicious agents ($0.01)","tags":["security","paid"]}},"/v1/agents/capabilities/match":{"post":{"operationId":"capabilitiesMatch","responses":{"200":{"description":"protocol_recommendation, capability_analysis, topology, task_split"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"A2A-NEG Agent Capability Matcher — Jaccard similarity, TCE-24 vs ACP routing advice ($0.005)","tags":["swarm","paid"]}},"/v1/agents/contradiction":{"post":{"operationId":"contradictionDetect","requestBody":{"content":{"application/json":{"schema":{"properties":{"statement_a":{"type":"string"},"statement_b":{"type":"string"}},"required":["statement_a","statement_b"],"type":"object"}}},"required":true},"responses":{"200":{"description":"label (contradiction/consistent/unrelated), confidence, overlap"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"AGT-704 Contradiction Detector — NLI heuristic for statement pairs ($0.005)","tags":["agents","paid"],"x-amount-usdc":"0.005","x-payment-required":true}},"/v1/agents/intent-classify":{"post":{"operationId":"intentClassify","requestBody":{"content":{"application/json":{"schema":{"properties":{"text":{"type":"string"}},"required":["text"],"type":"object"}}},"required":true},"responses":{"200":{"description":"intents array with label, confidence, suggested_action"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"AGT-701 Intent Classifier — keyword-based top-3 intent classification ($0.005)","tags":["agents","paid"],"x-amount-usdc":"0.005","x-payment-required":true}},"/v1/agents/plan":{"post":{"operationId":"agentsPlan","requestBody":{"content":{"application/json":{"schema":{"properties":{"context":{"type":"string"},"goal":{"type":"string"},"max_steps":{"default":10,"type":"integer"}},"required":["goal"],"type":"object"}}},"required":true},"responses":{"200":{"description":"steps array with id, action, depends_on, estimated_cost_usdc"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"AGT-805 Goal Planner — rule-based step decomposition ($0.015)","tags":["agents","paid"],"x-amount-usdc":"0.015","x-payment-required":true}},"/v1/agents/register":{"post":{"operationId":"agentsRegister","requestBody":{"content":{"application/json":{"schema":{"properties":{"capabilities":{"description":"64-bit capability bitmask","format":"int64","type":"integer"},"endpoint_url":{"description":"Agent's callable HTTP endpoint","type":"string"},"id":{"description":"Atomadic-compliant agent ID. Must pass topological identity check.","format":"int64","type":"integer"},"model_hash":{"description":"64-char hex hash of the agent's model checkpoint","type":"string"},"trust_score":{"description":"Agent's declared trust score (clamped to [0,1])","maximum":1.0,"minimum":0.0,"type":"number"}},"required":["id"],"type":"object"}}},"required":true},"responses":{"200":{"description":"registered bool, epoch, expires_at, ttl_s"},"400":{"description":"identity_invalid or identity_reserved"}},"summary":"COR-1116 Agent self-registration — identity gate, trust score, capabilities bitmask","tags":["swarm","public"]}},"/v1/agents/reputation":{"post":{"operationId":"agentReputation","requestBody":{"content":{"application/json":{"schema":{"properties":{"agent_url":{"format":"uri","type":"string"}},"required":["agent_url"],"type":"object"}}},"required":true},"responses":{"200":{"description":"trust_score, latency_ms, a2a_compliant, reachable"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"AGT-702 Agent Reputation Scorer — fetch agent card, measure latency, A2A compliance ($0.01)","tags":["agents","paid"],"x-amount-usdc":"0.010","x-payment-required":true}},"/v1/agents/semantic-diff":{"post":{"operationId":"semanticDiff","requestBody":{"content":{"application/json":{"schema":{"properties":{"text_a":{"type":"string"},"text_b":{"type":"string"}},"required":["text_a","text_b"],"type":"object"}}},"required":true},"responses":{"200":{"description":"similarity, drift_score, changes (added/removed)"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"AGT-700 Semantic Diff — word-level diff with Jaccard similarity and drift score ($0.01)","tags":["agents","paid"],"x-amount-usdc":"0.010","x-payment-required":true}},"/v1/agents/token-budget":{"post":{"operationId":"tokenBudget","requestBody":{"content":{"application/json":{"schema":{"properties":{"max_tokens":{"type":"integer"},"task":{"type":"string"}},"required":["task"],"type":"object"}}},"required":true},"responses":{"200":{"description":"models array with est_cost_usd, cheapest model recommendation"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"AGT-703 Token Budget Estimator — multi-model cost estimate for a task ($0.005)","tags":["agents","paid"],"x-amount-usdc":"0.005","x-payment-required":true}},"/v1/agents/topology":{"get":{"operationId":"agentsTopology","responses":{"200":{"description":"agents array, count, epoch, window_s. Cache-Control 30s."}},"summary":"Live swarm topology — all registered agents (COR-1116)","tags":["swarm","public"]}},"/v1/aibom/drift":{"post":{"operationId":"aibomDrift","requestBody":{"content":{"application/json":{"schema":{"properties":{"baseline":{"description":"Baseline AIBOM distribution","items":{"type":"number"},"type":"array"},"current":{"description":"Current model distribution sample","items":{"type":"number"},"type":"array"}},"required":["current","baseline"],"type":"object"}}},"required":true},"responses":{"200":{"description":"wasserstein_distance, drift_detected, drift_budget"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"AIB-401 Runtime AIBOM Wasserstein drift detector (x402)","tags":["aibom","safety","paid"]}},"/v1/audit/log":{"post":{"operationId":"auditLog","responses":{"200":{"description":"entry_id, sha3_hash, chain_height, timestamp, jurisdiction"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"GOV-103 Reconstructable Audit Trail — log + hash-chain entry ($0.01)","tags":["governance","paid"]}},"/v1/audit/verify":{"get":{"operationId":"auditVerify","parameters":[{"in":"query","name":"entry_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"valid bool, hash_match, chain_intact"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"GOV-103 Verify audit entry integrity ($0.01)","tags":["governance","paid"]}},"/v1/auth/zero-trust":{"post":{"operationId":"authZeroTrust","requestBody":{"content":{"application/json":{"schema":{"properties":{"agent_id":{"description":"Agent ID (must pass platform identity check)","type":"string"},"claimed_capabilities":{"description":"Capability bitmask (1–255)","format":"int64","type":"integer"},"endpoint_url":{"description":"Agent's HTTPS endpoint","type":"string"}},"required":["agent_id"],"type":"object"}}},"required":true},"responses":{"200":{"description":"verdict (AUTHENTICATED/PARTIAL/REJECTED), trust_score, checks object (g18_identity, endpoint_https, capabilities_sane, nonce_fresh)"}},"summary":"Zero-trust agent authentication — identity + endpoint + capability + nonce checks (free)","tags":["auth","security","public"]}},"/v1/billing/outcome":{"post":{"operationId":"billingOutcome","responses":{"200":{"description":"billing_mode, fee_usdc, outcome_verified, settlement_hash"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"PAY-509 Outcome-Based Billing Engine — pay-per-result vs pay-per-call ($0.01)","tags":["payments","paid"]}},"/v1/compliance/check":{"post":{"operationId":"complianceCheck","requestBody":{"content":{"application/json":{"schema":{"properties":{"jurisdiction":{"description":"Jurisdiction bitmask (EU=4, CA=2, US=1)","type":"integer"},"metric":{"description":"ρ_e value to check against EPS_KL","type":"number"}},"required":["metric"],"type":"object"}}},"required":true},"responses":{"200":{"description":"compliant bool, quarantine bool, eps_kl, jurisdiction routing"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"GOV-100 ε_KL compliance gate with D_MAX quarantine (x402)","tags":["compliance","paid"]}},"/v1/compliance/eu-ai-act":{"post":{"operationId":"euAiAct","responses":{"200":{"description":"risk_category, article_flags, conformity_actions"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"GOV-106 EU AI Act Risk Classifier — Article 6/9/10 assessment ($0.01)","tags":["governance","compliance","paid"]}},"/v1/compress":{"post":{"operationId":"compress","requestBody":{"content":{"application/json":{"schema":{"properties":{"level":{"default":1,"enum":[1,2,3],"type":"integer"},"vectors":{"description":"Array of 24-dim float vectors","items":{"items":{"type":"number"},"maxItems":24,"minItems":24,"type":"array"},"type":"array"}},"required":["vectors"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Compressed vectors + ratio"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"Tensor compression — INF-800-T (x402)","tags":["compression","paid"]}},"/v1/costs/attribute":{"post":{"operationId":"costsAttribute","responses":{"200":{"description":"cost_usd, efficiency_score, token_breakdown, recommendations"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"DEV-603 Agent Cost Attribution — TCO breakdown per agent/task ($0.01)","tags":["devops","paid"]}},"/v1/data/format-convert":{"post":{"operationId":"dataFormatConvert","requestBody":{"content":{"application/json":{"schema":{"properties":{"data":{"type":"string"},"from":{"enum":["json","csv"],"type":"string"},"to":{"enum":["json","csv"],"type":"string"}},"required":["data","from","to"],"type":"object"}}},"required":true},"responses":{"200":{"description":"result string, rows count"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"DAT-804 Format Converter — JSON↔CSV conversion ($0.005)","tags":["data","paid"],"x-amount-usdc":"0.005","x-payment-required":true}},"/v1/data/validate-json":{"post":{"operationId":"dataValidateJson","requestBody":{"content":{"application/json":{"schema":{"properties":{"json":{"type":"string"},"schema":{"type":"object"}},"required":["json","schema"],"type":"object"}}},"required":true},"responses":{"200":{"description":"valid (bool), errors array"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"DAT-803 JSON Schema Validator — type and required field checking ($0.003)","tags":["data","paid"],"x-amount-usdc":"0.003","x-payment-required":true}},"/v1/dcm/crypto-toolkit":{"post":{"operationId":"dcmToolkit","requestBody":{"required":false},"responses":{"200":{"description":"Toolkit metadata + download manifest"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"DCM-1012 Crypto Toolkit (x402)","tags":["crypto","paid"]}},"/v1/decompress":{"post":{"operationId":"decompress","requestBody":{"content":{"application/json":{"schema":{"properties":{"compressed":{"description":"Base64-encoded compressed payload array","type":"array"},"level":{"enum":[1,2,3],"type":"integer"}},"required":["compressed"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Reconstructed float vectors"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"Tensor decompression (x402)","tags":["compression","paid"]}},"/v1/delegate/verify":{"post":{"operationId":"delegateVerify","requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"valid bool, depth_ok, receipt_id, trust_vector"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"IDT-202 Delegation verify — D_MAX=23, 5D trust vector + signed receipt ($0.010)","tags":["identity","delegation","paid"],"x-amount-usdc":"0.010","x-payment-required":true}},"/v1/dev/starter":{"post":{"operationId":"devStarter","requestBody":{"required":false},"responses":{"200":{"description":"Starter pack with Rust handler template, manifest, deployment guide"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"DEV-600 Agent Starter Pack (x402)","tags":["developer","paid"]}},"/v1/efficiency":{"post":{"operationId":"efficiency","requestBody":{"content":{"application/json":{"schema":{"properties":{"cost_after":{"type":"number"},"cost_before":{"type":"number"},"cycles":{"description":"Optimization cycles performed","type":"integer"}},"required":["cost_before","cost_after"],"type":"object"}}},"required":true},"responses":{"200":{"description":"E_c score, platform_fee (20%), agent_rebate"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"PAY-506 Efficiency Capture Engine (x402)","tags":["economics","paid"]}},"/v1/embed":{"post":{"operationId":"embed","requestBody":{"content":{"application/json":{"schema":{"properties":{"level":{"default":3,"enum":[1,2,3],"type":"integer"},"values":{"description":"Raw float array — length must be multiple of 24","items":{"type":"number"},"type":"array"}},"required":["values"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Compressed embedding chunks + ratio"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"Compress raw float array as quantised embedding (x402)","tags":["compression","embeddings","paid"]}},"/v1/ethics/compliance":{"post":{"operationId":"ethicsCompliance","requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"Ethics compliance result"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"Ethics Compliance Check (x402)","tags":["compliance","paid"],"x-amount-usdc":"0.015","x-payment-required":true}},"/v1/governance/vote":{"post":{"operationId":"governanceVote","requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"Vote recorded result"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"Governance Vote (x402)","tags":["governance","paid"],"x-amount-usdc":"0.010","x-payment-required":true}},"/v1/identity/delegation/validate":{"post":{"operationId":"delegationValidate","requestBody":{"content":{"application/json":{"schema":{"properties":{"chain":{"description":"Ordered list of agent IDs in delegation chain","items":{"format":"int64","type":"integer"},"type":"array"},"trust_scores":{"description":"Per-link trust scores (0.0–1.0)","items":{"type":"number"},"type":"array"}},"required":["chain"],"type":"object"}}},"required":true},"responses":{"200":{"description":"valid bool, chain_depth, depth_check, violations, kinetic_cost, trust_compliance"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"IDT-201 Delegation chain validator (x402)","tags":["identity","paid"]}},"/v1/identity/sybil-check":{"post":{"operationId":"identitySybilCheck","requestBody":{"content":{"application/json":{"schema":{"properties":{"agent_ids":{"description":"Array of agent IDs to check for Sybil clusters","items":{"format":"int64","type":"integer"},"type":"array"}},"required":["agent_ids"],"type":"object"}}},"required":true},"responses":{"200":{"description":"valid_count, invalid_ids, sybil_clusters (with risk level), overall_risk"},"400":{"description":"agent_ids required"}},"summary":"Sybil detection — cluster analysis on agent ID set (free)","tags":["identity","security","public"]}},"/v1/identity/verify":{"get":{"operationId":"identityVerify","parameters":[{"description":"Agent ID to verify topological identity","in":"query","name":"id","required":false,"schema":{"format":"int64","type":"integer"}}],"responses":{"200":{"description":"compliant bool, nearest_valid_id, distance_to_next"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"IDT-200 Topological identity verification ($0.020)","tags":["identity","paid"]}},"/v1/inference":{"post":{"operationId":"chatInference","requestBody":{"content":{"application/json":{"schema":{"properties":{"max_tokens":{"default":512,"description":"Maximum tokens to generate","type":"integer"},"messages":{"description":"OpenAI-compatible messages array","items":{"properties":{"content":{"type":"string"},"role":{"type":"string"}},"required":["role","content"],"type":"object"},"type":"array"}},"required":["messages"],"type":"object"}}},"required":true},"responses":{"200":{"description":"OpenAI-compatible chat.completion object with choices, model, helix (anti_hallucination, integrity, compression), and _meta (fee, provider, policy_tau). Includes X-Helix-Model and X-Helix-Integrity response headers."},"402":{"description":"x402 payment challenge"},"405":{"description":"Method not allowed (POST only)"}},"security":[{"x402":[]}],"summary":"INF-900 AI Inference — OpenAI-compatible chat completions. Model: Llama 3.1 8B (Cloudflare Workers AI). $0.025/call.","tags":["inference","paid"]}},"/v1/inference/stream":{"post":{"operationId":"inferenceStream","requestBody":{"content":{"application/json":{"schema":{"properties":{"max_tokens":{"default":512,"type":"integer"},"messages":{"items":{"properties":{"content":{"type":"string"},"role":{"type":"string"}},"required":["role","content"],"type":"object"},"type":"array"}},"required":["messages"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Server-Sent Events stream of token chunks"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"INF-901 CoT Streaming Inference — SSE token stream ($0.025)","tags":["inference","paid"],"x-amount-usdc":"0.025","x-payment-required":true}},"/v1/memory/trim":{"post":{"operationId":"memoryTrim","requestBody":{"content":{"application/json":{"schema":{"properties":{"budget_tokens":{"type":"integer"},"compress":{"type":"boolean"},"messages":{"items":{"type":"object"},"type":"array"},"preserve_system":{"type":"boolean"}},"required":["messages"],"type":"object"}}},"required":true},"responses":{"200":{"description":"trimmed messages, stats: original_count, trimmed_count, tokens_used, utilization_pct"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"INF-815 Memory Context Trimmer (LRU budget, $0.01)","tags":["memory","paid"]}},"/v1/metrics":{"get":{"operationId":"metrics","responses":{"200":{"description":"runtime limits, endpoints list, pricing tiers, products_live count"}},"summary":"Platform metrics — runtime constants + live endpoint registry","tags":["public"]}},"/v1/models/compress":{"post":{"operationId":"modelsCompress","requestBody":{"content":{"application/json":{"schema":{"properties":{"level":{"default":1,"enum":[1,2,3],"type":"integer"},"model_data":{"description":"Base64-encoded model weights","type":"string"}},"required":["model_data"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Compressed model artifact + compression ratio"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"INF-810 Model Compression — per-MB LQ4 compression ($0.50+ per MB)","tags":["models","paid"],"x-amount-usdc":"0.50+","x-payment-required":true}},"/v1/models/download":{"get":{"operationId":"modelsDownload","parameters":[{"description":"Model identifier or object key","in":"query","name":"model","required":true,"schema":{"type":"string"}},{"description":"One-time download token issued after successful purchase","in":"query","name":"token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Model content stream"},"400":{"description":"Token missing/invalid or request malformed"},"404":{"description":"Model not found"}},"summary":"Download purchased HELIX model artifact using one-time token","tags":["models","paid"]}},"/v1/oracle/entropy":{"get":{"operationId":"oracleEntropy","responses":{"200":{"description":"Current epoch, window boundary, nonce_seed_hex for zero-RTT A2A handshake"}},"summary":"DCM-ENT entropy epoch + nonce seed (A2A-ENT)","tags":["oracle","public"]}},"/v1/oracle/hallucination":{"get":{"operationId":"oracleHallucination","responses":{"200":{"description":"EPS_KL threshold, interpretation guide, usage steps"}},"summary":"SEC-305 ε_KL hallucination threshold oracle","tags":["oracle","security","public"]}},"/v1/oracle/v-ai":{"get":{"operationId":"oracleVAI","responses":{"200":{"description":"V_AI value, headroom, alert flag. Cache-TTL = W_entropy (102s)"}},"summary":"DCM-1000 V_AI live constant oracle","tags":["oracle","public"]}},"/v1/payments/fee":{"get":{"operationId":"paymentsFee","parameters":[{"description":"Transaction amount in USDC-6 decimals (1000000 = 1 USDC)","in":"query","name":"amount","required":false,"schema":{"default":1000000,"format":"int64","type":"integer"}}],"responses":{"200":{"description":"fee, pro_fee, tier_label"}},"summary":"routing_fee(amount) free oracle — preview platform fee before paying","tags":["payments","public"]}},"/v1/prompts/download":{"get":{"operationId":"promptsDownload","responses":{"200":{"description":"Markdown file download"},"401":{"description":"API key required"},"404":{"description":"Unknown pack slug"}},"security":[{"apiKey":[]}],"summary":"PRM-100 Prompt Pack Download — fetch purchased Enhancement Architect pack (API-key required)","tags":["prompts","paid"]}},"/v1/prompts/inject-scan":{"post":{"operationId":"promptsInjectScan","requestBody":{"content":{"application/json":{"schema":{"properties":{"prompt":{"type":"string"}},"required":["prompt"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Injection scan result"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"Prompt Injection Scan (x402)","tags":["prompts","security","paid"],"x-amount-usdc":"0.010","x-payment-required":true}},"/v1/prompts/optimize":{"post":{"operationId":"promptsOptimize","requestBody":{"content":{"application/json":{"schema":{"properties":{"prompt":{"type":"string"}},"required":["prompt"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Optimized prompt"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"Prompt Optimization (x402)","tags":["prompts","paid"],"x-amount-usdc":"0.005","x-payment-required":true}},"/v1/ratchet/advance":{"post":{"operationId":"ratchetAdvance","requestBody":{"content":{"application/json":{"schema":{"properties":{"session_id":{"type":"string"}},"required":["session_id"],"type":"object"}}},"required":true},"responses":{"200":{"description":"new_epoch, rekeyed bool, next_rekey_epoch"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"SEC-310 RatchetGate epoch advance + re-key at RG_LOOP=47 ($0.005)","tags":["security","ratchet","paid"],"x-amount-usdc":"0.005","x-payment-required":true}},"/v1/ratchet/probe":{"post":{"operationId":"ratchetProbe","requestBody":{"content":{"application/json":{"schema":{"properties":{"session_ids":{"items":{"type":"string"},"type":"array"}},"required":["session_ids"],"type":"object"}}},"required":true},"responses":{"200":{"description":"health array per session_id"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"SEC-310 RatchetGate batch session health probe ($0.005)","tags":["security","ratchet","paid"],"x-amount-usdc":"0.005","x-payment-required":true}},"/v1/ratchet/register":{"post":{"operationId":"ratchetRegister","requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"session_id, epoch, safe_prime, expires_at"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"SEC-310 RatchetGate session registration — 47-epoch safe prime ratchet ($0.005)","tags":["security","ratchet","paid"],"x-amount-usdc":"0.005","x-payment-required":true}},"/v1/rng/quantum":{"get":{"operationId":"rngQuantum","parameters":[{"description":"Number of random values to generate (max 100)","in":"query","name":"count","required":false,"schema":{"default":1,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Output format: hex (32-char), int (u64), or float (0.0–1.0)","in":"query","name":"format","required":false,"schema":{"default":"hex","enum":["hex","int","float"],"type":"string"}}],"responses":{"200":{"description":"values array, count, entropy_source, epoch"},"429":{"description":"Rate limit exceeded — 47 free calls per 24-hour window (RG_LOOP)"}},"summary":"Quantum-grade RNG — proprietary geometric entropy source (free, 47 calls/day)","tags":["rng","public"]}},"/v1/routing/recommend":{"get":{"operationId":"routingRecommend","parameters":[{"description":"Compression level: 1=standard 2:1, 2=fast 4:1, 3=pro 8:1","in":"query","name":"level","required":false,"schema":{"default":1,"enum":[1,2,3],"type":"integer"}}],"responses":{"200":{"description":"tier, compression_ratio, fee_multiplier, cache_ttl_s, routing_bias"}},"summary":"Compression level → routing tier recommendation (W-034)","tags":["routing","public"]}},"/v1/security/pqc-sign":{"post":{"operationId":"securityPqcSign","requestBody":{"content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"required":["message"],"type":"object"}}},"required":true},"responses":{"200":{"description":"signature, public_key, algorithm"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"SEC-311 Post-quantum Dilithium signing via aethel-shield ($0.020)","tags":["security","pqc","paid"],"x-amount-usdc":"0.020","x-payment-required":true}},"/v1/security/shield":{"post":{"operationId":"securityShield","requestBody":{"content":{"application/json":{"schema":{"properties":{"payload":{"type":"string"}},"required":["payload"],"type":"object"}}},"required":true},"responses":{"200":{"description":"hardened_payload, lattice_params, scalar_blind"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"SEC-312 Aethel-Shield lattice hardening — scalar blinding + PQC wrap ($0.020)","tags":["security","pqc","paid"],"x-amount-usdc":"0.020","x-payment-required":true}},"/v1/security/zero-day":{"post":{"operationId":"zeroDayDetector","requestBody":{"content":{"application/json":{"schema":{"properties":{"payload":{"type":"string"},"trust_score":{"maximum":1,"minimum":0,"type":"number"}},"required":["payload"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Detection result + alert hooks"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"SEC-308 Zero-Day Detector (x402)","tags":["security","paid"]}},"/v1/swarm/inbox":{"get":{"operationId":"swarmInbox","parameters":[{"description":"Agent ID (must pass platform identity check) to retrieve messages for","in":"query","name":"agent_id","required":true,"schema":{"format":"int64","type":"integer"}}],"responses":{"200":{"description":"messages array, count, epoch. Messages expire after 3 entropy windows."},"400":{"description":"identity_invalid"}},"summary":"Agent message inbox — direct messages + broadcasts (free)","tags":["swarm","public"]}},"/v1/swarm/relay":{"post":{"operationId":"swarmRelay","requestBody":{"content":{"application/json":{"schema":{"properties":{"epoch":{"description":"Sender's current entropy epoch. Accepted: current ±1 window (W-042 tolerance).","format":"int64","type":"integer"},"frame_type":{"default":"acp","enum":["acp","tce24"],"type":"string"},"from_id":{"description":"Sender agent ID (0 = anonymous)","format":"int64","type":"integer"},"payload":{"description":"Base64-encoded message payload (ACP JSON or TCE-24 binary, max 64KiB)","type":"string"},"to_id":{"description":"Recipient agent ID (0 = broadcast)","format":"int64","type":"integer"}},"required":["to_id","payload","epoch"],"type":"object"}}},"required":true},"responses":{"200":{"description":"relayed bool, message_id, epoch, expires_at (~306s = 3 × W_ENTROPY_S)"},"400":{"description":"identity_invalid, epoch_stale, or payload_too_large"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"A2A-ENT ACP/TCE-24 message relay — agent-to-agent communication bus (x402)","tags":["swarm","paid"]}},"/v1/text/keywords":{"post":{"operationId":"textKeywords","requestBody":{"content":{"application/json":{"schema":{"properties":{"max_keywords":{"default":10,"type":"integer"},"text":{"type":"string"}},"required":["text"],"type":"object"}}},"required":true},"responses":{"200":{"description":"keywords array with word and score, total_words"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"TXT-801 Keyword Extractor — TF-IDF approximation ($0.005)","tags":["text","paid"],"x-amount-usdc":"0.005","x-payment-required":true}},"/v1/text/sentiment":{"post":{"operationId":"textSentiment","requestBody":{"content":{"application/json":{"schema":{"properties":{"text":{"type":"string"}},"required":["text"],"type":"object"}}},"required":true},"responses":{"200":{"description":"sentiment (positive/negative/neutral), score (-1 to 1), confidence"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"TXT-802 Sentiment Analyzer — lexicon-based with negation handling ($0.005)","tags":["text","paid"],"x-amount-usdc":"0.005","x-payment-required":true}},"/v1/text/summarize":{"post":{"operationId":"textSummarize","requestBody":{"content":{"application/json":{"schema":{"properties":{"max_sentences":{"default":3,"type":"integer"},"text":{"type":"string"}},"required":["text"],"type":"object"}}},"required":true},"responses":{"200":{"description":"summary, word_count_original, word_count_summary, compression_ratio"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"TXT-800 Text Summarizer — extractive 1-3 sentence summary ($0.01)","tags":["text","paid"],"x-amount-usdc":"0.010","x-payment-required":true}},"/v1/threat/score":{"post":{"operationId":"threatScore","requestBody":{"content":{"application/json":{"schema":{"properties":{"behavioral":{"maximum":1.0,"minimum":0.0,"type":"number"},"intent":{"maximum":1.0,"minimum":0.0,"type":"number"},"velocity":{"maximum":1.0,"minimum":0.0,"type":"number"}},"required":["velocity","behavioral","intent"],"type":"object"}}},"required":true},"responses":{"200":{"description":"consensus_score, alert (>0.50), action (>0.85), K₁₂ weights"},"402":{"description":"x402 payment challenge"}},"security":[{"x402":[]}],"summary":"SEC-303 Triality-weighted threat consensus (x402)","tags":["security","paid"]}},"/v1/trust/decay":{"post":{"operationId":"trustDecay","requestBody":{"content":{"application/json":{"schema":{"properties":{"interactions":{"default":1,"description":"Number of interactions (slows decay)","type":"integer"},"last_seen_s":{"description":"Unix timestamp of last agent activity","format":"int64","type":"integer"},"trust_score":{"default":1.0,"description":"Initial trust score","maximum":1.0,"minimum":0.0,"type":"number"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"trust_in, trust_out, decay_factor, elapsed_s, half_life_s, pct_decayed, status (trusted/degraded/suspect/quarantine)"}},"summary":"TAU_TRUST exponential trust decay calculator (free)","tags":["trust","public"]}}},"servers":[{"url":"https://aaaa-nexus.atomadictech.workers.dev"}]}