{"openapi":"3.0.3","info":{"title":"Social signals from open networks (Agent Data API)","description":"Counts and spikes collated from open social networks that no single API merges: hashtags and shared links from the Bluesky firehose, Nostr relays and twelve Mastodon instances; ticker and crypto mentions against a 30-day baseline with lexicon tone; Hacker News, Lobsters and Lemmy front pages in one list; fediverse size from FediDB; GitHub repos gaining stars. Aggregates only: no post text, handles or user profiles. X, Reddit, Threads, TikTok and YouTube are not sources.","version":"2026.11.09"},"paths":{"/api/v1/trends":{"get":{"tags":["Social signals from open networks"],"summary":"Trending hashtags across open networks","description":"Hashtags ranked by mentions times spike (each tag against its own 7-day hourly baseline, capped at 20x; a tag with no baseline yet counts as 5x) on Bluesky and Nostr in the window, plus Mastodon's merged trending tags (today's uses prorated to the window for ranking). `network` limits the ranking to one network. Also returns the topics on Bluesky's own trends list. Refreshes every 5 minutes.","operationId":"social_trending_topics","security":[{"ApiKeyAuth":[]},{}],"parameters":[{"name":"network","in":"query","required":false,"schema":{"type":"string","description":"all, bluesky, mastodon or nostr","example":"all","default":"all","title":"Network"},"description":"all, bluesky, mastodon or nostr"},{"name":"window","in":"query","required":false,"schema":{"type":"string","description":"1h, 6h or 24h","example":"1h","default":"1h","title":"Window"},"description":"1h, 6h or 24h"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required (x402). Body lists accepts[] with USDC amount, network and payTo."}},"x-price-usdc":"0.005","x-price":{"price_micro":5000,"asset":"USDC","network":"eip155:8453"},"x-payment":"x402","x-payment-route-id":"social_trends","x-cadence":"Refreshes every 5 minutes."}},"/api/v1/trends/{tag}":{"get":{"tags":["Social signals from open networks"],"summary":"One hashtag across networks","description":"Mentions of one hashtag per network in the window, the count its baseline predicts, spike in basis points (10000 is normal), trend, first seen, the last 24 hours by hour, Mastodon uses today per instance, and the ticker or crypto symbol it names. Refreshes every 5 minutes.","operationId":"social_topic_trend","security":[{"ApiKeyAuth":[]},{}],"parameters":[{"name":"tag","in":"path","required":true,"schema":{"type":"string","title":"Tag"},"example":"bitcoin"},{"name":"window","in":"query","required":false,"schema":{"type":"string","example":"1h","default":"1h","title":"Window"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required (x402). Body lists accepts[] with USDC amount, network and payTo."}},"x-price-usdc":"0.005","x-price":{"price_micro":5000,"asset":"USDC","network":"eip155:8453"},"x-payment":"x402","x-payment-route-id":"social_trend","x-cadence":"Refreshes every 5 minutes."}},"/api/v1/links":{"get":{"tags":["Social signals from open networks"],"summary":"Most-shared links across networks","description":"URLs ranked by shares on Bluesky and Nostr in the window (canonical form: no tracking parameters), Mastodon's merged trending links, and Hacker News, Lobsters and Lemmy front-page points for the same URL. Titles are the publisher's link-card or page title. Filter by domain. Refreshes every 5 minutes.","operationId":"social_trending_links","security":[{"ApiKeyAuth":[]},{}],"parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","description":"1h, 6h or 24h","example":"6h","default":"6h","title":"Window"},"description":"1h, 6h or 24h"},{"name":"domain","in":"query","required":false,"schema":{"type":"string","nullable":true,"title":"Domain","examples":["github.com"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required (x402). Body lists accepts[] with USDC amount, network and payTo."}},"x-price-usdc":"0.01","x-price":{"price_micro":10000,"asset":"USDC","network":"eip155:8453"},"x-payment":"x402","x-payment-route-id":"social_links","x-cadence":"Refreshes every 5 minutes."}},"/api/v1/mentions/top":{"get":{"tags":["Social signals from open networks"],"summary":"Stocks and crypto by social attention","description":"Tracked tickers and crypto assets ranked by social attention in the window: mentions on Bluesky and Nostr (cashtags, unambiguous names) against each symbol's 30-day hourly baseline, lexicon tone, Mastodon tag uses and front-page discussions naming the symbol. Refreshes every 5 minutes.","operationId":"social_top_mentions","security":[{"ApiKeyAuth":[]},{}],"parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","description":"all, crypto or stock","example":"crypto","default":"all","title":"Type"},"description":"all, crypto or stock"},{"name":"window","in":"query","required":false,"schema":{"type":"string","example":"1h","default":"1h","title":"Window"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required (x402). Body lists accepts[] with USDC amount, network and payTo."}},"x-price-usdc":"0.01","x-price":{"price_micro":10000,"asset":"USDC","network":"eip155:8453"},"x-payment":"x402","x-payment-route-id":"social_mentions_top","x-cadence":"Refreshes every 5 minutes."}},"/api/v1/mentions/{symbol}":{"get":{"tags":["Social signals from open networks"],"summary":"Social attention for a ticker or coin","description":"Mentions of one tracked ticker or crypto symbol per network in the window against its 30-day baseline, spike, trend, lexicon tone in basis points, Mastodon tag uses today and the front-page discussions naming it. The symbol keys match the newssignals, stockmarket and cryptodata feeds. Refreshes every 5 minutes.","operationId":"social_symbol_mentions","security":[{"ApiKeyAuth":[]},{}],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string","title":"Symbol"},"example":"BTC"},{"name":"window","in":"query","required":false,"schema":{"type":"string","example":"1h","default":"1h","title":"Window"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required (x402). Body lists accepts[] with USDC amount, network and payTo."}},"x-price-usdc":"0.01","x-price":{"price_micro":10000,"asset":"USDC","network":"eip155:8453"},"x-payment":"x402","x-payment-route-id":"social_mentions","x-cadence":"Refreshes every 5 minutes."}},"/api/v1/discussions/hot":{"get":{"tags":["Social signals from open networks"],"summary":"Hot discussions on Hacker News, Lobsters and Lemmy","description":"Stories on the Hacker News front page (top 60), Lobsters hottest and Lemmy hot (seven instances) merged into one list, ranked by points per hour relative to the median of their own source. Titles, links, discussion URLs, scores and comment counts only. Refreshes every 5 minutes.","operationId":"hot_discussions","security":[{"ApiKeyAuth":[]},{}],"parameters":[{"name":"source","in":"query","required":false,"schema":{"type":"string","description":"all, hn, lobsters or lemmy","example":"all","default":"all","title":"Source"},"description":"all, hn, lobsters or lemmy"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":30,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required (x402). Body lists accepts[] with USDC amount, network and payTo."}},"x-price-usdc":"0.005","x-price":{"price_micro":5000,"asset":"USDC","network":"eip155:8453"},"x-payment":"x402","x-payment-route-id":"social_discussions","x-cadence":"Refreshes every 5 minutes."}},"/api/v1/dev/repos/trending":{"get":{"tags":["Social signals from open networks"],"summary":"GitHub repos gaining stars","description":"Repositories with the most new stars in the window, from hourly stargazer snapshots: stars now, stars gained, forks gained, growth in basis points, language, topics and front-page discussions linking the repo. Repos are discovered from GH Archive stars, GitHub search and links shared on the networks. Refreshes every 60 minutes.","operationId":"trending_github_repos","security":[{"ApiKeyAuth":[]},{}],"parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","description":"24h or 7d","example":"24h","default":"24h","title":"Window"},"description":"24h or 7d"},{"name":"language","in":"query","required":false,"schema":{"type":"string","nullable":true,"title":"Language","examples":["Rust"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required (x402). Body lists accepts[] with USDC amount, network and payTo."}},"x-price-usdc":"0.005","x-price":{"price_micro":5000,"asset":"USDC","network":"eip155:8453"},"x-payment":"x402","x-payment-route-id":"social_repos","x-cadence":"Refreshes every 60 minutes."}},"/api/v1/networks":{"get":{"tags":["Social signals from open networks"],"summary":"Activity per network","description":"Posts per hour and per day on Bluesky and Nostr with the share of posts carrying tags, links or tracked symbols, and the connection state; fediverse instances, users and monthly active users by software (FediDB, CC BY 4.0); Hacker News items per hour; front pages tracked. Refreshes every 60 minutes.","operationId":"social_network_stats","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required (x402). Body lists accepts[] with USDC amount, network and payTo."}},"security":[{"ApiKeyAuth":[]},{}],"x-price-usdc":"0.002","x-price":{"price_micro":2000,"asset":"USDC","network":"eip155:8453"},"x-payment":"x402","x-payment-route-id":"social_networks","x-cadence":"Refreshes every 60 minutes."}},"/api/v1/history/{kind}/{key}":{"get":{"tags":["Social signals from open networks"],"summary":"Stored history (Pro)","description":"Hourly or daily history, newest first: a hashtag's mentions (Bluesky and Nostr), a symbol's mentions and tone, or a GitHub repo's stars and forks. Point in time: values are stored as recorded, never recomputed. Refreshes every 60 minutes.","operationId":"social_history","security":[{"ApiKeyAuth":[]},{}],"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string","title":"Kind"},"example":"symbol"},{"name":"key","in":"path","required":true,"schema":{"type":"string","title":"Key"},"example":"BTC"},{"name":"resolution","in":"query","required":false,"schema":{"type":"string","description":"hour or day","example":"day","default":"day","title":"Resolution"},"description":"hour or day"},{"name":"network","in":"query","required":false,"schema":{"type":"string","nullable":true,"title":"Network","description":"bluesky or nostr (tags and symbols)","examples":["bluesky"]},"description":"bluesky or nostr (tags and symbols)"},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date-time","nullable":true,"title":"From","examples":["2026-11-01T00:00:00"]}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date-time","nullable":true,"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required (x402). Body lists accepts[] with USDC amount, network and payTo."}},"x-price-usdc":"0.01","x-price":{"price_micro":10000,"asset":"USDC","network":"eip155:8453"},"x-payment":"x402","x-payment-route-id":"social_history","x-cadence":"Refreshes every 60 minutes.","x-cache-ttl-s":1800}}},"components":{"schemas":{"APIKeyCreate":{"properties":{"email":{"type":"string","title":"Email","description":"Where this key belongs. Agents: your human's real address, else your own mailbox.","example":"owner@yourcompany.com"}},"type":"object","required":["email"],"title":"APIKeyCreate"},"AgentSubscribeRequest":{"properties":{"plan":{"type":"string","title":"Plan","description":"pass_1h, pass_1d or pass_7d","example":"pass_1d"}},"type":"object","required":["plan"],"title":"AgentSubscribeRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}}},"servers":[{"url":"https://agentdataapi.com/social"}],"tags":[{"name":"Social signals from open networks","description":"Trending tags and links, ticker and crypto social volume with tone, hot discussions and GitHub star velocity from Bluesky, Mastodon, Nostr, Lemmy, Hacker News, Lobsters and GitHub."}]}