{"openapi":"3.1.0","info":{"title":"Keelbase Signal API","version":"1.3.0","description":"OpenAPI 3.1 specification for the live Keelbase Signal free discovery routes and x402-paid data products.","termsOfService":"https://signal.keelbase.io/terms","contact":{"name":"Keelbase","url":"https://signal.keelbase.io"}},"jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","servers":[{"url":"https://signal.keelbase.io","description":"Keelbase Signal production target"}],"tags":[{"name":"Discovery","description":"Service discovery, capabilities, and API description."},{"name":"Catalog","description":"Live free and paid products."},{"name":"Preview","description":"Bounded public previews of canonical Signal publications."},{"name":"Operations","description":"Service-health information."},{"name":"Paid products","description":"x402-protected products using exact USDC settlement on Base mainnet."}],"paths":{"/api/v1/daily/latest":{"get":{"operationId":"getLatestDailySignal","summary":"Retrieve the complete latest daily Signal product","description":"Returns the complete bounded record set and original Keelbase Markdown synthesis for the latest canonical daily publication. Fixture publications remain explicitly identified.","tags":["Paid products"],"x-x402":{"version":2,"scheme":"exact","amount":"0.03","asset":"USDC","network":"Base mainnet","networkId":"eip155:8453","facilitator":"Coinbase CDP"},"responses":{"200":{"description":"Payment verified and settled; protected product returned.","headers":{"Cache-Control":{"description":"Protected responses are private and are not stored in shared caches.","schema":{"type":"string","const":"private, no-store, max-age=0"}},"X-Content-Type-Options":{"description":"MIME-sniffing protection.","schema":{"type":"string","const":"nosniff"}},"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 v2 settlement response. Present after successful settlement.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LatestDailyResponse"}}}},"402":{"description":"x402 payment is required, invalid, rejected, replayed, or could not be settled.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","required":true,"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"No canonical daily publication is available.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/events":{"get":{"operationId":"getSignalEvents","summary":"Retrieve filtered Signal event records","description":"Returns deterministic, bounded structured Signal records. Unknown, duplicated, empty, malformed, or unsupported query parameters are rejected.","tags":["Paid products"],"x-x402":{"version":2,"scheme":"exact","amount":"0.03","asset":"USDC","network":"Base mainnet","networkId":"eip155:8453","facilitator":"Coinbase CDP"},"parameters":[{"name":"report_date","in":"query","required":false,"description":"Return records from this canonical report date.","schema":{"type":"string","format":"date"}},{"name":"event_date_from","in":"query","required":false,"description":"Inclusive earliest event date.","schema":{"type":"string","format":"date"}},{"name":"event_date_to","in":"query","required":false,"description":"Inclusive latest event date.","schema":{"type":"string","format":"date"}},{"name":"topic","in":"query","required":false,"description":"Match a classification topic.","schema":{"type":"string","minLength":1,"maxLength":160}},{"name":"entity","in":"query","required":false,"description":"Match a classified entity.","schema":{"type":"string","minLength":1,"maxLength":160}},{"name":"jurisdiction","in":"query","required":false,"description":"Match a classified jurisdiction.","schema":{"type":"string","minLength":1,"maxLength":160}},{"name":"source_status","in":"query","required":false,"description":"Match the controlled source-status classification.","schema":{"type":"string","enum":["confirmed","allegation","proposal","commentary","unresolved"]}},{"name":"impact_level","in":"query","required":false,"description":"Match the Keelbase impact assessment.","schema":{"type":"string","enum":["high","medium","low"]}},{"name":"confidence","in":"query","required":false,"description":"Match the record confidence assessment.","schema":{"type":"string","enum":["high","medium","low"]}},{"name":"limit","in":"query","required":false,"description":"Maximum returned records. Defaults to 50 and cannot exceed 100.","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"Payment verified and settled; protected product returned.","headers":{"Cache-Control":{"description":"Protected responses are private and are not stored in shared caches.","schema":{"type":"string","const":"private, no-store, max-age=0"}},"X-Content-Type-Options":{"description":"MIME-sniffing protection.","schema":{"type":"string","const":"nosniff"}},"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 v2 settlement response. Present after successful settlement.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventsResponse"}}}},"400":{"description":"The supplied event filters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"x402 payment is required, invalid, rejected, replayed, or could not be settled.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","required":true,"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/v1/weekly/latest":{"get":{"operationId":"getLatestWeeklySignal","summary":"Retrieve the latest deterministic weekly synthesis","description":"Returns a bounded seven-day synthesis derived from canonical Signal records, including counts, clusters, timeline entries, and affected-component recommendations. It does not claim an independent weekly publication source.","tags":["Paid products"],"x-x402":{"version":2,"scheme":"exact","amount":"0.15","asset":"USDC","network":"Base mainnet","networkId":"eip155:8453","facilitator":"Coinbase CDP"},"responses":{"200":{"description":"Payment verified and settled; protected product returned.","headers":{"Cache-Control":{"description":"Protected responses are private and are not stored in shared caches.","schema":{"type":"string","const":"private, no-store, max-age=0"}},"X-Content-Type-Options":{"description":"MIME-sniffing protection.","schema":{"type":"string","const":"nosniff"}},"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 v2 settlement response. Present after successful settlement.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LatestWeeklyResponse"}}}},"402":{"description":"x402 payment is required, invalid, rejected, replayed, or could not be settled.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","required":true,"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"No canonical weekly Signal window is available.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/llms.txt":{"get":{"operationId":"getLlmsDiscoveryDocument","summary":"Retrieve the LLM and agent discovery document","description":"Returns plain-text guidance covering available endpoints, fixture status, attribution, source rights, corrections, limitations, and privacy boundaries.","tags":["Discovery"],"responses":{"200":{"description":"Plain-text discovery document.","headers":{"Cache-Control":{"description":"Response caching policy.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"MIME-sniffing protection.","schema":{"type":"string","const":"nosniff"}}},"content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/agent/capabilities":{"get":{"operationId":"getAgentCapabilities","summary":"Retrieve machine-readable agent capabilities","description":"Returns supported and unsupported capabilities, coverage, response semantics, access status, and public-data boundaries.","tags":["Discovery"],"responses":{"200":{"description":"Agent capabilities response.","headers":{"Cache-Control":{"description":"Response caching policy.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"MIME-sniffing protection.","schema":{"type":"string","const":"nosniff"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentCapabilitiesResponse"}}}}}}},"/openapi.json":{"get":{"operationId":"getOpenApiDocument","summary":"Retrieve the OpenAPI specification","description":"Returns this OpenAPI 3.1 document for live free endpoints.","tags":["Discovery"],"responses":{"200":{"description":"OpenAPI 3.1 document.","headers":{"Cache-Control":{"description":"Response caching policy.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"MIME-sniffing protection.","schema":{"type":"string","const":"nosniff"}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/catalog":{"get":{"operationId":"getSignalCatalog","summary":"Retrieve the public Signal product catalog","description":"Returns live free and paid products with access, pricing, status, and documentation metadata.","tags":["Catalog"],"responses":{"200":{"description":"Keelbase Signal catalog.","headers":{"Cache-Control":{"description":"Response caching policy.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"MIME-sniffing protection.","schema":{"type":"string","const":"nosniff"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogResponse"}}}}}}},"/api/v1/preview/daily/latest":{"get":{"operationId":"getLatestDailyPreview","summary":"Retrieve the bounded latest daily preview","description":"Returns publication metadata and at most two normalized Signal records from the latest canonical repository publication. Fixture publications remain explicitly identified.","tags":["Preview"],"responses":{"200":{"description":"Bounded latest daily preview.","headers":{"Cache-Control":{"description":"Response caching policy.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"MIME-sniffing protection.","schema":{"type":"string","const":"nosniff"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DailyPreviewResponse"}}}},"404":{"description":"No canonical daily publication is available.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/health":{"get":{"operationId":"getSignalHealth","summary":"Retrieve current service health","description":"Returns current service status, API version, request-time timestamp, safe build metadata, and discovery links.","tags":["Operations"],"responses":{"200":{"description":"Current service health.","headers":{"Cache-Control":{"description":"Response caching policy.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"MIME-sniffing protection.","schema":{"type":"string","const":"nosniff"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}}},"components":{"schemas":{"PaidPublicationMetadata":{"type":"object","additionalProperties":false,"required":["title","description","slug","report_date","published_at","updated_at","status","is_fixture","topics","correction_of","body_markdown"],"properties":{"title":{"type":"string"},"description":{"type":"string"},"slug":{"type":"string"},"report_date":{"type":"string","format":"date"},"published_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["draft","published","corrected","superseded"]},"is_fixture":{"type":"boolean"},"topics":{"type":"array","items":{"type":"string","enum":["agent_governance_authorization","platform_framework_governance","agentic_commerce_payments","ai_sovereignty_policy_regulation","agent_infrastructure_security"]}},"correction_of":{"type":["string","null"]},"body_markdown":{"type":"string"}}},"LatestDailyResponse":{"type":"object","additionalProperties":false,"required":["service","api_version","product_version","data_status","publication","completeness","warnings","records","links"],"properties":{"service":{"type":"string","const":"Keelbase Signal"},"api_version":{"type":"string"},"product_version":{"type":"string"},"data_status":{"type":"string","enum":["fixture","publication"]},"publication":{"$ref":"#/components/schemas/PaidPublicationMetadata"},"completeness":{"type":"object","additionalProperties":false,"required":["bounded","maximum_record_count","returned_record_count","complete"],"properties":{"bounded":{"type":"boolean","const":true},"maximum_record_count":{"type":"integer"},"returned_record_count":{"type":"integer"},"complete":{"type":"boolean","const":true}}},"warnings":{"type":"array","items":{"type":"string"}},"records":{"type":"array","items":{"$ref":"#/components/schemas/DailyPreviewRecord"}},"links":{"type":"object","additionalProperties":{"type":"string","format":"uri"}}}},"EventsResponse":{"type":"object","additionalProperties":false,"required":["service","api_version","product_version","data_status","filters","page","warnings","records","links"],"properties":{"service":{"type":"string","const":"Keelbase Signal"},"api_version":{"type":"string"},"product_version":{"type":"string"},"data_status":{"type":"string","enum":["fixture","publication","mixed"]},"filters":{"type":"object"},"page":{"type":"object","additionalProperties":false,"required":["bounded","limit","available_record_count","returned_record_count","truncated"],"properties":{"bounded":{"type":"boolean","const":true},"limit":{"type":"integer","minimum":1,"maximum":100},"available_record_count":{"type":"integer"},"returned_record_count":{"type":"integer"},"truncated":{"type":"boolean"}}},"warnings":{"type":"array","items":{"type":"string"}},"records":{"type":"array","items":{"$ref":"#/components/schemas/DailyPreviewRecord"}},"links":{"type":"object","additionalProperties":{"type":"string","format":"uri"}}}},"LatestWeeklyResponse":{"type":"object","additionalProperties":false,"required":["service","api_version","product_version","data_status","derivation","window","synthesis","clusters","timeline","recommendations","warnings","links"],"properties":{"service":{"type":"string","const":"Keelbase Signal"},"api_version":{"type":"string"},"product_version":{"type":"string"},"data_status":{"type":"string","enum":["fixture","publication","mixed"]},"derivation":{"type":"object","additionalProperties":false,"required":["method","independent_weekly_source"],"properties":{"method":{"type":"string","const":"deterministic_repository_window"},"independent_weekly_source":{"type":"boolean","const":false}}},"window":{"type":"object"},"synthesis":{"type":"object"},"clusters":{"type":"array","items":{"type":"object"}},"timeline":{"type":"array","items":{"type":"object"}},"recommendations":{"type":"array","items":{"type":"object"}},"warnings":{"type":"array","items":{"type":"string"}},"links":{"type":"object","additionalProperties":{"type":"string","format":"uri"}}}},"EndpointCatalogEntry":{"type":"object","additionalProperties":false,"required":["method","path","product_name","description","response_format","implementation_status","api_version","pricing","authentication","payment_requirement","canonical_documentation_url"],"properties":{"method":{"type":"string","const":"GET"},"path":{"type":"string"},"product_name":{"type":"string"},"description":{"type":"string"},"response_format":{"type":"string","enum":["application/json","text/plain"]},"implementation_status":{"type":"string","enum":["deployment_ready","live"]},"api_version":{"type":"string"},"pricing":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ApiPrice"}]},"authentication":{"type":"string","enum":["none","x402"]},"payment_requirement":{"type":"string","enum":["none","required"]},"canonical_documentation_url":{"type":"string","format":"uri"}}},"ApiPrice":{"type":"object","additionalProperties":false,"required":["amount","asset","network"],"properties":{"amount":{"type":"string"},"asset":{"type":"string","const":"USDC"},"network":{"type":"string","const":"Base"}}},"CatalogResponse":{"type":"object","additionalProperties":false,"required":["service","api_version","catalog_version","free_endpoints","paid_endpoints","limitations","links"],"properties":{"service":{"type":"string","const":"Keelbase Signal"},"api_version":{"type":"string"},"catalog_version":{"type":"string"},"free_endpoints":{"type":"array","items":{"$ref":"#/components/schemas/EndpointCatalogEntry"}},"paid_endpoints":{"type":"array","items":{"$ref":"#/components/schemas/EndpointCatalogEntry"}},"limitations":{"type":"array","items":{"type":"string"}},"links":{"type":"object","additionalProperties":{"type":"string","format":"uri"}}}},"AgentCapabilitiesResponse":{"type":"object","required":["service","api_version","capabilities_version","status","purpose","supported_capabilities","unsupported_capabilities","coverage","response_semantics","access","data_boundaries","links"],"properties":{"service":{"type":"string","const":"Keelbase Signal"},"api_version":{"type":"string"},"capabilities_version":{"type":"string"},"status":{"type":"string","enum":["deployment_ready","live"]},"purpose":{"type":"string"},"supported_capabilities":{"type":"array","items":{"type":"string"}},"unsupported_capabilities":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object"},"response_semantics":{"type":"object"},"access":{"type":"object"},"data_boundaries":{"type":"array","items":{"type":"string"}},"links":{"type":"object"}}},"DailyPreviewRecord":{"type":"object","additionalProperties":false,"required":["record_id","schema_version","report_date","event_date","published_at","verified_at","headline","source","classification","factual_reporting","keelbase_analysis","assessment","correction"],"properties":{"record_id":{"type":"string","pattern":"^KB-SIGNAL-[0-9]{8}-[0-9]{3}$"},"schema_version":{"type":"string"},"report_date":{"type":"string","format":"date"},"event_date":{"type":"string","format":"date"},"published_at":{"type":"string","format":"date-time"},"verified_at":{"type":"string","format":"date-time"},"headline":{"type":"string"},"source":{"type":"object","required":["name","url","type","status"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"type":{"type":"string"},"status":{"type":"string","enum":["confirmed","announced","allegation","proposal","commentary","unresolved"]}}},"classification":{"type":"object","additionalProperties":false,"required":["topics","entities","jurisdictions"],"properties":{"topics":{"type":"array","items":{"type":"string","enum":["agent_governance_authorization","platform_framework_governance","agentic_commerce_payments","ai_sovereignty_policy_regulation","agent_infrastructure_security"]}},"entities":{"type":"array","items":{"type":"string"}},"jurisdictions":{"type":"array","items":{"type":"string"}}}},"factual_reporting":{"type":"object","required":["summary"],"properties":{"summary":{"type":"string"}}},"keelbase_analysis":{"type":"object","additionalProperties":false,"required":["domain_impact","editorial_analysis","affected_systems"],"properties":{"domain_impact":{"type":"string"},"editorial_analysis":{"type":"string"},"affected_systems":{"type":"array","items":{"type":"string"}}}},"assessment":{"type":"object"},"correction":{"type":"object"}}},"DailyPreviewResponse":{"type":"object","additionalProperties":false,"required":["service","api_version","preview_version","data_status","publication","preview","warnings","records","links"],"properties":{"service":{"type":"string","const":"Keelbase Signal"},"api_version":{"type":"string"},"preview_version":{"type":"string"},"data_status":{"type":"string","enum":["fixture","publication"]},"publication":{"type":"object"},"preview":{"type":"object","required":["bounded","record_limit","available_record_count","returned_record_count","truncated"],"properties":{"bounded":{"type":"boolean","const":true},"record_limit":{"type":"integer","const":2},"available_record_count":{"type":"integer","minimum":0},"returned_record_count":{"type":"integer","minimum":0,"maximum":2},"truncated":{"type":"boolean"}}},"warnings":{"type":"array","items":{"type":"string"}},"records":{"type":"array","maxItems":2,"items":{"$ref":"#/components/schemas/DailyPreviewRecord"}},"links":{"type":"object"}}},"HealthResponse":{"type":"object","additionalProperties":false,"required":["service","status","api_version","timestamp","build","links"],"properties":{"service":{"type":"string","const":"Keelbase Signal"},"status":{"type":"string","const":"ok"},"api_version":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"build":{"type":"object","additionalProperties":false,"required":["product_version","phase","content_source","private_environment_exposed"],"properties":{"product_version":{"type":"string"},"phase":{"type":"string","const":"technical_beta"},"content_source":{"type":"string","const":"repository_files"},"private_environment_exposed":{"type":"boolean","const":false}}},"links":{"type":"object"}}},"ErrorResponse":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}