{"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/{domain}?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/{domain}?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. Domains: 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/ai":{"get":{"operationId":"getAiArticles","summary":"Discover and retrieve verified AI intelligence signals","description":"Agent-readable AI intelligence API for AI news, LLM news, machine learning research, model releases, AI infrastructure, robotics. Two modes: (1) FREE with ?since= returns article titles/IDs for discovery, including quality_status so agents can see which IDs are premium-ready. (2) PAID with ?ids= returns up to 20 premium-quality, enriched 20-field records for $0.01 USDC via x402 on Base. Full records include summaries, entities, tags, context, key factors, why-it-matters analysis, sentiment, impact scores, credibility scores, methodology, source basis, and source URLs. If a requested ID is not premium-quality yet, the API returns HTTP 409 before charging. Without payment, ?ids= returns HTTP 402 with payment instructions.","tags":["AI","news intelligence","x402","AI agents"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"x-agent-use-cases":["Monitor fresh AI news signals","Screen free article titles before paying for full structured records","Feed verified source-backed intelligence into autonomous agent workflows","Track credibility-scored events across multiple publishers"],"parameters":[{"name":"since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"ISO 8601 timestamp. Returns articles published after this time. FREE. Each row includes quality_status so you can pre-filter premium-ready IDs."},{"name":"ids","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated UUIDs. Returns premium-quality enriched records only. PAID: $0.01 USDC returns up to 20 records via x402."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"minimum":1,"maximum":100},"description":"Max articles to return."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleListResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}}}}},"/api/v1/semiconductor":{"get":{"operationId":"getSemiconductorArticles","summary":"Discover and retrieve verified Semiconductor intelligence signals","description":"Agent-readable Semiconductor intelligence API for semiconductor news, chip supply chain, GPUs, foundries, fabs, export controls, AI hardware. Two modes: (1) FREE with ?since= returns article titles/IDs for discovery, including quality_status so agents can see which IDs are premium-ready. (2) PAID with ?ids= returns up to 20 premium-quality, enriched 20-field records for $0.01 USDC via x402 on Base. Full records include summaries, entities, tags, context, key factors, why-it-matters analysis, sentiment, impact scores, credibility scores, methodology, source basis, and source URLs. If a requested ID is not premium-quality yet, the API returns HTTP 409 before charging. Without payment, ?ids= returns HTTP 402 with payment instructions.","tags":["Semiconductor","news intelligence","x402","AI agents"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"x-agent-use-cases":["Monitor fresh Semiconductor news signals","Screen free article titles before paying for full structured records","Feed verified source-backed intelligence into autonomous agent workflows","Track credibility-scored events across multiple publishers"],"parameters":[{"name":"since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"ISO 8601 timestamp. Returns articles published after this time. FREE. Each row includes quality_status so you can pre-filter premium-ready IDs."},{"name":"ids","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated UUIDs. Returns premium-quality enriched records only. PAID: $0.01 USDC returns up to 20 records via x402."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"minimum":1,"maximum":100},"description":"Max articles to return."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleListResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}}}}},"/api/v1/macro":{"get":{"operationId":"getMacroArticles","summary":"Discover and retrieve verified Macro intelligence signals","description":"Agent-readable Macro intelligence API for macroeconomic news, central banks, interest rates, inflation, fiscal policy, trade, markets. Two modes: (1) FREE with ?since= returns article titles/IDs for discovery, including quality_status so agents can see which IDs are premium-ready. (2) PAID with ?ids= returns up to 20 premium-quality, enriched 20-field records for $0.01 USDC via x402 on Base. Full records include summaries, entities, tags, context, key factors, why-it-matters analysis, sentiment, impact scores, credibility scores, methodology, source basis, and source URLs. If a requested ID is not premium-quality yet, the API returns HTTP 409 before charging. Without payment, ?ids= returns HTTP 402 with payment instructions.","tags":["Macro","news intelligence","x402","AI agents"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"x-agent-use-cases":["Monitor fresh Macro news signals","Screen free article titles before paying for full structured records","Feed verified source-backed intelligence into autonomous agent workflows","Track credibility-scored events across multiple publishers"],"parameters":[{"name":"since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"ISO 8601 timestamp. Returns articles published after this time. FREE. Each row includes quality_status so you can pre-filter premium-ready IDs."},{"name":"ids","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated UUIDs. Returns premium-quality enriched records only. PAID: $0.01 USDC returns up to 20 records via x402."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"minimum":1,"maximum":100},"description":"Max articles to return."}],"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"}}},"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"}}}}}}