{ "openapi": "3.1.0", "info": { "title": "California Bitcoin Agent Commerce API", "version": "1.2.0", "description": "California Bitcoin is source-backed Bitcoin research and verification infrastructure for AI agents. Start free with deterministic search and answers. When a difficult question requires a compact evidence-grade specialist answer, use the $1 answer-question product; claim verification, evidence packs, timelines, deep grounding, and batch research remain distinct paid jobs.", "x-guidance": "START HERE: call start_bitcoin_research with the caller's real Bitcoin question or task for a free deterministic answer and coverage check. Free answer_bitcoin_question and search_bitcoin_knowledge remain available for evaluation and retrieval. Use answer_bitcoin_question_with_evidence when the caller wants California Bitcoin to produce a compact source-backed answer to a difficult natural-language question with consensus/policy/version distinctions, contradiction handling, confidence, and primary-source evidence. Use verify_bitcoin_claim only when the caller already has one proposition to adjudicate; get_bitcoin_evidence_pack when the primary need is evidence rather than an answer; build_bitcoin_timeline for chronology; deep_ground_bitcoin for deeper multi-source investigation; and batch_bitcoin_research for multiple items. If a prior paid result carries evidenceCheckpoint, compare it for free before repurchasing covered historical research. If free coverage is insufficient or out of scope, do not pay. Only invoke a paid research tool when the caller has approved the exact spending budget. Paid HTTP research uses MPP: the first valid unpaid request returns HTTP 402 Payment Required. Fulfill the Payment challenge and retry the identical request with the payment credential.", "x-not-for": [ "Live prices: use a market-data API.", "Current transactions, balances, blocks or fees: use a Bitcoin node or chain API.", "Breaking or uncovered facts: inspect current primary sources.", "Uncovered historical attribution: do not substitute a generic topical answer for evidence of what a person actually said or wrote.", "General web discovery: use search first, then use the smallest relevant specialist operation only when maintained coverage exists." ], "x-discovery-keywords": [ "free Bitcoin research MCP", "free source-backed Bitcoin answers", "Bitcoin research MCP for AI agents", "Bitcoin agent research start here", "source-backed Bitcoin question answering", "Bitcoin consensus policy answer API", "Bitcoin claim verification", "Bitcoin fact verification API", "source-backed Bitcoin API", "Bitcoin primary-source research", "Bitcoin evidence API", "Bitcoin verification MCP", "Bitcoin evidence MCP", "Bitcoin timeline API", "Bitcoin source evidence API", "Bitcoin research tool for AI agents", "deterministic Bitcoin research", "Bitcoin protocol evidence API", "Bitcoin claim verification service", "pay-per-call Bitcoin research", "primary-source Bitcoin evidence", "Bitcoin evidence checkpoint" ], "x-use-when": [ "Start an unfamiliar AI agent on a real Bitcoin question with a useful free source-backed answer before any payment decision.", "Get a compact evidence-grade answer to a difficult natural-language Bitcoin question with consensus, policy, implementation, version, contradiction, and primary-source distinctions.", "Verify a specific Bitcoin claim against maintained evidence.", "Retrieve source-backed Bitcoin evidence with provenance and exact source locators when available.", "Build a sourced Bitcoin timeline from maintained historical evidence.", "Ground an AI answer in maintained Bitcoin knowledge before using it downstream.", "Check contradictions, caveats, and temporal validity around a Bitcoin proposition.", "Evaluate Bitcoin protocol claims against primary-source and official evidence.", "Compare a previously returned retained-evidence checkpoint for free before repurchasing covered historical research." ], "x-differentiator": "Free evaluation first, then maintained deterministic primary-source-first Bitcoin evidence infrastructure with explicit consensus-vs-policy distinctions, uncertainty, contradiction handling, temporal context, evidence specificity, exact locators where maintained, and a small integrity-checked retained-excerpt layer for narrow historical attribution questions.", "x-evidence-standard": { "version": "1.1.0", "principles": [ "Only maintained claims with status supported are eligible to produce an unqualified verification verdict.", "Contextual, disputed, and outdated claims may be returned as context but cannot independently verify or falsify a proposition.", "Primary and official sources are preferred when available, but source authority is reported separately from claim-match confidence.", "Exact locator-backed evidence is distinguished from source-level evidence. A source URL alone is not represented as exact passage-level support.", "Retained primary-source excerpts are integrity-checked and explicitly scoped. Their presence does not imply passage-level verification for the broader Fact Graph.", "Historical attribution questions without a sufficiently matched retained dossier stop with an explicit evidence gap instead of receiving a generic topical answer.", "Source count and publisher diversity are descriptive and must not be treated as proof of independent confirmation.", "Contradiction review reports maintained conflicting evidence only; absence of a conflict does not prove that no contrary evidence exists elsewhere.", "Currentness is represented through explicit asOf, validThrough, or reverifyAfter metadata when maintained. Dataset update time alone is not treated as a source verification date.", "Insufficient evidence is a valid research result. Payment does not guarantee coverage or a favorable verdict." ], "citationPrecision": [ "retained_excerpt", "exact_locator", "source_level" ], "verdicts": [ "supported", "mostly_supported", "false", "mixed", "partially_verified", "insufficient_evidence" ] }, "contact": { "email": "hello@californiabitcoin.org" }, "x-source-freshness": { "schemaVersion": "bitcoin-source-watch-summary.v1", "coverageEndpoint": "https://californiabitcoin.org/api/agent/v1/coverage", "watchedAuthoritativeSources": 18, "trustRule": "Source changes are detected and mapped to maintained claims, but never automatically promoted into trusted Bitcoin knowledge.", "persistenceBoundary": "Discovery and paid responses report persisted reviewed source-watch state. The scheduled watcher alerts on upstream drift; it does not silently rewrite trusted state.", "lastCheckedMeaning": "Time a machine successfully attempted or completed an upstream identity check. It is operational metadata only.", "lastAttemptedMeaning": "Most recent persisted machine check attempt, successful or failed. Failed attempts do not advance lastChecked or semantic verification.", "lastVerifiedMeaning": "Time maintained Bitcoin meaning was semantically verified against evidence. Machine availability or an unchanged hash must never advance it." } }, "servers": [ { "url": "https://californiabitcoin.org" } ], "x-service-info": { "categories": [ "bitcoin", "verification", "evidence", "research", "knowledge", "ai-agents", "mcp", "data", "search", "developer-tools", "a2a", "agent-to-agent", "delegation" ], "docs": { "homepage": "https://californiabitcoin.org/developers/", "apiReference": "https://californiabitcoin.org/developers/", "llms": "https://californiabitcoin.org/llms.txt" }, "a2a": { "agentCard": "https://californiabitcoin.org/.well-known/agent-card.json", "endpoint": "https://californiabitcoin.org/a2a", "protocolVersion": "1.0", "protocolBinding": "JSONRPC" } }, "paths": { "/api/agent/v1": { "get": { "security": [], "operationId": "getAgentCommerceCapabilities", "summary": "Discover Agent Commerce capabilities, product guidance, pricing, and evidence standard", "responses": { "200": { "description": "Capability, product, and evidence-standard index", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/agent/v1/start": { "post": { "security": [], "operationId": "startBitcoinResearch", "summary": "START HERE with a free source-backed Bitcoin answer and safe next-action recommendation", "description": "FREE, no account and no payment. START HERE with any Bitcoin question or research task. Returns a source-backed deterministic answer, compact maintained-coverage matches, and the smallest safe next action. This tool never authorizes or initiates payment.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "query" ], "additionalProperties": false }, "example": { "query": "Is it true that Bitcoin has no central issuer?" } } } }, "responses": { "200": { "description": "Structured deterministic California Bitcoin knowledge result", "content": { "application/json": { "schema": { "type": "object", "properties": { "operation": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "access": { "enum": [ "free", "paid" ] }, "price": { "type": "object", "properties": { "currency": { "type": "string" }, "amountCents": { "type": "integer" } } }, "result": { "type": "object" }, "paymentReceipt": { "type": "object" } }, "required": [ "operation", "access", "price", "result" ] } } } }, "400": { "description": "Invalid input" } } } }, "/api/agent/v1/select-product": { "post": { "security": [], "operationId": "selectBitcoinResearchProduct", "summary": "Select the appropriate free or paid research product without authorizing payment", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "task": { "type": "string", "enum": [ "answer", "verify", "evidence", "chronology", "dossier", "batch", "learn" ] } }, "required": [ "task" ], "additionalProperties": false }, "example": { "task": "answer" } } } }, "responses": { "200": { "description": "Structured deterministic California Bitcoin knowledge result", "content": { "application/json": { "schema": { "type": "object", "properties": { "operation": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "access": { "enum": [ "free", "paid" ] }, "price": { "type": "object", "properties": { "currency": { "type": "string" }, "amountCents": { "type": "integer" } } }, "result": { "type": "object" }, "paymentReceipt": { "type": "object" } }, "required": [ "operation", "access", "price", "result" ] } } } }, "400": { "description": "Invalid input" } } } }, "/api/agent/v1/search": { "get": { "security": [], "operationId": "searchBitcoinKnowledge", "summary": "Search canonical Bitcoin knowledge", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 2000 } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 10, "default": 5 } } ], "responses": { "200": { "description": "Structured deterministic California Bitcoin knowledge result", "content": { "application/json": { "schema": { "type": "object", "properties": { "operation": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "access": { "enum": [ "free", "paid" ] }, "price": { "type": "object", "properties": { "currency": { "type": "string" }, "amountCents": { "type": "integer" } } }, "result": { "type": "object" }, "paymentReceipt": { "type": "object" } }, "required": [ "operation", "access", "price", "result" ] } } } }, "400": { "description": "Invalid input" } } } }, "/api/agent/v1/topic/{id}": { "get": { "security": [], "operationId": "getBitcoinTopic", "summary": "Retrieve one canonical Knowledge Atlas topic", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]+$" } } ], "responses": { "200": { "description": "Structured deterministic California Bitcoin knowledge result", "content": { "application/json": { "schema": { "type": "object", "properties": { "operation": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "access": { "enum": [ "free", "paid" ] }, "price": { "type": "object", "properties": { "currency": { "type": "string" }, "amountCents": { "type": "integer" } } }, "result": { "type": "object" }, "paymentReceipt": { "type": "object" } }, "required": [ "operation", "access", "price", "result" ] } } } }, "400": { "description": "Invalid input" }, "404": { "description": "Topic not found" } } } }, "/api/agent/v1/answer": { "post": { "security": [], "operationId": "answerBitcoinQuestion", "summary": "Answer a Bitcoin question deterministically for free", "description": "FREE, no account required. Return a concise deterministic answer grounded in maintained Bitcoin knowledge. Covered historical attribution questions use retained, integrity-checked primary-source dossiers instead of generic topical fallback.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "query" ], "additionalProperties": false }, "example": { "query": "Did Satoshi ever describe Bitcoin as anonymous?" } } } }, "responses": { "200": { "description": "Structured deterministic California Bitcoin knowledge result", "content": { "application/json": { "schema": { "type": "object", "properties": { "operation": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "access": { "enum": [ "free", "paid" ] }, "price": { "type": "object", "properties": { "currency": { "type": "string" }, "amountCents": { "type": "integer" } } }, "result": { "type": "object" }, "paymentReceipt": { "type": "object" } }, "required": [ "operation", "access", "price", "result" ] } } } }, "400": { "description": "Invalid input" } } } }, "/api/agent/v1/answer-question": { "post": { "operationId": "answerBitcoinQuestionWithEvidence", "summary": "Get a compact source-backed specialist answer to a difficult Bitcoin question", "description": "Get a compact, source-backed answer to a difficult natural-language Bitcoin question using the maintained Fact Graph and evidence system, with consensus-vs-policy classification, implementation and version qualification, contradiction handling, confidence, primary-source evidence, exact locators where maintained, provenance, and explicit uncertainty. Currentness-sensitive answers include persisted maintained source-watch state and fail safely when relevant authoritative evidence changed or requires review.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "query" ], "additionalProperties": false }, "example": { "query": "Does Bitcoin have finality after six confirmations?" } } } }, "x-product-id": "californiabitcoin.answer_question", "x-payment-info": { "offers": [ { "intent": "charge", "method": "stripe", "amount": "100", "currency": "usd", "description": "Get a compact, source-backed answer to a difficult natural-language Bitcoin question using the maintained Fact Graph and evidence system, with consensus-vs-policy classification, implementation and version qualification, contradiction handling, confidence, primary-source evidence, exact locators where maintained, provenance, and explicit uncertainty." }, { "intent": "charge", "method": "tempo", "amount": "1000000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "Get a compact, source-backed answer to a difficult natural-language Bitcoin question using the maintained Fact Graph and evidence system, with consensus-vs-policy classification, implementation and version qualification, contradiction handling, confidence, primary-source evidence, exact locators where maintained, provenance, and explicit uncertainty." }, { "protocol": "x402", "version": 2, "scheme": "exact", "amount": "1000000", "asset": "USDC", "network": "eip155:8453", "description": "Get a compact, source-backed answer to a difficult natural-language Bitcoin question using the maintained Fact Graph and evidence system, with consensus-vs-policy classification, implementation and version qualification, contradiction handling, confidence, primary-source evidence, exact locators where maintained, provenance, and explicit uncertainty." } ], "price": { "mode": "fixed", "currency": "USD", "amount": "1.000000" }, "protocols": [ { "mpp": { "method": "stripe", "intent": "charge", "currency": "usd" } }, { "mpp": { "method": "tempo", "intent": "charge", "currency": "0x20C000000000000000000000b9537d11c60E8b50" } }, { "x402": { "version": 2, "scheme": "exact", "asset": "USDC", "network": "eip155:8453" } } ] }, "responses": { "200": { "description": "Structured deterministic California Bitcoin knowledge result", "content": { "application/json": { "schema": { "type": "object", "properties": { "operation": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "access": { "enum": [ "free", "paid" ] }, "price": { "type": "object", "properties": { "currency": { "type": "string" }, "amountCents": { "type": "integer" } } }, "result": { "type": "object" }, "paymentReceipt": { "type": "object" } }, "required": [ "operation", "access", "price", "result" ] } } } }, "400": { "description": "Invalid input" }, "402": { "description": "Payment Required. MPP uses WWW-Authenticate; x402 v2 HTTP uses PAYMENT-REQUIRED. Retry with the matching payment credential or proof.", "content": { "application/problem+json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "format": "uri" }, "title": { "type": "string" }, "status": { "type": "integer" }, "detail": { "type": "string" }, "payment": { "type": "object" } }, "required": [ "type", "title", "status", "detail" ] } } } }, "503": { "description": "Payment or knowledge provider temporarily unavailable" } } } }, "/api/agent/v1/checkpoint": { "post": { "security": [], "operationId": "checkBitcoinEvidenceCheckpoint", "summary": "Compare a retained-evidence checkpoint for free", "description": "FREE, no account and no payment. Compare a previously returned retained-evidence checkpoint with the current maintained dossier content identity before deciding whether to rerun or repurchase covered historical research.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "checkpointId": { "type": "string", "minLength": 1, "maxLength": 200 }, "expectedDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "checkpointId", "expectedDigest" ], "additionalProperties": false }, "example": { "checkpointId": "primary-source-dossier:satoshi-anonymity", "expectedDigest": "sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef" } } } }, "responses": { "200": { "description": "Structured deterministic California Bitcoin knowledge result", "content": { "application/json": { "schema": { "type": "object", "properties": { "operation": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "access": { "enum": [ "free", "paid" ] }, "price": { "type": "object", "properties": { "currency": { "type": "string" }, "amountCents": { "type": "integer" } } }, "result": { "type": "object" }, "paymentReceipt": { "type": "object" } }, "required": [ "operation", "access", "price", "result" ] } } } }, "400": { "description": "Invalid input" } } } }, "/api/agent/v1/verify-claim": { "post": { "operationId": "verifyBitcoinClaim", "summary": "Verify one concrete Bitcoin claim with verdict-eligible maintained evidence", "description": "Evaluate one specific Bitcoin factual proposition against verdict-eligible maintained atomic claims and return a conservative supported, contradicted, mixed, partially verified, or insufficient-evidence verdict with source-backed evidence metadata.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "claim": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "claim" ], "additionalProperties": false }, "example": { "claim": "Bitcoin has no central issuer" } } } }, "x-payment-info": { "offers": [ { "intent": "charge", "method": "stripe", "amount": "10", "currency": "usd", "description": "Evaluate one specific Bitcoin factual proposition against verdict-eligible maintained atomic claims and return a conservative supported, contradicted, mixed, partially verified, or insufficient-evidence verdict with source-backed evidence metadata." }, { "intent": "charge", "method": "tempo", "amount": "100000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "Evaluate one specific Bitcoin factual proposition against verdict-eligible maintained atomic claims and return a conservative supported, contradicted, mixed, partially verified, or insufficient-evidence verdict with source-backed evidence metadata." }, { "protocol": "x402", "version": 2, "scheme": "exact", "amount": "100000", "asset": "USDC", "network": "eip155:8453", "description": "Evaluate one specific Bitcoin factual proposition against verdict-eligible maintained atomic claims and return a conservative supported, contradicted, mixed, partially verified, or insufficient-evidence verdict with source-backed evidence metadata." } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "mpp": { "method": "stripe", "intent": "charge", "currency": "usd" } }, { "mpp": { "method": "tempo", "intent": "charge", "currency": "0x20C000000000000000000000b9537d11c60E8b50" } }, { "x402": { "version": 2, "scheme": "exact", "asset": "USDC", "network": "eip155:8453" } } ] }, "responses": { "200": { "description": "Structured deterministic California Bitcoin knowledge result", "content": { "application/json": { "schema": { "type": "object", "properties": { "operation": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "access": { "enum": [ "free", "paid" ] }, "price": { "type": "object", "properties": { "currency": { "type": "string" }, "amountCents": { "type": "integer" } } }, "result": { "type": "object" }, "paymentReceipt": { "type": "object" } }, "required": [ "operation", "access", "price", "result" ] } } } }, "400": { "description": "Invalid input" }, "402": { "description": "Payment Required. MPP uses WWW-Authenticate; x402 v2 HTTP uses PAYMENT-REQUIRED. Retry with the matching payment credential or proof.", "content": { "application/problem+json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "format": "uri" }, "title": { "type": "string" }, "status": { "type": "integer" }, "detail": { "type": "string" }, "payment": { "type": "object" } }, "required": [ "type", "title", "status", "detail" ] } } } }, "503": { "description": "Payment or knowledge provider temporarily unavailable" } } } }, "/api/agent/v1/evidence-pack": { "post": { "operationId": "getBitcoinEvidencePack", "summary": "Build a structured Bitcoin evidence pack for a known research target", "description": "Build a focused Bitcoin evidence package when the agent already knows what it is researching and primarily needs compact source material, atomic claims, conflicts, source authority, exact-locator precision, caveats, provenance, and temporal scope.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "query" ], "additionalProperties": false }, "example": { "query": "How does Bitcoin proof of work secure the network?" } } } }, "x-payment-info": { "offers": [ { "intent": "charge", "method": "stripe", "amount": "15", "currency": "usd", "description": "Build a focused Bitcoin evidence package when the agent already knows what it is researching and primarily needs compact source material, atomic claims, conflicts, source authority, exact-locator precision, caveats, provenance, and temporal scope." }, { "intent": "charge", "method": "tempo", "amount": "150000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "Build a focused Bitcoin evidence package when the agent already knows what it is researching and primarily needs compact source material, atomic claims, conflicts, source authority, exact-locator precision, caveats, provenance, and temporal scope." }, { "protocol": "x402", "version": 2, "scheme": "exact", "amount": "150000", "asset": "USDC", "network": "eip155:8453", "description": "Build a focused Bitcoin evidence package when the agent already knows what it is researching and primarily needs compact source material, atomic claims, conflicts, source authority, exact-locator precision, caveats, provenance, and temporal scope." } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.150000" }, "protocols": [ { "mpp": { "method": "stripe", "intent": "charge", "currency": "usd" } }, { "mpp": { "method": "tempo", "intent": "charge", "currency": "0x20C000000000000000000000b9537d11c60E8b50" } }, { "x402": { "version": 2, "scheme": "exact", "asset": "USDC", "network": "eip155:8453" } } ] }, "responses": { "200": { "description": "Structured deterministic California Bitcoin knowledge result", "content": { "application/json": { "schema": { "type": "object", "properties": { "operation": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "access": { "enum": [ "free", "paid" ] }, "price": { "type": "object", "properties": { "currency": { "type": "string" }, "amountCents": { "type": "integer" } } }, "result": { "type": "object" }, "paymentReceipt": { "type": "object" } }, "required": [ "operation", "access", "price", "result" ] } } } }, "400": { "description": "Invalid input" }, "402": { "description": "Payment Required. MPP uses WWW-Authenticate; x402 v2 HTTP uses PAYMENT-REQUIRED. Retry with the matching payment credential or proof.", "content": { "application/problem+json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "format": "uri" }, "title": { "type": "string" }, "status": { "type": "integer" }, "detail": { "type": "string" }, "payment": { "type": "object" } }, "required": [ "type", "title", "status", "detail" ] } } } }, "503": { "description": "Payment or knowledge provider temporarily unavailable" } } } }, "/api/agent/v1/timeline": { "post": { "operationId": "buildBitcoinTimeline", "summary": "Build a query-specific historical Bitcoin timeline", "description": "Build a query-specific chronological Bitcoin research timeline that distinguishes event dates, source dates, effective dates, source-level support, exact locators, and maintained re-verification boundaries.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 2000 }, "fromYear": { "type": "integer", "minimum": 1900, "maximum": 2200 }, "toYear": { "type": "integer", "minimum": 1900, "maximum": 2200 }, "limit": { "type": "integer", "minimum": 1, "maximum": 40, "default": 40 } }, "required": [ "query" ], "additionalProperties": false }, "example": { "query": "Bitcoin halvings", "fromYear": 2012, "toYear": 2024, "limit": 10 } } } }, "x-payment-info": { "offers": [ { "intent": "charge", "method": "stripe", "amount": "10", "currency": "usd", "description": "Build a query-specific chronological Bitcoin research timeline that distinguishes event dates, source dates, effective dates, source-level support, exact locators, and maintained re-verification boundaries." }, { "intent": "charge", "method": "tempo", "amount": "100000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "Build a query-specific chronological Bitcoin research timeline that distinguishes event dates, source dates, effective dates, source-level support, exact locators, and maintained re-verification boundaries." }, { "protocol": "x402", "version": 2, "scheme": "exact", "amount": "100000", "asset": "USDC", "network": "eip155:8453", "description": "Build a query-specific chronological Bitcoin research timeline that distinguishes event dates, source dates, effective dates, source-level support, exact locators, and maintained re-verification boundaries." } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "mpp": { "method": "stripe", "intent": "charge", "currency": "usd" } }, { "mpp": { "method": "tempo", "intent": "charge", "currency": "0x20C000000000000000000000b9537d11c60E8b50" } }, { "x402": { "version": 2, "scheme": "exact", "asset": "USDC", "network": "eip155:8453" } } ] }, "responses": { "200": { "description": "Structured deterministic California Bitcoin knowledge result", "content": { "application/json": { "schema": { "type": "object", "properties": { "operation": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "access": { "enum": [ "free", "paid" ] }, "price": { "type": "object", "properties": { "currency": { "type": "string" }, "amountCents": { "type": "integer" } } }, "result": { "type": "object" }, "paymentReceipt": { "type": "object" } }, "required": [ "operation", "access", "price", "result" ] } } } }, "400": { "description": "Invalid input" }, "402": { "description": "Payment Required. MPP uses WWW-Authenticate; x402 v2 HTTP uses PAYMENT-REQUIRED. Retry with the matching payment credential or proof.", "content": { "application/problem+json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "format": "uri" }, "title": { "type": "string" }, "status": { "type": "integer" }, "detail": { "type": "string" }, "payment": { "type": "object" } }, "required": [ "type", "title", "status", "detail" ] } } } }, "503": { "description": "Payment or knowledge provider temporarily unavailable" } } } }, "/api/agent/v1/deep-ground": { "post": { "operationId": "deepGroundBitcoin", "summary": "Build a deep deterministic multi-source Bitcoin grounding package", "description": "Produce a deeper deterministic multi-source Bitcoin research dossier across canonical topics, verdict-eligible atomic claims, contextual material, conflicting evidence, source hierarchy, exact-locator precision, temporal scope, history, and caveats.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "query" ], "additionalProperties": false }, "example": { "query": "Why is Bitcoin supply limited?" } } } }, "x-payment-info": { "offers": [ { "intent": "charge", "method": "stripe", "amount": "25", "currency": "usd", "description": "Produce a deeper deterministic multi-source Bitcoin research dossier across canonical topics, verdict-eligible atomic claims, contextual material, conflicting evidence, source hierarchy, exact-locator precision, temporal scope, history, and caveats." }, { "intent": "charge", "method": "tempo", "amount": "250000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "Produce a deeper deterministic multi-source Bitcoin research dossier across canonical topics, verdict-eligible atomic claims, contextual material, conflicting evidence, source hierarchy, exact-locator precision, temporal scope, history, and caveats." }, { "protocol": "x402", "version": 2, "scheme": "exact", "amount": "250000", "asset": "USDC", "network": "eip155:8453", "description": "Produce a deeper deterministic multi-source Bitcoin research dossier across canonical topics, verdict-eligible atomic claims, contextual material, conflicting evidence, source hierarchy, exact-locator precision, temporal scope, history, and caveats." } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.250000" }, "protocols": [ { "mpp": { "method": "stripe", "intent": "charge", "currency": "usd" } }, { "mpp": { "method": "tempo", "intent": "charge", "currency": "0x20C000000000000000000000b9537d11c60E8b50" } }, { "x402": { "version": 2, "scheme": "exact", "asset": "USDC", "network": "eip155:8453" } } ] }, "responses": { "200": { "description": "Structured deterministic California Bitcoin knowledge result", "content": { "application/json": { "schema": { "type": "object", "properties": { "operation": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "access": { "enum": [ "free", "paid" ] }, "price": { "type": "object", "properties": { "currency": { "type": "string" }, "amountCents": { "type": "integer" } } }, "result": { "type": "object" }, "paymentReceipt": { "type": "object" } }, "required": [ "operation", "access", "price", "result" ] } } } }, "400": { "description": "Invalid input" }, "402": { "description": "Payment Required. MPP uses WWW-Authenticate; x402 v2 HTTP uses PAYMENT-REQUIRED. Retry with the matching payment credential or proof.", "content": { "application/problem+json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "format": "uri" }, "title": { "type": "string" }, "status": { "type": "integer" }, "detail": { "type": "string" }, "payment": { "type": "object" } }, "required": [ "type", "title", "status", "detail" ] } } } }, "503": { "description": "Payment or knowledge provider temporarily unavailable" } } } }, "/api/agent/v1/batch": { "post": { "operationId": "batchBitcoinResearch", "summary": "Process up to 20 distinct Bitcoin research items", "description": "Process up to 20 distinct Bitcoin claims, questions, or evidence requests in one deterministic research package while preserving per-item verdict and evidence-quality semantics.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "minItems": 1, "maxItems": 20, "items": { "oneOf": [ { "type": "string", "minLength": 1, "maxLength": 2000 }, { "type": "object", "properties": { "type": { "enum": [ "question", "claim", "evidence" ] }, "text": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "text" ], "additionalProperties": false } ] } } }, "required": [ "items" ], "additionalProperties": false }, "example": { "items": [ { "type": "claim", "text": "Bitcoin has no central issuer" }, { "type": "question", "text": "What is the halving?" } ] } } } }, "x-payment-info": { "offers": [ { "intent": "charge", "method": "stripe", "amount": "50", "currency": "usd", "description": "Process up to 20 distinct Bitcoin claims, questions, or evidence requests in one deterministic research package while preserving per-item verdict and evidence-quality semantics." }, { "intent": "charge", "method": "tempo", "amount": "500000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "Process up to 20 distinct Bitcoin claims, questions, or evidence requests in one deterministic research package while preserving per-item verdict and evidence-quality semantics." }, { "protocol": "x402", "version": 2, "scheme": "exact", "amount": "500000", "asset": "USDC", "network": "eip155:8453", "description": "Process up to 20 distinct Bitcoin claims, questions, or evidence requests in one deterministic research package while preserving per-item verdict and evidence-quality semantics." } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.500000" }, "protocols": [ { "mpp": { "method": "stripe", "intent": "charge", "currency": "usd" } }, { "mpp": { "method": "tempo", "intent": "charge", "currency": "0x20C000000000000000000000b9537d11c60E8b50" } }, { "x402": { "version": 2, "scheme": "exact", "asset": "USDC", "network": "eip155:8453" } } ] }, "responses": { "200": { "description": "Structured deterministic California Bitcoin knowledge result", "content": { "application/json": { "schema": { "type": "object", "properties": { "operation": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "access": { "enum": [ "free", "paid" ] }, "price": { "type": "object", "properties": { "currency": { "type": "string" }, "amountCents": { "type": "integer" } } }, "result": { "type": "object" }, "paymentReceipt": { "type": "object" } }, "required": [ "operation", "access", "price", "result" ] } } } }, "400": { "description": "Invalid input" }, "402": { "description": "Payment Required. MPP uses WWW-Authenticate; x402 v2 HTTP uses PAYMENT-REQUIRED. Retry with the matching payment credential or proof.", "content": { "application/problem+json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "format": "uri" }, "title": { "type": "string" }, "status": { "type": "integer" }, "detail": { "type": "string" }, "payment": { "type": "object" } }, "required": [ "type", "title", "status", "detail" ] } } } }, "503": { "description": "Payment or knowledge provider temporarily unavailable" } } } }, "/mcp": { "post": { "operationId": "californiaBitcoinMcp", "summary": "California Bitcoin remote MCP Streamable HTTP endpoint", "description": "Supports MCP 2026-07-28, 2025-11-25, and Muse-compatible 2025-06-18. Paid tools use the MPP JSON-RPC/MCP transport and the same evidence standard as HTTP.", "responses": { "200": { "description": "JSON-RPC MCP response" } } } }, "/api/agent/v1/coverage": { "get": { "security": [], "operationId": "getBitcoinKnowledgeCoverage", "summary": "Inspect maintained Bitcoin evidence coverage and persisted authoritative-source freshness for free", "description": "Free inspection of maintained topic, source, history, Fact Graph, exact-locator coverage, contradiction modeling, protocol references, temporal qualification, and dataset versions before purchasing research.", "responses": { "200": { "description": "Knowledge coverage and evidence-maturity summary" } } } }, "/api/agent/v1/sources": { "get": { "security": [], "operationId": "listBitcoinSources", "summary": "Inspect authority-ranked Bitcoin sources", "description": "Free source registry for evaluating provenance before purchasing research.", "parameters": [ { "name": "type", "in": "query", "schema": { "type": "string" } }, { "name": "tier", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 9 } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 100 } } ], "responses": { "200": { "description": "Filtered source registry" }, "400": { "description": "Invalid filter" } } } }, "/a2a": { "post": { "security": [], "operationId": "californiaBitcoinA2a", "summary": "Delegate synchronous Bitcoin specialist work through A2A 1.0 JSON-RPC", "description": "A2A 1.0 synchronous direct-message delegation over the same maintained California Bitcoin evidence substrate. Supports grounded Bitcoin research, retained primary-source attribution when covered, and free evidence-checkpoint comparison. Streaming, push notifications, persistent tasks, and paid A2A execution are not advertised in v1.", "parameters": [ { "name": "A2A-Version", "in": "header", "required": true, "schema": { "type": "string", "const": "1.0" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" }, "example": { "jsonrpc": "2.0", "id": 1, "method": "SendMessage", "params": { "message": { "messageId": "client-message-1", "role": "ROLE_USER", "parts": [ { "text": "Did Satoshi ever describe Bitcoin as anonymous?" } ] } } } } } }, "responses": { "200": { "description": "A2A JSON-RPC response" }, "400": { "description": "Malformed JSON or invalid request envelope" } } } } } }