API # TANDIU API REST and MCP access to TANDIU data. 2026-10-17 AUTH ## Authentication Pro endpoints need an API key from a [TANDIU Pro](https://www.tandiu.cn/en/pricing) 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](https://www.tandiu.cn/openapi.json) and [llms.txt](https://www.tandiu.cn/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.