{"uid":"cap_WwJUoWGQU7VULBm_WS_LY","slug":"worlddata402-hacker-news-top-stories-8d992efd","name":"WorldData402 Hacker News Top Stories","description":"Global market, government and reference data for AI agents. Pay-per-call over x402 (USDC on Base mainnet).","url":"https://worlddata402.worlddata402.workers.dev/v1/hn/top?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"number"}}},"responseSchema":{"type":"object"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wAzy5Q03F04c2jcjrHJG0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current top stories from Hacker News, with an optional limit on the number of results returned.","exampleAgentPrompt":"Pull the top 10 stories from Hacker News right now so I can see what the tech community is buzzing about today.","exampleUseCases":[{"title":"Daily tech news digest","prompt":"Grab the top 20 Hacker News stories this morning and summarize what the tech world is talking about today."},{"title":"Trending startup topics monitor","prompt":"Fetch the top 5 Hacker News stories right now — I want to see if anything about AI or startups is trending on the front page."},{"title":"Content curation for newsletter","prompt":"Get me the current top 15 stories from Hacker News so I can pick the best ones to include in my weekly developer newsletter."}],"resultDescription":"Returns a list of top Hacker News stories, including story titles, links, rankings, and associated metadata such as score or author, up to the requested limit.","failureModes":["No limit specified returns a default number of stories which may be more or fewer than expected","Hacker News upstream unavailability may cause empty or error responses","Payment failure via x402/USDC on Base mainnet will block the request","Overly large limit values may hit response size constraints"],"whenToPreferThis":"Choose this endpoint when an agent needs programmatic, pay-per-call access to Hacker News top stories via the x402 micropayment protocol (USDC on Base mainnet), particularly in automated workflows where API key management is undesirable and per-call billing is preferred.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T18:42:35.700Z","isFirstParty":false,"canonicalSlug":"worlddata402-hacker-news-top-stories-8d992efd"}