{"bulk_downloads":{"catalog":"https://api.tigzig.com/downloads/tremor","all_products":"https://api.tigzig.com/downloads","file_names":"Every file also has an address that ends in its own file name, for example https://api.tigzig.com/v1/download/macro_indicators.parquet. The ?format= form keeps working.","query_in_place":"Parquet files support HTTP range requests, so DuckDB, pyarrow, polars or a browser can query them in place and read only the parts a query needs. Browsers can do the same: responses expose Content-Range, Content-Length and ETag to cross-origin JavaScript.","example_sql":"SELECT count(*) FROM read_parquet('https://api.tigzig.com/v1/download/macro_indicators.parquet');"},"app":"Tigzig Unified Data Surface","description":"Category-first read-only API + MCP over curated macro, credit, valuation, India, global, markets and FX indicators. Progressive-disclosure design: 4 tools an agent navigates. Every indicator carries a `notes` field with agent-relevant gotchas (annualization recipes, sign conventions, methodology breaks).","base_url":"/v1","mcp":"https://api.tigzig.com/mcp","openapi":"https://api.tigzig.com/v1/openapi.json","docs":"https://api.tigzig.com/v1/docs","data_dictionary":"https://api.tigzig.com/v1/categories","tigzig":"Part of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for analytics and live data across global and Indian markets, macro indicators and filings. Catalog: https://api.tigzig.com/.well-known/api-catalog | Guide: https://www.tigzig.com/llms.txt","version":1,"categories":[{"id":"us_macro","one_liner":"US macro from FRED and the University of Michigan: monetary policy and Treasury yields, labor, inflation, GDP, consumer sentiment, housing, financial conditions.","backend":"time_series"},{"id":"us_credit","one_liner":"US credit stress: delinquency + charge-offs from FRED + FFIEC, NCUA credit-union aggregates, NY Fed Household Debt, FDIC bank aggregates.","backend":"time_series"},{"id":"us_valuation","one_liner":"US equity-market valuation: Shiller CAPE, and the Buffett indicator (market cap / GDP) with its two components. Treasury yields are in us_macro.","backend":"time_series"},{"id":"us_insurance","one_liner":"US insurance industry (Fed Z.1 invested assets, Life and P&C). Not loaded into this API yet, so it returns no indicators; the data is in the web tool at https://tremor.tigzig.com/tools/us-insurance.","backend":"time_series"},{"id":"india_macro","one_liner":"India macro + credit: RBI WSS (rates, FX reserves, money supply), MoSPI (IIP, CPI, WPI, GDP, GFCF), NSE Nifty 50 PE/PB/DivYield.","backend":"time_series"},{"id":"global_macro","one_liner":"Global macro: OECD Business Confidence Indicator for selected countries, and non-US 10-year sovereign yields (Germany, UK, euro area, Japan).","backend":"time_series"},{"id":"markets","one_liner":"Daily market prices from Yahoo Finance: US, Indian, Asian and European equity indices, the US 10Y yield, the dollar index and major FX, and commodities (metals, oil, natural gas).","backend":"market_prices"},{"id":"currencies","one_liner":"Daily USD exchange rates against the rupee and other Asian and emerging-market currencies, for INR-vs-peer comparisons.","backend":"time_series"}],"tools":{"list_categories":{"path":"/v1/categories","description":"List all V2 categories with one-liner descriptions. Start here if you don't know which domain a question lives in."},"list_indicators_in_category":{"path":"/v1/categories/{category}/indicators","description":"Returns indicator metadata for one category. Optional ?compact=true returns just {id, name, frequency, last_date}."},"find_indicator":{"path":"/v1/find","description":"Cross-category fuzzy substring search on indicator id and display name. Required: query. Optional: limit (default 50, max 200)."},"get_series":{"path":"/v1/series","description":"Time series for one or more indicators. Wide-format pivot. Required: ids (comma-separated, max 10). Optional: from, to (YYYY-MM-DD), format (json | tsv)."}},"downloads":{"manifest":{"path":"/v1/downloads/manifest","description":"File manifest with sizes, row counts, and generated_at timestamp. Iterate this instead of hard-coding filenames."},"download_table":{"path":"/v1/download/{table_name}","description":"One Tremor table as a pre-generated file. Tables: macro_indicators, stock_prices, indicator_config. 9 formats (csv/tsv/parquet/sqlite/duckdb + .gz / .zip variants)."},"download_all":{"path":"/v1/download/all","description":"All 3 tables in one file. Formats: sqlite, sqlite.gz, duckdb, duckdb.gz. README.md inside."}},"limits":{"per_ip_per_minute":60,"per_ip_downloads_per_minute":10,"max_ids_per_series_call":10,"max_rows_per_response":10000,"on_429":"When you exceed a limit, the API returns HTTP 429 with Retry-After: 60 (honor it to back off cleanly) and a JSON body that names the limit hit + a path-aware suggestion.","heavy_pull_guidance":"If you need many indicators or long history, use /v1/download/all (full dataset, one file) or /v1/download/{table}?format=parquet (one table). One request vs many small ones avoids rate limits entirely."},"notes":"V2 is a progressive-disclosure surface. Pick a category, expand to its indicator catalog, then fetch data. Bulk downloads serve the same pre-generated files as V1's /tremor/v1/download/*. V1 (/tremor/v1/) remains operational for existing integrations."}