{"uid":"cap_GyOA2oIHT5raXEHNT94Qy","slug":"agentindex-x402-hacker-news-top-stories-feed-25323f78","name":"AgentIndex x402 Hacker News Top Stories Feed","description":"Top Hacker News headlines right now - title, URL, score, comments. Fresh links for agents that need current tech/startup signal. Try GET /news/sample.","url":"https://x402.agentindex.world/news?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"limit":{"type":"integer","maximum":25,"minimum":1,"description":"How many top stories to return (1-25, default 10)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["source","count","stories"],"properties":{"count":{"type":"integer"},"source":{"type":"string"},"stories":{"type":"array","items":{"type":"object","properties":{"by":{"type":"string"},"id":{"type":"integer"},"url":{"type":"string"},"time":{"type":"integer"},"score":{"type":"integer"},"title":{"type":"string"},"comments":{"type":"integer"}}}},"x402_receipt":{"type":"object"}}}}}}},"responseSchema":{"type":"json","example":{"count":1,"source":"hacker-news","stories":[{"by":"pg","id":49765348,"url":"https://example.com/story","time":1726750000,"score":312,"title":"Example headline about AI agents","comments":88}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jXdVC4LsMqvD_BmhUv4xz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the top trending stories from Hacker News, returning titles, scores, authors, and URLs for up to 25 items per call","exampleAgentPrompt":"Pull the top 15 Hacker News stories right now and show me the titles, scores, and links so I can see what the tech community is buzzing about today.","exampleUseCases":[{"title":"Morning tech briefing digest","prompt":"Give me the top 10 Hacker News stories this morning — I want the titles and links so I can decide what to read with my coffee."},{"title":"Trending AI news roundup","prompt":"Fetch the top 25 stories from Hacker News right now so I can scan for anything related to AI or machine learning that's blowing up today."},{"title":"Startup funding story monitor","prompt":"Grab the top 5 Hacker News stories and summarize what topics are getting the most traction in the tech community today."}],"resultDescription":"Returns a JSON object with a source field ('hacker-news'), a count of stories returned, and an array of story objects each containing: story ID, title, URL, author username, Unix timestamp, upvote score, and comment count. Also includes an x402 payment receipt object confirming the microtransaction.","failureModes":["Payment not provided or insufficient USDC balance — returns 402 Payment Required","Invalid limit parameter (outside 1-25 range) — returns 400 Bad Request","Hacker News API upstream unavailable — may return 503 or degraded response","limit parameter omitted defaults to 10 stories — not a failure but an implicit default","Network timeout from upstream HN API causing delayed or empty response"],"whenToPreferThis":"Choose this endpoint when your agent needs real-time Hacker News front-page data without managing API keys or rate limits — ideal for tech news digests, trend monitoring, or surfacing developer community sentiment. Prefer this over scraping HN directly when you need a clean, pay-per-call interface that handles upstream fetching for you. Best suited for agents that need occasional or event-driven HN snapshots rather than continuous stream monitoring.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T08:56:52.327Z","isFirstParty":false,"canonicalSlug":"agentindex-x402-hacker-news-top-stories-feed-25323f78"}