API reference
Per-endpoint reference pages with input parameters, response schemas, code samples in curl / Python / TypeScript, MCP tool names, and endpoint-specific FAQs. The full machine-readable spec is at /openapi.json.
Two ways to consume the API
Free endpoints return open AI ecosystem data and require no auth. Premium endpoints are pay-per-call in USDC on Base, gated by a bearer token from /developers/agent-payments. MCP tools wrap both tiers for Claude Desktop / Code consumption (see /glossary/mcp).
News
News
FreeGET /api/newsTensorFeed /api/news returns the latest AI news from 15+ sources updated every 10 minutes. Free, no auth, JSON response. Filter by category, limit results. Built for agents.
News Search
1 creditGET /api/premium/news/searchTensorFeed /api/premium/news/search: full-text search over the AI news corpus with relevance scoring, date/provider/category filters, recency boost. 1 credit.
Premium Verified News Feed
1 creditGET /api/premium/history/news/verifiedTensorFeed /api/premium/history/news/verified returns story clusters with N+ independent sources corroborating. The trust layer agents need to stop acting on single-source news. 1 credit.
Service status
Service Status
FreeGET /api/statusTensorFeed /api/status returns real-time operational status for Claude, OpenAI, Gemini, Mistral, Cohere, Replicate, HuggingFace, and more. Polled every 2 minutes. Free, no auth.
Premium Status Leaderboard
1 creditGET /api/premium/status/leaderboardTensorFeed /api/premium/status/leaderboard ranks AI providers by uptime over a custom range. Includes incident_count and mttr_minutes. 1 credit.
Premium Probe Series
1 creditGET /api/premium/probe/seriesTensorFeed /api/premium/probe/series returns daily aggregate latency, error rate, and TTFB history per LLM provider.
Models, benchmarks, comparison
Models
FreeGET /api/modelsTensorFeed /api/models returns AI model pricing, context windows, capabilities, and tiers across all major providers. Updated daily. Free, no auth.
Benchmarks
FreeGET /api/benchmarksTensorFeed /api/benchmarks returns AI model benchmark scores: SWE-bench, MMLU-Pro, HumanEval, GPQA, MATH. Updated weekly. Free, no auth.
Harnesses
FreeGET /api/harnessesTensorFeed /api/harnesses returns a cross-harness benchmark leaderboard: Claude Code, Cursor, Codex CLI, Aider, OpenHands, Devin, Cline, Windsurf, Amp on SWE-bench Verified, Terminal-Bench, Aider Polyglot, SWE-Lancer.
Multimodal Models
FreeGET /api/multimodalTensorFeed /api/multimodal returns image generation, video generation, TTS, and STT models with pricing in modality-native units. Sora, Veo, FLUX, ElevenLabs, Whisper, Deepgram. Free.
Embedding Models
FreeGET /api/embeddingsTensorFeed /api/embeddings returns the catalog of production embedding and reranker models: OpenAI, Voyage, Cohere, Google, Mistral, Jina, Nomic, Mixedbread, BAAI. Pricing, dimensions, MTEB. Free.
Inference Provider Matrix
FreeGET /api/inference-providersTensorFeed /api/inference-providers returns the cross-provider pricing matrix for open-weight models. Llama 4, DeepSeek V4, Mixtral, Qwen across Together, Fireworks, Groq, DeepInfra, OpenRouter, Replicate. Free.
Inference Cheapest
FreeGET /api/inference-providers/cheapestTensorFeed /api/inference-providers/cheapest returns the top 3 cheapest hosted inference offers for one open-weight model. Sort by blended, input, output, or output TPS. Free.
Compare Models
1 creditGET /api/premium/compare/modelsTensorFeed /api/premium/compare/models compares 2-5 AI models side-by-side with normalized benchmarks, pricing, status, and rankings. 1 credit per call.
Cost Projection
1 creditGET /api/premium/cost/projectionTensorFeed /api/premium/cost/projection projects a token-usage workload across 1-10 models with daily/weekly/monthly/yearly totals and cheapest-monthly ranking. 1 credit.
Premium LLM-Ready OpenRouter Model
1 creditGET /api/premium/clean/openrouter/{model_id}TensorFeed /api/premium/clean/openrouter/{model_id} returns one model from the 367-entry OpenRouter catalog as an LLM-ready fact card. Pricing per million tokens, capability flags, ~99.8% token reduction. 1 credit.
Premium PyPI Packages Momentum
1 creditGET /api/premium/packages/pypi/momentumTensorFeed /api/premium/packages/pypi/momentum returns weekly AI/ML PyPI download momentum with derived velocity ratios.
Routing recommendations
History series and snapshots
Attention History (Index)
FreeGET /api/attention/historyTensorFeed /api/attention/history returns the list of dates that have a captured AI Attention Index snapshot. Pair with /api/attention/history/{date} to read one day. Free.
Premium Attention Series
1 creditGET /api/premium/attention/seriesTensorFeed /api/premium/attention/series returns daily AI Attention Index per provider over a requested date range, with first/last/delta/min/max/avg summary. 1 credit per call.
Pricing Series
1 creditGET /api/premium/history/pricing/seriesTensorFeed /api/premium/history/pricing/series returns daily input/output/blended price points for one model with min/max/delta summary. 1 credit. Up to 90 days back.
Benchmark Series
1 creditGET /api/premium/history/benchmarks/seriesTensorFeed /api/premium/history/benchmarks/series returns score evolution for one benchmark on one model with delta in percentage points. 1 credit. 90 days max.
Uptime Rollup
1 creditGET /api/premium/history/status/uptimeTensorFeed /api/premium/history/status/uptime returns operational/degraded/down day counts and uptime % for a provider over up to 90 days. 1 credit per call.
Premium News Clusters (Full)
1 creditGET /api/premium/history/news/clusters/fullTensorFeed /api/premium/history/news/clusters/full returns the full untruncated cross-source story cluster set for a date or 30-day range.
Premium News Full
1 creditGET /api/premium/history/news/fullTensorFeed /api/premium/history/news/full returns the full untruncated daily news snapshot for one date or a 30-day range.
Premium News Source Health
1 creditGET /api/premium/history/news/source-healthTensorFeed /api/premium/history/news/source-health returns per-source RSS poll reliability series across a date range, max 90 days.
Security: CVE, KEV, EPSS, verified
Premium Verified CVE (cross-database)
1 creditGET /api/premium/security/verified/{cve_id}TensorFeed /api/premium/security/verified/{cve_id} composes MITRE CVE + CISA KEV + FIRST.org EPSS + OSV + Vulnrichment into one fact card with confirmed_by array and corroboration_count. 1 credit.
Premium EPSS Top-N
1 creditGET /api/premium/security/epss/topTensorFeed /api/premium/security/epss/top returns the top-N CVEs by EPSS score (exploitation likelihood) as of any UTC date. License: FIRST.org free for any use. 1 credit.
Premium KEV Full Catalog
1 creditGET /api/premium/security/kev/fullTensorFeed /api/premium/security/kev/full returns the complete CISA Known Exploited Vulnerabilities catalog (~1500 entries). License: US Gov public domain. 1 credit.
Premium CVE Range
1 creditGET /api/premium/security/cve/rangeTensorFeed /api/premium/security/cve/range returns CVE IDs added or modified across a UTC date range, capped at 30 days. Daily index from the MITRE cron.
Premium EPSS Series
1 creditGET /api/premium/security/epss/seriesTensorFeed /api/premium/security/epss/series returns full EPSS daily time-series for one CVE. License: FIRST.org free for any use.
Premium KEV Series
1 creditGET /api/premium/security/kev/seriesTensorFeed /api/premium/security/kev/series returns CISA KEV catalog additions across a UTC date range, max 90 days. License: US Gov public domain.
Macro economic digest
Climate + meteorological data
NWS US Weather Alerts
FreeGET /api/climate/weather-alertsTensorFeed /api/climate/weather-alerts returns active US weather alerts from the National Weather Service. Public domain. Free.
USGS Recent Earthquakes
FreeGET /api/climate/earthquakesTensorFeed /api/climate/earthquakes returns recent earthquakes from USGS pre-built summary feeds. Magnitude bucket + period bucket. Public domain. Free.
AI policy timeline
Research velocity + papers
Agents directory and provider deep-dive
Agent Ecosystem Opportunities (Daily Scan)
FreeGET /api/agents/opportunitiesTensorFeed /api/agents/opportunities returns a daily-refreshed scan of new GitHub repos across the AI agent ecosystem (Anthropic, OpenAI, Microsoft, ModelContextProtocol, HuggingFace, LangChain, frontier labs) plus MCP, x402, skills keyword sweeps. Free.
Vector Databases
FreeGET /api/vector-dbsTensorFeed /api/vector-dbs returns the production vector database catalog: Pinecone, Turbopuffer, Qdrant, Weaviate, Milvus, Chroma, pgvector, LanceDB, MongoDB Atlas, Vespa, Elasticsearch, OpenSearch. Free.
Enriched Agents Directory
1 creditGET /api/premium/agents/directoryTensorFeed /api/premium/agents/directory: AI agents catalog joined with live status, recent news, agent traffic, flagship pricing, and a 0-100 trending score. 1 credit.
Provider Deep-Dive
1 creditGET /api/premium/providers/{name}TensorFeed /api/premium/providers/{name} aggregates live status, all models with pricing + benchmarks joined, recent news, and agent traffic in one paid call. 1 credit.
Webhook watches
Agent morning brief
Attention Index
FreeGET /api/attentionTensorFeed /api/attention returns a derived 0-100 attention score per AI provider, computed from news volume, GitHub trending, and agent traffic. Updated every 5 minutes. Free, no auth.
What's New (Agent Brief)
1 creditGET /api/premium/whats-newTensorFeed /api/premium/whats-new: pricing changes + new models + status incidents + top news from the last 1-7 days in one paid call. The agent boot-up endpoint.
Payment flow
Payment Info
FreeGET /api/payment/infoTensorFeed /api/payment/info returns the wallet address, pricing tiers, supported flows, and verification metadata for the agent payments tier. Free, no auth.
Buy Credits
FreePOST /api/payment/buy-creditsTensorFeed /api/payment/buy-credits returns a 30-min payment quote: wallet, memo, credits, expiry. POST amount_usd to start the credit purchase flow. Free, no auth.
Confirm Payment
FreePOST /api/payment/confirmTensorFeed /api/payment/confirm verifies a USDC transaction on Base mainnet and returns a bearer token. POST tx_hash and optional nonce. Free, no auth.
Token Balance
Free with bearer tokenGET /api/payment/balanceTensorFeed /api/payment/balance returns the credit balance for the current bearer token. Authorization: Bearer tf_live_... required. Free.
Token Usage History
Free with bearer tokenGET /api/payment/usageTensorFeed /api/payment/usage returns the last 100 calls aggregated by endpoint for the current bearer token. Authorization required. Free.
Token Payment History
Free with bearer tokenGET /api/payment/historyTensorFeed /api/payment/history returns the bearer's credit-purchase audit log: which on-chain txs added how many credits and when. Free with bearer token.