{"openapi":"3.1.0","info":{"title":"SignalsFeed API","description":"Real-time verified news intelligence API for AI agents. SignalsFeed provides machine-readable AI news, semiconductor supply chain news, and macroeconomic news signals with cross-validation, credibility scoring, source URLs, and structured JSON records. Built for autonomous agents, market intelligence workflows, research agents, and x402 pay-per-request access.","version":"0.1.0","contact":{"name":"SignalsFeed","url":"https://signalsfeed.com"},"x-keywords":["real-time news API","AI news API","LLM news","machine learning research","semiconductor news API","chip supply chain intelligence","GPU news","macroeconomic news API","central bank news","market intelligence","verified news intelligence","credibility scoring","source-backed news","agent-readable JSON","x402 paid API","USDC micropayments"],"x-guidance":"SignalsFeed provides real-time, cross-validated news intelligence for AI agents, research agents, trading agents, market intelligence agents, and autonomous workflows. Step 1: Call GET /api/v1/feed?since={ISO8601_timestamp} to discover new articles (free, no payment). Free-list rows include quality_status so you can identify premium-ready IDs. Step 2: Pick the article IDs you need. Step 3: Call GET /api/v1/feed?ids={id1,id2,...} to get premium-quality full enriched records ($0.01 USDC via x402 on Base returns up to 20 records). If an ID is not premium-quality yet, the API returns 409 without charging. Optional domain filter values: ai, semiconductor, macro. All data is structured JSON. Use ai for artificial intelligence, LLM, machine learning, robotics, and model-release news. Use semiconductor for chip, GPU, foundry, fab, supply-chain, and export-control news. Use macro for central-bank, interest-rate, inflation, fiscal-policy, trade, and market news. Credibility scores are calibrated 0-1. Source links are provided for independent verification."},"servers":[{"url":"https://signalsfeed.com","description":"Production"}],"paths":{"/api/v1/feed":{"get":{"operationId":"getSignalsFeedUnifiedFeed","summary":"Discover and retrieve verified intelligence across all SignalsFeed domains","description":"Unified agent-first SignalsFeed feed. Start here if you do not want to guess a domain upfront. FREE with ?since= returns mixed-domain article IDs and metadata, including domain, tags, and quality_status. Optionally add ?domain=ai, ?domain=macro, or ?domain=semiconductor to narrow discovery. PAID with ?ids= returns up to 20 premium-quality enriched records for $0.01 USDC via x402 on Base, even when the requested IDs span multiple domains. If a requested ID is not premium-quality yet, the API returns HTTP 409 before charging.","tags":["Unified Feed","news intelligence","x402","AI agents"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"x-agent-use-cases":["Start from one SignalsFeed portal without guessing a domain first","Screen mixed-domain signals by tags, domain, and quality_status","Buy premium records across AI, macro, and semiconductor in one request"],"parameters":[{"name":"since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"ISO 8601 timestamp. Returns recent articles across all domains for free discovery. Combine with limit up to 100 to page through inventory."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Opaque pagination cursor returned as next_cursor by the previous feed response. Pass it back unchanged to fetch the next page."},{"name":"ids","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated UUIDs. Returns premium-quality enriched records across any domain mix. PAID: $0.01 USDC returns up to 20 records via x402."},{"name":"domain","in":"query","required":false,"schema":{"type":"string","enum":["ai","semiconductor","macro"]},"description":"Optional domain filter for free discovery."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"minimum":1,"maximum":100},"description":"For free discovery, max rows to return per page (1-100). Follow next_cursor until has_more=false to page through the full feed. When used with ids, the effective paid cap is 20."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleListResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}}}}}},"components":{"schemas":{"Article":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"domain":{"type":"string","enum":["ai","semiconductor","macro"]},"title":{"type":"string"},"summary":{"type":"string"},"context":{"type":"string"},"key_factors":{"type":"array","items":{"type":"string"}},"why_it_matters":{"type":"string"},"source_basis":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"quality_status":{"type":"string","enum":["premium","candidate","awaiting_score","rejected","missing"]},"sentiment":{"type":"string","enum":["positive","negative","neutral"]},"impact_score":{"type":"string","enum":["high","medium","low"]},"credibility_score":{"type":"number","minimum":0,"maximum":1},"methodology":{"type":"string"},"cross_validation_sources":{"type":"integer"},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"publisher":{"type":"string"},"published_at":{"type":"string","format":"date-time"}}}},"related_ids":{"type":"array","items":{"type":"string"}},"language":{"type":"string"},"published_at":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"}}},"ArticleListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"domain":{"type":"string","enum":["ai","semiconductor","macro"]},"title":{"type":"string"},"summary":{"type":"string"},"context":{"type":"string"},"key_factors":{"type":"array","items":{"type":"string"}},"why_it_matters":{"type":"string"},"source_basis":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"quality_status":{"type":"string","enum":["premium","candidate","awaiting_score","rejected","missing"]},"sentiment":{"type":"string","enum":["positive","negative","neutral"]},"impact_score":{"type":"string","enum":["high","medium","low"]},"credibility_score":{"type":"number","minimum":0,"maximum":1},"methodology":{"type":"string"},"cross_validation_sources":{"type":"integer"},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"publisher":{"type":"string"},"published_at":{"type":"string","format":"date-time"}}}},"related_ids":{"type":"array","items":{"type":"string"}},"language":{"type":"string"},"published_at":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"}}}},"count":{"type":"integer"},"has_more":{"type":"boolean"},"limit":{"type":"integer"},"next_cursor":{"type":["string","null"]}}},"PaymentRequired":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string"},"network":{"type":"string"},"asset":{"type":"string"},"amount":{"type":"string"},"maxAmountRequired":{"type":"string"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object"}}}},"resource":{"type":"object"},"extensions":{"type":"object"}}}}}}