API

TANDIU API

REST and MCP access to TANDIU data.

AUTH

Authentication

Pro endpoints need an API key from a TANDIU Pro subscription. Send it as a bearer token:

curl -H "Authorization: Bearer tdu_your_key" \
  "https://www.tandiu.cn/api/v1/llm-price-history?model=deepseek&since=2026-09-01"

Base URL https://www.tandiu.cn/api/v1. Responses are JSON with as_of, source_url and a license field. Limit: 600 requests per minute per key. Errors: 401 missing/inactive key, 400 bad parameter, 429 rate limit.

ENDPOINTS

Endpoints

Endpoint	Query parameters	Returns
`GET /api/v1/llm-price-history`	model, vendor, country, since, until, limit	Daily official list-price history per model (USD/RMB per 1M tokens, source URL). Give model or vendor.
`GET /api/v1/price-index`	group (CN/US/ALL), since	Chain-linked LLM price index with the full series
`GET /api/v1/price-changes`	since, min_change_pct, limit	Recorded official price cuts/increases and models added to tracking
`GET /api/v1/cloud-agents`	kind, query, limit	Cloud agents with specs, monthly prices and TANDIU test results
`GET /api/v1/role-token-budget`	query, group, usage, limit	Monthly token budget per job role
`GET /api/v1/coding-pc`	category, tier, query	Computers for AI coding agents

MCP

MCP with your key

The remote MCP server at https://www.tandiu.cn/mcp (Streamable HTTP) accepts the same key. With a key you get 600 requests per minute and the get_llm_price_history tool. Example client config:

{
  "mcpServers": {
    "tandiu": {
      "url": "https://www.tandiu.cn/mcp",
      "headers": { "Authorization": "Bearer tdu_your_key" }
    }
  }
}

FREE

Free access

Without a key you can use every page, the open feeds listed in openapi.json and llms.txt, and all MCP tools except price history, at 60 requests per minute. Please cite TANDIU (tandiu.cn) with the page URL and date.