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

Free

GET /api/news

TensorFeed /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 credit

GET /api/premium/news/search

TensorFeed /api/premium/news/search: full-text search over the AI news corpus with relevance scoring, date/provider/category filters, recency boost. 1 credit.

Service status

Service Status

Free

GET /api/status

TensorFeed /api/status returns real-time operational status for Claude, OpenAI, Gemini, Mistral, Cohere, Replicate, HuggingFace, and more. Polled every 5 minutes. Free, no auth.

Models, benchmarks, comparison

Models

Free

GET /api/models

TensorFeed /api/models returns AI model pricing, context windows, capabilities, and tiers across all major providers. Updated daily. Free, no auth.

Benchmarks

Free

GET /api/benchmarks

TensorFeed /api/benchmarks returns AI model benchmark scores: SWE-bench, MMLU-Pro, HumanEval, GPQA, MATH. Updated weekly. Free, no auth.

Compare Models

1 credit

GET /api/premium/compare/models

TensorFeed /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 credit

GET /api/premium/cost/projection

TensorFeed /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.

Routing recommendations

Routing Recommendations

1 credit

GET /api/premium/routing

TensorFeed /api/premium/routing returns top-N ranked AI models for a task with composite-score breakdown across quality, availability, cost, latency. 1 credit per call.

History series and snapshots

Pricing Series

1 credit

GET /api/premium/history/pricing/series

TensorFeed /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 credit

GET /api/premium/history/benchmarks/series

TensorFeed /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 credit

GET /api/premium/history/status/uptime

TensorFeed /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.

Snapshot Diff

1 credit

GET /api/premium/history/compare

TensorFeed /api/premium/history/compare diffs two daily snapshots: added, removed, and changed entries with deltas. Type pricing or benchmarks. 1 credit.

Forecasting

Forecast

1 credit

GET /api/premium/forecast

TensorFeed /api/premium/forecast: linear-regression forecast for AI model price or benchmark with 95% prediction interval and confidence label. 1 credit.

Agents directory and provider deep-dive

Enriched Agents Directory

1 credit

GET /api/premium/agents/directory

TensorFeed /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 credit

GET /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

Webhook Watches

1 credit per registration

POST /api/premium/watches

TensorFeed /api/premium/watches registers a webhook watch on price changes, status transitions, or scheduled digests. HMAC-signed POST delivery. 1 credit.

Agent morning brief

What's New (Agent Brief)

1 credit

GET /api/premium/whats-new

TensorFeed /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

Free

GET /api/payment/info

TensorFeed /api/payment/info returns the wallet address, pricing tiers, supported flows, and verification metadata for the agent payments tier. Free, no auth.

Buy Credits

Free

POST /api/payment/buy-credits

TensorFeed /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

Free

POST /api/payment/confirm

TensorFeed /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 token

GET /api/payment/balance

TensorFeed /api/payment/balance returns the credit balance for the current bearer token. Authorization: Bearer tf_live_... required. Free.

Token Usage History

Free with bearer token

GET /api/payment/usage

TensorFeed /api/payment/usage returns the last 100 calls aggregated by endpoint for the current bearer token. Authorization required. Free.

Looking for the agent-first overview instead? See /for-ai-agents. For the full payment flow with code examples, see /developers/agent-payments. For use-case-specific integration paths, see /use-cases.