| name | agenttimes |
| description | Live context layer for AI agents. One /ask endpoint for news, weather, crypto prices, and alerts. 228K+ articles, 3,576 feeds, 14 categories. Enriched with sentiment, entities, and credibility. Free to use, no API key needed. |
| metadata | {"openclaw":{"emoji":"📰","homepage":"https://agenttimes.live","author":"penghian","skillKey":"agenttimes","always":false,"requires":{"bins":"[Truncated]"},"links":{"homepage":"https://agenttimes.live","documentation":"https://agenttimes.live/info"}}} |
Agent Times — Live Context Layer for AI Agents
TL;DR
curl -s "https://agenttimes.live/ask?q=why+is+NVDA+down+today"
curl -s "https://agenttimes.live/ask?q=weather+tokyo"
curl -s "https://agenttimes.live/ask?q=bitcoin+price"
curl -s "https://agenttimes.live/trending"
Response is JSON. /ask auto-detects intent: news queries return articles with title, url, summary, sentiment, entities; $TICKER queries search by entity; weather queries return forecasts; crypto queries return prices. Check the source field. No API key needed.
Common Tasks — Copy-Paste Commands
Ticker search (use $ prefix):
curl -s "https://agenttimes.live/ask?q=%24NVDA"
curl -s "https://agenttimes.live/ask?q=%24SPY"
curl -s "https://agenttimes.live/ask?q=%24AAPL"
Weather (any city):
curl -s "https://agenttimes.live/ask?q=weather+tokyo"
curl -s "https://agenttimes.live/ask?q=weather+london"
Crypto prices:
curl -s "https://agenttimes.live/ask?q=bitcoin+price"
curl -s "https://agenttimes.live/prices?symbol=ETH,SOL,BTC"
News search:
curl -s "https://agenttimes.live/ask?q=why+did+NVDA+drop+today"
Job search (remote devops/SRE):
curl -s "https://agenttimes.live/news?category=business&tag=jobs&limit=20"
Country-specific news:
curl -s "https://agenttimes.live/ask?q=singapore+news"
Filter by any tag: Add &tag=TAG to /news. Example tags: jobs, gaming, space, bitcoin, asia, europe, startups, devtools.
What This Does
Agent Times is a one-stop information API for AI agents. 3,576 RSS feeds across 14 categories, weather forecasts, and crypto prices — all from one /ask endpoint.
- Semantic search + neural re-ranking — AI understands meaning, then a cross-encoder re-ranks results by true relevance. "Why did NVDA drop" finds "NVIDIA Falls 3% as Investors Weigh GTC Optimism Against Risks"
- FinBERT sentiment — finance articles scored by a financial-domain neural network. Correctly identifies "Rally fades as investors take profits" as bearish. Only runs on business, crypto, energy, ai, tech categories for accuracy.
- Source credibility — tier 1 (Reuters, BBC) get 1.3x ranking boost, tier 3 (unknown) get 0.8x penalty
- GLiNER entity extraction — zero-shot NER detects people, companies, locations, organizations, products, events. Plus ticker/crypto dictionary matching (300+ stocks, 100+ crypto).
- ModernBERT classification — each article classified by a fine-tuned ModernBERT model (93.9% accuracy, 149M params) reading actual text, not just RSS feed label. Tags auto-assigned by topic + country.
- Weather forecasts — global weather via Open-Meteo. Just ask "weather tokyo" or "weather london"
- Crypto prices — real-time prices from Pyth Network oracle (BTC, ETH, SOL, and 10+ more). Just ask "bitcoin price"
- Country tags — filter by 60+ countries and regions
- Webhook subscriptions — get notified when articles matching your topic arrive
- 4-tier fallback — semantic search → keyword search → web search (70+ engines) → query suggestions
228,000+ articles with 30-day retention. 6 AI models (embedder on GPU, classifier on GPU, cross-encoder, FinBERT, GLiNER NER, tag centroids).
When to Use Which Endpoint
| You want to... | Use this | Free? |
|---|
| Search for a topic | GET /ask?q=TOPIC | Yes |
| Check weather | GET /ask?q=weather+tokyo or GET /weather?location=tokyo | Yes |
| Get crypto prices | GET /ask?q=bitcoin+price or GET /prices?symbol=BTC | Yes |
| Get trending stories | GET /trending | Yes |
| Browse a category | GET /news?category=CAT | Yes |
| Filter by country/tag | GET /news?category=world&tag=singapore | Yes |
| Search the web | GET /search?q=QUERY | $0.001 (x402) |
| Monitor a topic | POST /subscribe | Yes |
| List categories | GET /news/categories | Yes |
Rule of thumb: Start with /ask. It's free, smart, and auto-detects if you're asking about news, weather, or crypto prices. Use /news only when you need bulk category browsing with filters.
/ask — Smart Search (FREE)
Searches all 228K+ articles using AI semantic matching + keyword matching + web search fallback. Returns results ranked by relevance and recency.
curl -s "https://agenttimes.live/ask?q=bitcoin+etf"
curl -s "https://agenttimes.live/ask?q=singapore+startup+funding"
curl -s "https://agenttimes.live/ask?q=climate+policy+europe&limit=20"
curl -s "https://agenttimes.live/ask?q=remote+devops+jobs"
| Param | Default | Description |
|---|
| q | required | Search query. Replace spaces with + |
| limit | 10 | Max results (1-50) |
Response:
{
"success": true,
"query": "bitcoin etf",
"source": "news_db",
"count": 10,
"results": [
{
"title": "SEC Approves Spot Bitcoin ETF Applications",
"url": "https://example.com/article",
"summary": "The Securities and Exchange Commission has approved...",
"category": "crypto",
"published": "Mon, 24 Mar 2026 14:30:00 +0000",
"sentiment": "bullish",
"sentiment_score": 0.75,
"credibility": "high",
"entities":
When /ask finds fewer than 3 results, it automatically falls back to web search. When 0 results, it returns suggestions with related categories and terms.
/trending — Trending Stories (FREE)
Detects stories being covered by multiple independent sources.
curl -s "https://agenttimes.live/trending?hours=12"
| Param | Default | Description |
|---|
| hours | 6 | Lookback window (1-48) |
| min_sources | 3 | Minimum sources covering the same story |
| limit | 20 | Max trending clusters |
/subscribe — Topic Alerts (FREE)
Get webhook notifications when new articles matching your query arrive.
curl -s -X POST https://agenttimes.live/subscribe \
-H "Content-Type: application/json" \
-d '{"query":"bitcoin regulation","category":"crypto","webhook":"https://your-agent.com/notify"}'
Response: {"success":true,"subscription_id":1,"secret":"abc123...","note":"Save this secret — you need it to unsubscribe."}
Unsubscribe (requires the secret from subscribe response):
curl -s -X DELETE "https://agenttimes.live/subscribe/1?secret=abc123..."
Your webhook receives a POST with matching articles every time new ones arrive (checked every 5 minutes).
Security: Webhook must be a public HTTPS URL. Localhost, private IPs, and cloud metadata endpoints are blocked.
/news — Category Browsing (FREE)
Browse and filter articles by category with optional tag, date range, and keyword filters.
curl -s "https://agenttimes.live/news?category=crypto&limit=10"
curl -s "https://agenttimes.live/news?category=world&tag=asia"
curl -s "https://agenttimes.live/news?category=world&tag=singapore"
curl -s "https://agenttimes.live/news?category=entertainment&tag=gaming"
curl -s "https://agenttimes.live/news?category=business&tag=jobs"
curl -s "https://agenttimes.live/news?category=ai&since=2026-03-22"
curl -s "https://agenttimes.live/news?category=tech&q=rust+programming"
| Param | Default | Description |
|---|
| category | required | One of 14 categories, or all |
| tag | — | Subcategory/country filter (see table below) |
| limit | 20 | Max results (1-1000) |
| q | — | Keyword filter within category |
| since | — | ISO date — articles after this time |
| before | — | ISO date — articles before this time |
| dedup | true | Deduplicate similar headlines |
/search — Web Search ($0.001)
Search the open web via 70+ engines when you need non-news results.
curl -s "https://agenttimes.live/search?q=how+to+deploy+docker"
| Param | Default | Description |
|---|
| q | required | Search query |
| limit | 5 | Max results (1-50) |
| category | general | general, news, images, videos, science, files |
Categories + Tags
14 categories. Use &tag= on /news to filter by subcategory, country, or region.
| Category | What's in it | Available tags |
|---|
| world | International news, geopolitics, diplomacy | asia, europe, middleeast, africa, india, latam, oceania, defense, government + 50 country tags (see below) |
| politics | Elections, policy, legislation, regulation | — |
| business | Finance, commerce, employment, markets | finance, startups, jobs, marketing, ecommerce, fintech, realestate, legal, supplychain |
| tech | Software, hardware, engineering, data | devtools, engineering, mobile, datascience, telecom |
| ai | Artificial intelligence, machine learning | robotics, research |
| crypto | Cryptocurrency, blockchain, DeFi | web3, defi, bitcoin, markets |
| science | Research, discoveries, academia | biotech, space, research |
| health | Medicine, wellness, public health | fitness |
| energy | Energy, climate change, environment | climate, environment, agriculture |
| security | Cybersecurity, infosec, threats | — |
|
Country Tags (use with category=world&tag=COUNTRY)
Asia: singapore, malaysia, philippines, indonesia, thailand, vietnam, japan, korea, china, taiwan, hongkong, india, pakistan, bangladesh
Europe: uk, germany, france, italy, spain, netherlands, sweden, norway, denmark, finland, ireland, poland, austria, switzerland, iceland, romania, hungary, greece, serbia, ukraine, russia
Middle East: israel, turkey, iran, saudiarabia, uae, qatar
Africa: nigeria, southafrica, kenya, ghana, ethiopia
Latin America: brazil, mexico, argentina, colombia, chile, peru
Oceania: australia, newzealand
North America: usa, canada
Response Format
News results (/ask, /news, /trending) return:
{"success": true, "count": N, "results": [...]}
Weather (/ask?q=weather+tokyo) returns: {"source": "open-meteo", "location": "...", "current": {...}, "forecast": [...]}
Crypto prices (/ask?q=bitcoin+price) returns: {"source": "pyth", "prices": [{"symbol": "BTC", "price": 66000}]}
Check the source field to determine response shape: news_db, combined, open-meteo, nea, or pyth.
Each article result contains:
title — headlineurl — link to original articlesummary — first 200 chars of contentcategory — one of 14 categoriessource_feed — RSS feed URLpublished — publication datetimestamp — Unix timestamp (ms)sentiment — "bullish", "bearish", or "neutral"sentiment_score — -1.0 (very bearish) to 1.0 (very bullish)credibility — "high" (tier 1 outlets), "medium" (established), or "unknown"entities — {people, companies, tickers, crypto, locations} extracted by GLiNER + dictionary matchingtags — subcategory and country tags for this article
Errors: {"success": false, "error": "Missing param: q"}
Payment (x402)
The /search endpoint uses the x402 protocol. Your agent pays $0.001 USDC per request on Base network — no accounts, no subscriptions, just micropayments. All other endpoints are free.
Wallet: 0x536Eafe011786599d9a656D62e2aeAFcE06a96D1 (Base)
Other Free Endpoints
| Endpoint | Description |
|---|
GET /news/categories | List all 14 categories with counts |
GET /stats | Database statistics |
GET /feeds/health?category=CAT | Per-feed health and status |
GET /health | Health check |
GET /info | Full API docs (JSON for agents, HTML for browsers) |
Tips for Best Results
- Always start with
/ask — it's free, semantic, and handles fallback automatically
- Country news: Use
/ask?q=japan+earthquake not /news?category=japan (no country categories)
- Filter by country: Use
/news?category=world&tag=singapore for source-based filtering
- Sentiment analysis: Check
sentiment_score to gauge market/public mood on a topic
- Entity detection: Use
entities.tickers and entities.crypto to find articles mentioning specific assets
- Monitor breaking news: POST to
/subscribe with a webhook URL to get real-time alerts
- Parse JSON directly — don't pipe to
jq (may not be installed)
- Replace spaces with
+ in all query strings
- Check
suggestions when 0 results — it recommends related categories and search terms
- Credibility matters: Sort by
credibility to prioritize tier 1 sources (Reuters, BBC, AP) over unknown blogs
