# Agent Exchange Trends

> Hourly trending lists from Google Trends (US, GB, CA, AU, IN, DE, FR, BR, JP, MX), the most-read English Wikipedia articles of yesterday (WIKI) and the Hacker News front page (HN), as keyless JSON with first_seen, hours_trending, peak_rank and rank_history per item, plus day files and a per-topic index that accumulate from the first run. Nothing is estimated; every number is read from the store the hourly run writes.

## Lists (the "geo" in every route)
- US: United States (Google Trends)
- GB: United Kingdom (Google Trends)
- CA: Canada (Google Trends)
- AU: Australia (Google Trends)
- IN: India (Google Trends)
- DE: Germany (Google Trends)
- FR: France (Google Trends)
- BR: Brazil (Google Trends)
- JP: Japan (Google Trends)
- MX: Mexico (Google Trends)
- WIKI: English Wikipedia, most read (Wikimedia pageviews API)
- HN: Hacker News front page (Hacker News (Algolia search API))

## Free (JSON is CORS-open, ETagged, cached 5 minutes)
- https://trends.agentexchange.work/: today's page, every list with new and persistent markers, dated
- https://trends.agentexchange.work/trends/latest.json?geo=US and https://trends.agentexchange.work/trends/latest/<geo>.json: the current list; item = { source, geo, rank, title, slug, url, approx_traffic | score, comments, news[], hn_url, published, seen_at, first_seen, hours_trending (WIKI: days_trending), peak_rank, rank_history[{at,rank}], rising, persistent }
- https://trends.agentexchange.work/trends/day/<YYYY-MM-DD>/<geo>.json: every item that trended that UTC day (WIKI: pageviews day) with first_seen, last_seen, entry_rank, peak_rank, last_rank, runs_seen; free for the last 7 days
- https://trends.agentexchange.work/trends/topic/<slug>.json and https://trends.agentexchange.work/topic/<slug>: where and when one topic trended (last 7 days), joined with the day files
- https://trends.agentexchange.work/geo/<geo>: one list as a page with rank history and day-file links
- https://trends.agentexchange.work/trends/feed.xml?geo=<geo>: Atom feed of items that entered a list in the last 24 hours (omit geo for every list)
- https://trends.agentexchange.work/live.json: last run, runs, per-source status, fetch and KV counts; https://trends.agentexchange.work/health
- https://trends.agentexchange.work/mcp: MCP server (Streamable HTTP, JSON-RPC 2.0, no auth): tools trending_now(geo), topic_history(slug), day_archive(date, geo)
- https://trends.agentexchange.work/a2a: A2A JSON-RPC 2.0 endpoint (protocol 0.3.0; POST message/send, tasks/get, tasks/cancel; GET returns a pointer). Name a skill with message.metadata.skillId or a DataPart {"skill": "trending_now", "input": {"geo": "US"}}. Free skills (trending_now, topic_history, day_archive within 7 days, new_entries_feed, pricing) complete at once with the same JSON as the HTTP route. Paid skills (day_archive older than 7 days, archive_range, topic_history_full, paid-listing) answer a task in state input-required whose status.message.metadata carries x402.payment.required {x402Version, accepts} with the same accepts[] as the HTTP 402; reply on the same taskId with x402.payment.status "payment-submitted" and x402.payment.payload (a2a-x402 v0.1, https://github.com/google-agentic-commerce/a2a-x402/blob/main/spec/v0.1), or pay the HTTP route directly.
- https://trends.agentexchange.work/openapi.json (3.1, paid operations carry x-payment-info), https://trends.agentexchange.work/.well-known/agent-card.json (A2A card; url = https://trends.agentexchange.work/a2a), https://trends.agentexchange.work/.well-known/x402, https://trends.agentexchange.work/sitemap.xml

## Paid (x402: HTTP 402 with accepts[], sign EIP-3009 for USDC on Base, resend with X-PAYMENT; payTo 0xc91cE6291eDC0713ec753BAFBA002506ffb2b95c; prices identical in every description)
- GET https://trends.agentexchange.work/trends/day/<date>/<geo>.json older than 7 days: $0.01 per day file
- GET https://trends.agentexchange.work/trends/archive/<geo>/<from>/<to>.json: up to 90 day files in one response, $0.25
- GET https://trends.agentexchange.work/trends/topic/<slug>/history.json: the full history of one topic, $0.05
- POST https://trends.agentexchange.work/listings { url, name, description? }: one https URL listed 30 days on https://trends.agentexchange.work/listings, $1.00 (this host is new; no attention figure is claimed)
- Unknown days, ranges and topics answer 404 before any payment. Errors are JSON { error, code, message, hint, docs }.

## Method and terms
- Cron 7 * * * * UTC: one request per Google Trends geo per hour (RSS), one Hacker News request per hour (Algolia API), one Wikimedia request per day (pageviews top API); user agent agentexchange-trends/1.0 (+https://network.agentexchange.work); titles, counts and links only; no HTML scraping; each item links to its source. Terms: https://trends.agentexchange.work/terms. Pricing: https://trends.agentexchange.work/pricing.
- Derived fields CC BY 4.0 (cite trends.agentexchange.work); titles, counts and links remain their sources'.
- Related: https://network.agentexchange.work (all properties), https://agentexchange.work