{"openapi":"3.1.0","info":{"title":"DataForAgents","description":"Pay-per-request datasets for autonomous agents via x402 (USDC). Structured JSON APIs; no API keys — pay on the wire.","version":"0.1.0","contact":{"name":"DataForAgents","url":"https://dataforagents.net"}},"servers":[{"url":"https://dataforagents.net"}],"x-discovery":{"ownershipProofs":["0x5d4ECba4458C49b6F92Fd5384686f0cAf0C3080B"],"wellKnown":["https://dataforagents.net/.well-known/x402","https://dataforagents.net/.well-known/x402.json"],"llmsTxt":"https://dataforagents.net/llms.txt"},"tags":[{"name":"free","description":"Unauthenticated / unpaid probes"},{"name":"data","description":"Paid datasets"},{"name":"steam","description":"Steam catalog intelligence"},{"name":"fifa","description":"FIFA World Cup 2026 players"},{"name":"news","description":"News pulse / heartbeat"}],"paths":{"/health":{"get":{"operationId":"health","summary":"Liveness + dataset counts","tags":["free"],"responses":{"200":{"description":"Service is healthy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/news/pulse/alpha/quote":{"get":{"operationId":"newsAlphaQuote","summary":"Free Alpha Pulse quote (price + harvest wait estimate)","tags":["free","news"],"responses":{"200":{"description":"Current block quote","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/news/pulse/shift/quote":{"get":{"operationId":"newsShiftQuote","summary":"Free Shift Pulse quote (price + harvest wait estimate)","tags":["free","news"],"responses":{"200":{"description":"Current block quote","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/steam/search":{"get":{"operationId":"v1_steam_search","summary":"DataForAgents — Steam catalog search for agents (name, genre, price filters)","tags":["data","steam","games","search"],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","description":"Free-text game name query"}},{"name":"genre","in":"query","required":false,"schema":{"type":"string","description":"Genre filter (exact/partial match)"}},{"name":"price_max","in":"query","required":false,"schema":{"type":"string","description":"Max current price in USD (number as string query param)"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","description":"Max results to return (default 20)"}}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"security":[{"x402":[]}],"responses":{"200":{"description":"Paid JSON payload","content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"status":"success","results_count":1,"data":[{"appid":105600,"name":"Terraria","developer":"Re-Logic","current_price_usd":9.99,"is_free":false,"genres":["Action","Adventure","Indie","RPG"],"review_score_pct":97,"total_reviews":900000}]}}}},"402":{"description":"Payment required (x402). See Payment-Required header.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/steam/insights":{"get":{"operationId":"v1_steam_insights","summary":"DataForAgents — Steam deep insights for agents (pricing, hardware requirements, metadata)","tags":["data","steam","games","insights"],"parameters":[{"name":"appid","in":"query","required":true,"schema":{"type":"string","description":"Steam application ID (positive integer as string)"}}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"security":[{"x402":[]}],"responses":{"200":{"description":"Paid JSON payload","content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"status":"success","data":{"appid":105600,"name":"Terraria","type":"game","developer":"Re-Logic","publisher":"Re-Logic","is_free":false,"current_price_usd":9.99,"initial_price_usd":9.99,"discount_pct":0,"genres":["Action","Adventure","Indie","RPG"],"categories":["Single-player","Multi-player"],"release_date":"2011-05-16","metacritic_score":83,"review_score_pct":97,"total_reviews":900000,"short_description":"Dig, fight, explore, build!","platforms":{"windows":true,"mac":true,"linux":true},"pc_requirements":{"os_min":"Windows XP","processor_min":"2.0 GHz","memory_min":"2.5 GB RAM","graphics_min":"128MB VRAM","os_rec":null,"processor_rec":null,"memory_rec":null,"graphics_rec":null},"headers":{"header_image":"https://cdn.akamai.steamstatic.com/steam/apps/105600/header.jpg"}}}}}},"402":{"description":"Payment required (x402). See Payment-Required header.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/fifa/search":{"get":{"operationId":"v1_fifa_search","summary":"DataForAgents — FIFA World Cup 2026 player search (name, team, position, nationality)","tags":["data","fifa","sports","search"],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","description":"Player name query"}},{"name":"team","in":"query","required":false,"schema":{"type":"string","description":"Team / squad filter"}},{"name":"position","in":"query","required":false,"schema":{"type":"string","description":"Position filter (e.g. FW, MF, DF, GK)"}},{"name":"nationality","in":"query","required":false,"schema":{"type":"string","description":"Nationality filter"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","description":"Max results (default 20)"}}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"security":[{"x402":[]}],"responses":{"200":{"description":"Paid JSON payload","content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"status":"success","results_count":1,"data":[{"player_id":"example-id","player_name":"Lionel Messi","team":"Argentina","position":"FW","nationality":"Argentina"}]}}}},"402":{"description":"Payment required (x402). See Payment-Required header.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/fifa/player":{"get":{"operationId":"v1_fifa_player","summary":"DataForAgents — FIFA World Cup 2026 player performance detail (goals, xG, defensive metrics)","tags":["data","fifa","sports","player"],"parameters":[{"name":"player_id","in":"query","required":true,"schema":{"type":"string","description":"Stable player id from /v1/fifa/search results"}}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"security":[{"x402":[]}],"responses":{"200":{"description":"Paid JSON payload","content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"status":"success","data":{"player_id":"example-id","player_name":"Lionel Messi","team":"Argentina","position":"FW","nationality":"Argentina","goals":0,"assists":0}}}}},"402":{"description":"Payment required (x402). See Payment-Required header.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/news/pulse/alpha":{"get":{"operationId":"v1_news_pulse_alpha","summary":"DataForAgents — Alpha Pulse (15m). Dynamic price: ~80% off when you trigger harvest for an empty calendar block; full price on cache hits.","tags":["data","news","pulse","alpha"],"parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string","description":"Optional focus category: finance_macro | geopolitics | tech_ai | sports","enum":["finance_macro","geopolitics","tech_ai","sports"]}}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"dynamic","currency":"USD","min":"0.008","max":"0.04"}},"security":[{"x402":[]}],"responses":{"200":{"description":"Paid JSON payload","content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"status":"success","ready":true,"harvested":false,"pricing_tier":"cache","interval":"15m","window_start":"2026-07-15T22:00:00.000Z","window_end":"2026-07-15T22:15:00.000Z","pulse_id":"example-pulse","events_count":24,"category":"tech_ai","events":[]}}}},"402":{"description":"Payment required (x402). See Payment-Required header.","x-payment-info":{"protocols":["x402"],"price":{"mode":"dynamic","currency":"USD","min":"0.008","max":"0.04"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/news/pulse/shift":{"get":{"operationId":"v1_news_pulse_shift","summary":"DataForAgents — Shift Pulse (1h). Dynamic price: ~80% off when you trigger harvest for an empty calendar block; full price on cache hits.","tags":["data","news","pulse","shift"],"parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string","description":"Optional focus category: finance_macro | geopolitics | tech_ai | sports","enum":["finance_macro","geopolitics","tech_ai","sports"]}}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"dynamic","currency":"USD","min":"0.004","max":"0.02"}},"security":[{"x402":[]}],"responses":{"200":{"description":"Paid JSON payload","content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"status":"success","ready":true,"harvested":false,"pricing_tier":"cache","interval":"1h","window_start":"2026-07-15T22:00:00.000Z","window_end":"2026-07-15T22:15:00.000Z","pulse_id":"example-pulse","events_count":24,"category":"tech_ai","events":[]}}}},"402":{"description":"Payment required (x402). See Payment-Required header.","x-payment-info":{"protocols":["x402"],"price":{"mode":"dynamic","currency":"USD","min":"0.004","max":"0.02"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}}},"components":{"securitySchemes":{"x402":{"type":"http","scheme":"x402","description":"HTTP 402 Payment Required. Client pays USDC per request via x402 (PAYMENT-SIGNATURE / settle flow)."}}}}