{"openapi":"3.1.0","info":{"title":"Tigzig Unified Data Surface","version":"3.1.0","description":"Category-first read-only public API + MCP over curated macro, credit, valuation, India, global, markets and FX indicators. Sourced from FRED, OECD, RBI, MoSPI, ECB, BoE, Bundesbank, NY Fed, NCUA, FDIC, FFIEC, Shiller, Cox/Manheim, NSE, Yahoo Finance and others. Updated daily-to-weekly per source cadence. No auth required.\n\n**Progressive-disclosure MCP design:** unlike a flat catalog that dumps every indicator into one tool description at session init, the unified surface exposes 4 tools an agent navigates - `list_categories` (the 8-domain menu), `list_indicators_in_category` (per-domain catalog WITH the `notes` field), `find_indicator` (cross-category fuzzy search), and `v2_get_series` (wide-pivot time series, JSON or TSV). Session-init token weight is ~1,350 vs ~7,850 for the flat Tremor V1 MCP - 83% lighter, and scales as new domains land.\n\n**The `notes` field:** every indicator carries agent-relevant sharp-edges - annualization recipes ('already SAAR - do NOT multiply by 4'), sign conventions ('NEGATIVE = net outflow'), methodology breaks ('Nifty50 P/E: standalone pre-Apr 2021, consolidated after'), leading-indicator behavior. 100% coverage across the ~330 visible indicators. READ NOTES BEFORE COMPUTING - the name + unit alone will silently mislead an agent.\n\n**Quick start (REST):**\n- `GET /v1/categories` - the 8 domains with one-liners\n- `GET /v1/categories/us_credit/indicators` - per-domain catalog (add `?compact=true` for id/name/frequency only)\n- `GET /v1/find?query=usdinr` - cross-category fuzzy match\n- `GET /v1/series?ids=us_treasury_10y_yield,us_core_cpi&from=2020-01-01` - wide-format pivot, up to 10 ids per call, `format=tsv` for token-light\n- Bulk: `GET /v1/download/all` (~7 MB sqlite/duckdb - full dataset in one file, preferable to paginating /series for heavy pulls)\n\n**MCP:** POST to https://api.tigzig.com/mcp with `Accept: application/json, text/event-stream` (Streamable HTTP; SSE fallback at /mcp/sse but not advertised). Any modern MCP client (Claude.ai connectors, Cursor, Continue, n8n) can add the URL directly. Open-source reference wrapper: https://github.com/amararun/tigzig-mcp-v2-reference\n\n**Gotchas:** dates are YYYY-MM-DD. `v1_get_series` mixes multiple indicators into one wide-pivot response even if they have different frequencies - check the returned columns. TSV responses open with a `# meta: count=N unknown=[...] empty=[...]` comment line so agents can distinguish typos from empty-date-range hits even in TSV (most parsers respect `#` comments).\n\n**Navigation (machine-readable):** catalog https://api.tigzig.com/v1/ | categories https://api.tigzig.com/v1/categories | downloads https://api.tigzig.com/v1/download/all | MCP https://api.tigzig.com/mcp | human docs https://www.tigzig.com/apis/unified\n\nAuthor: Amar Harolikar - https://www.linkedin.com/in/amarharolikar\n\nRate limit: 60 requests/min per IP. Downloads: whole files 60/min and 500/day per IP; HTTP range reads and HEAD 3,000/min and 25,000/day.\n\nPart 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\n\nApp: https://tremor.tigzig.com\n\nSource: each indicator names its publisher in the `source` field. Provided as is, with no guarantee of accuracy, completeness or availability and no support commitment.\n\n**Whole-dataset downloads:** every file for this product, with sizes and formats, is listed at https://api.tigzig.com/downloads/tremor (all products: https://api.tigzig.com/downloads). 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. 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: `SELECT count(*) FROM read_parquet('https://api.tigzig.com/v1/download/macro_indicators.parquet');` Also published as files only, with no endpoint here: India bank credit by sector (RBI); US insurance company investments (Fed Z.1); US bank lending to non-bank financial firms (NDFI), bank by bank; US banks: loans, delinquency and charge-offs (FDIC); US credit unions: loans, delinquency and charge-offs (NCUA); US household debt and delinquency (NY Fed); Who holds Indian securities in custody (NSDL); India FPI holdings by country of the fund (NSDL); India FPI flows, daily (NSDL); India FPI holdings at month end (NSDL); India FPI flows, monthly (NSDL); India FPI equity by sector, fortnightly (NSDL); India FDI and NRI deposits, monthly (RBI); India mutual funds, monthly: flows, assets and SIPs (AMFI, SEBI); India mutual fund trades on the stock exchanges, daily (SEBI); Trump 2025 annual disclosure: business entities (OGE 278e, Part 2 Schedule 1); Trump 2025 annual disclosure: holdings (OGE 278e, Part 6); Trump 2025 annual disclosure: positions, agreements, spouse, liabilities, gifts (OGE 278e); Trump 2025 annual disclosure: transactions (OGE 278e, Part 7); Trump stock and bond trades (OGE 278-T filings). See https://api.tigzig.com/downloads/tremor.","contact":{"name":"Amar Harolikar","url":"https://www.tigzig.com/","email":"amar@harolikar.com"}},"servers":[{"url":"https://api.tigzig.com","description":"Production"}],"paths":{"/v1/":{"get":{"tags":["V1 - Unified Data Surface"],"summary":"V2 catalog - lists every category with a one-liner","description":"V2 catalog entry point. Returns the categories list + tool surface\nsummary. Convenient for humans to inspect; MCP agents see the same\ninformation via the server-instructions field at session init.","operationId":"v2_catalog","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"externalDocs":{"description":"Endpoint documentation on the Tigzig Unified Data Surface page","url":"https://www.tigzig.com/apis/unified#endpoints"}}},"/v1/categories/{category}/indicators":{"get":{"tags":["V1 - Unified Data Surface"],"summary":"List indicators in a V2 category","description":"Returns metadata for every visible indicator in one Tigzig V2 category.\n\nEach indicator row carries: indicator_id, name, country, frequency, unit, source, source_series_id, seasonally_adjusted, first_date, last_date, record_count, and `notes` (free-text caveats: annualization rules, cumulative-vs-per-period semantics, base-year vintages, source-method discontinuities). READ THE NOTES before computing - they capture the gotchas that the name + unit fields alone don't convey. Pick which ids you need, then call v2_get_series with those ids.\n\nTip: pass compact=true for big categories - returns just {indicator_id, name, frequency, last_date} per row (no notes), saves tokens.\n\nCategories:\n  us_macro       US macro from FRED and the University of Michigan: monetary policy and Treasury yields, labor, inflation, GDP, consumer sentiment, housing, financial conditions.\n  us_credit      US credit stress: delinquency + charge-offs from FRED + FFIEC, NCUA credit-union aggregates, NY Fed Household Debt, FDIC bank aggregates.\n  us_valuation   US equity-market valuation: Shiller CAPE, and the Buffett indicator (market cap / GDP) with its two components. Treasury yields are in us_macro.\n  us_insurance   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.\n  india_macro    India macro + credit: RBI WSS (rates, FX reserves, money supply), MoSPI (IIP, CPI, WPI, GDP, GFCF), NSE Nifty 50 PE/PB/DivYield.\n  global_macro   Global macro: OECD Business Confidence Indicator for selected countries, and non-US 10-year sovereign yields (Germany, UK, euro area, Japan).\n  markets        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).\n  currencies     Daily USD exchange rates against the rupee and other Asian and emerging-market currencies, for INR-vs-peer comparisons.\n\nUnknown category returns HTTP 404 with the valid list, so an agent that skipped list_categories can still recover.","operationId":"list_indicators_in_category","parameters":[{"name":"category","in":"path","required":true,"schema":{"type":"string","description":"Category slug. Discover valid slugs via GET /v1/categories.","title":"Category"},"description":"Category slug. Discover valid slugs via GET /v1/categories.","examples":{"us_macro":{"summary":"US macro indicators: unemployment, GDP, consumer sentiment, yields","value":"us_macro"},"india_macro":{"summary":"India macro indicators: CPI, IIP, WPI, GDP","value":"india_macro"},"markets":{"summary":"Daily market prices: indices, yields, FX, commodities","value":"markets"}}},{"name":"compact","in":"query","required":false,"schema":{"type":"boolean","description":"If true, return {indicator_id, name, frequency, last_date} only. Lighter payload for big categories.","default":false,"title":"Compact"},"description":"If true, return {indicator_id, name, frequency, last_date} only. Lighter payload for big categories."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"externalDocs":{"description":"Endpoint documentation on the Tigzig Unified Data Surface page","url":"https://www.tigzig.com/apis/unified#endpoints"}}},"/v1/categories":{"get":{"tags":["V1 - Unified Data Surface"],"summary":"List all V2 categories with one-liner descriptions","description":"Returns the full menu of Tigzig V2 categories with a one-line summary of each. Call this first when you don't know which domain a question lives in. Then call list_indicators_in_category to expand any.\n\nCategories:\n  us_macro       US macro from FRED and the University of Michigan: monetary policy and Treasury yields, labor, inflation, GDP, consumer sentiment, housing, financial conditions.\n  us_credit      US credit stress: delinquency + charge-offs from FRED + FFIEC, NCUA credit-union aggregates, NY Fed Household Debt, FDIC bank aggregates.\n  us_valuation   US equity-market valuation: Shiller CAPE, and the Buffett indicator (market cap / GDP) with its two components. Treasury yields are in us_macro.\n  us_insurance   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.\n  india_macro    India macro + credit: RBI WSS (rates, FX reserves, money supply), MoSPI (IIP, CPI, WPI, GDP, GFCF), NSE Nifty 50 PE/PB/DivYield.\n  global_macro   Global macro: OECD Business Confidence Indicator for selected countries, and non-US 10-year sovereign yields (Germany, UK, euro area, Japan).\n  markets        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).\n  currencies     Daily USD exchange rates against the rupee and other Asian and emerging-market currencies, for INR-vs-peer comparisons.","operationId":"list_categories","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"externalDocs":{"description":"Endpoint documentation on the Tigzig Unified Data Surface page","url":"https://www.tigzig.com/apis/unified#endpoints"}}},"/v1/find":{"get":{"tags":["V1 - Unified Data Surface"],"summary":"Cross-category indicator search by id substring or name","description":"Substring search over indicator IDs and display names across ALL V2 categories. Use this when you know what you want but not which category it lives in (e.g. 'usdinr', 'shiller', 'cape', 'nominal').\n\nReturns: {indicator_id, name, category, country, frequency, first_date, last_date}. Match is case-insensitive substring on indicator_id OR display name. The `category` field on each hit tells you which V2 category to call list_indicators_in_category or v2_get_series against.","operationId":"find_indicator","parameters":[{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":60},{"type":"null"}],"description":"Substring to match against indicator_id or display name. Alias: `q`.","title":"Query"},"description":"Substring to match against indicator_id or display name. Alias: `q`.","examples":{"yield_series":{"summary":"Find every yield-related indicator across categories","value":"yield"},"usdinr":{"summary":"Find USDINR spot and related INR series","value":"usdinr"},"shiller_cape":{"summary":"Find the Shiller CAPE valuation series","value":"cape"}}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Max results to return.","default":50,"title":"Limit"},"description":"Max results to return."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"externalDocs":{"description":"Endpoint documentation on the Tigzig Unified Data Surface page","url":"https://www.tigzig.com/apis/unified#endpoints"}}},"/v1/series":{"get":{"tags":["V1 - Unified Data Surface"],"summary":"Get time-series data for one or more V2 indicators (wide format)","description":"Returns wide-format time series: one row per date, one column per indicator. Works seamlessly across V2 backends - mix macro indicators and market prices in one call.\n\nRequired: ids (comma-separated, max 10). Optional: from + to (YYYY-MM-DD), format (json | tsv).\n\nUse format=tsv for long / daily series to save tokens - much lighter than the default JSON. The TSV body has this shape:\n  # meta: count=N unknown=[id1,...] empty=[id1,...]\n  date<TAB>id1<TAB>id2<TAB>...\n  YYYY-MM-DD<TAB>val<TAB>val<TAB>...\nFirst line is always a '#' meta comment - same unknown/empty signals as the JSON path. Most TSV parsers skip '#' lines (pandas: comment='#'; duckdb read_csv: SKIP). The HTTP headers X-V2-Unknown-Ids / X-V2-Empty-Ids / X-V2-Count also carry this info for REST consumers.\n\nJSON response includes meta.unknown_ids (ids not in any V2 catalog) and meta.empty_ids (ids that exist but returned no rows in the date range). Use these to distinguish 'typo' from 'no data here'.","operationId":"v2_get_series","parameters":[{"name":"ids","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated indicator ids. Max 10.","title":"Ids"},"description":"Comma-separated indicator ids. Max 10.","examples":{"us_yields_recent":{"summary":"US Treasury 2Y and 10Y yields together","value":"us_treasury_2y_yield,us_treasury_10y_yield"},"cross_country_gdp":{"summary":"US real GDP growth alongside India GDP (base 2022-23)","value":"us_real_gdp_growth,in_gdp_constant_2223"},"us_core_inflation":{"summary":"US core CPI and core PCE, monthly","value":"us_core_cpi,us_core_pce"}}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"YYYY-MM-DD","title":"From"},"description":"YYYY-MM-DD"},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"YYYY-MM-DD","title":"To"},"description":"YYYY-MM-DD"},{"name":"format","in":"query","required":false,"schema":{"type":"string","description":"Response format: 'json' (default, wide-pivot with meta) or 'tsv' (tab-separated; meta goes into response headers).","default":"json","title":"Format"},"description":"Response format: 'json' (default, wide-pivot with meta) or 'tsv' (tab-separated; meta goes into response headers)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"externalDocs":{"description":"Endpoint documentation on the Tigzig Unified Data Surface page","url":"https://www.tigzig.com/apis/unified#endpoints"}}},"/v1/downloads/manifest":{"get":{"tags":["V1 - Unified Data Surface"],"summary":"Manifest of pre-generated download files (sizes, row counts, generated_at)","description":"Returns the manifest of pre-generated bulk download files. The manifest is the source of truth - iterate over it instead of hard-coding filenames, so future tables auto-appear without breaking client code.\n\nSame files served by V1's /tremor/v1/downloads/manifest - V2 is just a URL alias so V2 consumers don't need to know V1's prefix.","operationId":"v2_downloads_manifest","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"externalDocs":{"description":"Endpoint documentation on the Tigzig Unified Data Surface page","url":"https://www.tigzig.com/apis/unified#endpoints"}},"head":{"tags":["V1 - Unified Data Surface"],"summary":"Manifest of pre-generated download files (sizes, row counts, generated_at)","description":"Returns the manifest of pre-generated bulk download files. The manifest is the source of truth - iterate over it instead of hard-coding filenames, so future tables auto-appear without breaking client code.\n\nSame files served by V1's /tremor/v1/downloads/manifest - V2 is just a URL alias so V2 consumers don't need to know V1's prefix.","operationId":"v2_downloads_manifest","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"externalDocs":{"description":"Endpoint documentation on the Tigzig Unified Data Surface page","url":"https://www.tigzig.com/apis/unified#endpoints"}}},"/v1/download/all":{"head":{"tags":["V1 - Unified Data Surface"],"summary":"Download ALL Tremor tables in one file (sqlite or duckdb)","description":"Single file with macro_indicators (visible-filtered), stock_prices, and indicator_config (data dictionary). README.md inside the zip.\n\nFormats: sqlite (default, .db.zip), sqlite.gz, duckdb (.duckdb.zip), duckdb.gz. CSV/TSV/Parquet are per-table only - use /v1/download/{table}.\n\nSame file served by V1's /tremor/v1/download/all.","operationId":"v2_download_all","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","description":"One-file-everything format. Choose: sqlite (default, .db.zip), sqlite.gz, duckdb (.duckdb.zip), duckdb.gz. CSV/TSV/Parquet are per-table only (use /v1/download/{table_name}).","enum":["sqlite","sqlite.gz","duckdb","duckdb.gz"],"default":"sqlite","title":"Format"},"description":"One-file-everything format. Choose: sqlite (default, .db.zip), sqlite.gz, duckdb (.duckdb.zip), duckdb.gz. CSV/TSV/Parquet are per-table only (use /v1/download/{table_name})."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"externalDocs":{"description":"Endpoint documentation on the Tigzig Unified Data Surface page","url":"https://www.tigzig.com/apis/unified#endpoints"}},"get":{"tags":["V1 - Unified Data Surface"],"summary":"Download ALL Tremor tables in one file (sqlite or duckdb)","description":"Single file with macro_indicators (visible-filtered), stock_prices, and indicator_config (data dictionary). README.md inside the zip.\n\nFormats: sqlite (default, .db.zip), sqlite.gz, duckdb (.duckdb.zip), duckdb.gz. CSV/TSV/Parquet are per-table only - use /v1/download/{table}.\n\nSame file served by V1's /tremor/v1/download/all.","operationId":"v2_download_all","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","description":"One-file-everything format. Choose: sqlite (default, .db.zip), sqlite.gz, duckdb (.duckdb.zip), duckdb.gz. CSV/TSV/Parquet are per-table only (use /v1/download/{table_name}).","enum":["sqlite","sqlite.gz","duckdb","duckdb.gz"],"default":"sqlite","title":"Format"},"description":"One-file-everything format. Choose: sqlite (default, .db.zip), sqlite.gz, duckdb (.duckdb.zip), duckdb.gz. CSV/TSV/Parquet are per-table only (use /v1/download/{table_name})."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"externalDocs":{"description":"Endpoint documentation on the Tigzig Unified Data Surface page","url":"https://www.tigzig.com/apis/unified#endpoints"}}},"/v1/download/{table_name}":{"head":{"tags":["V1 - Unified Data Surface"],"summary":"Download one Tremor table as a pre-generated file","description":"Available tables (visible-filtered):\n- macro_indicators: long-format time series, ~290 visible indicators\n- stock_prices: daily OHLCV for 16 market symbols\n- indicator_config: data dictionary (display name, source, notes per indicator)\n\nFormats: csv (zip), csv.gz, tsv (zip), tsv.gz, parquet (default), sqlite (.db.zip), sqlite.gz, duckdb (.duckdb.zip), duckdb.gz.\n\nSame files served by V1's /tremor/v1/download/{table_name}.","operationId":"v2_download_table","parameters":[{"name":"table_name","in":"path","required":true,"schema":{"type":"string","description":"One of `macro_indicators`, `stock_prices`, `indicator_config`.","title":"Table Name"},"description":"One of `macro_indicators`, `stock_prices`, `indicator_config`.","examples":{"macro_indicators_parquet":{"summary":"All visible macro indicators as Parquet","value":"macro_indicators"},"stock_prices_sqlite":{"summary":"Daily OHLCV for 16 market symbols as SQLite (properly typed)","value":"stock_prices"},"indicator_config_csv":{"summary":"The data dictionary as CSV.gz","value":"indicator_config"}}},{"name":"format","in":"query","required":false,"schema":{"type":"string","description":"File format. Choose: csv (zip), csv.gz, tsv (zip), tsv.gz, parquet (default), sqlite (.db.zip), sqlite.gz, duckdb (.duckdb.zip), duckdb.gz.","enum":["csv","csv.gz","tsv","tsv.gz","parquet","sqlite","sqlite.gz","duckdb","duckdb.gz"],"default":"parquet","title":"Format"},"description":"File format. Choose: csv (zip), csv.gz, tsv (zip), tsv.gz, parquet (default), sqlite (.db.zip), sqlite.gz, duckdb (.duckdb.zip), duckdb.gz."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"externalDocs":{"description":"Endpoint documentation on the Tigzig Unified Data Surface page","url":"https://www.tigzig.com/apis/unified#endpoints"}},"get":{"tags":["V1 - Unified Data Surface"],"summary":"Download one Tremor table as a pre-generated file","description":"Available tables (visible-filtered):\n- macro_indicators: long-format time series, ~290 visible indicators\n- stock_prices: daily OHLCV for 16 market symbols\n- indicator_config: data dictionary (display name, source, notes per indicator)\n\nFormats: csv (zip), csv.gz, tsv (zip), tsv.gz, parquet (default), sqlite (.db.zip), sqlite.gz, duckdb (.duckdb.zip), duckdb.gz.\n\nSame files served by V1's /tremor/v1/download/{table_name}.","operationId":"v2_download_table","parameters":[{"name":"table_name","in":"path","required":true,"schema":{"type":"string","description":"One of `macro_indicators`, `stock_prices`, `indicator_config`.","title":"Table Name"},"description":"One of `macro_indicators`, `stock_prices`, `indicator_config`.","examples":{"macro_indicators_parquet":{"summary":"All visible macro indicators as Parquet","value":"macro_indicators"},"stock_prices_sqlite":{"summary":"Daily OHLCV for 16 market symbols as SQLite (properly typed)","value":"stock_prices"},"indicator_config_csv":{"summary":"The data dictionary as CSV.gz","value":"indicator_config"}}},{"name":"format","in":"query","required":false,"schema":{"type":"string","description":"File format. Choose: csv (zip), csv.gz, tsv (zip), tsv.gz, parquet (default), sqlite (.db.zip), sqlite.gz, duckdb (.duckdb.zip), duckdb.gz.","enum":["csv","csv.gz","tsv","tsv.gz","parquet","sqlite","sqlite.gz","duckdb","duckdb.gz"],"default":"parquet","title":"Format"},"description":"File format. Choose: csv (zip), csv.gz, tsv (zip), tsv.gz, parquet (default), sqlite (.db.zip), sqlite.gz, duckdb (.duckdb.zip), duckdb.gz."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"externalDocs":{"description":"Endpoint documentation on the Tigzig Unified Data Surface page","url":"https://www.tigzig.com/apis/unified#endpoints"}}},"/v1/news":{"get":{"tags":["V1 - Unified Data Surface - News"],"summary":"Latest headlines from finance, economy, central bank, India, world and tech feeds, with a relevance score","description":"Headlines from our news feeds (listed at /v1/news/sources), each checked every 2 to 15 minutes (news wires and markets fastest), last 7 days. Each item: source, category, title, url, published_utc, relevance_score (0 to 1: how well it fits a macro and credit analyst; the profile is at /v1/news/sources), via_google_news, and also_from (later copies of the same story). Headlines and links only; snippets=true adds the feed's own summary line. For a briefing use sort=best&min_score=0.8&since=24&limit=30. Items with via_google_news=true carry a news.google.com redirect link that a browser follows and a fetch-only client does not.","operationId":"get_news","parameters":[{"name":"since","in":"query","required":false,"schema":{"type":"integer","maximum":168,"minimum":1,"description":"Hours back, 1 to 168.","default":24,"title":"Since"},"description":"Hours back, 1 to 168."},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma list of categories (see /v1/news/sources).","title":"Category"},"description":"Comma list of categories (see /v1/news/sources).","examples":{"us_markets":{"summary":"US markets headlines","value":"us_markets"}}},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma list of source names, as shown in /v1/news/sources. A name we do not carry is listed back in unknown_sources.","title":"Source"},"description":"Comma list of source names, as shown in /v1/news/sources. A name we do not carry is listed back in unknown_sources."},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Words that must all appear in the headline.","title":"Q"},"description":"Words that must all appear in the headline."},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(latest|best)$","description":"latest = newest first; best = highest relevance score first.","default":"latest","title":"Sort"},"description":"latest = newest first; best = highest relevance score first."},{"name":"min_score","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"description":"Only items with a relevance_score at or above this.","title":"Min Score"},"description":"Only items with a relevance_score at or above this."},{"name":"exclude_google_news","in":"query","required":false,"schema":{"type":"boolean","description":"Drop items fetched through Google News (their url is a news.google.com redirect).","default":false,"title":"Exclude Google News"},"description":"Drop items fetched through Google News (their url is a news.google.com redirect)."},{"name":"snippets","in":"query","required":false,"schema":{"type":"boolean","description":"Add the publisher's own summary line (up to 250 characters) to each item that has one.","default":false,"title":"Snippets"},"description":"Add the publisher's own summary line (up to 250 characters) to each item that has one."},{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$"},{"type":"null"}],"description":"Paging: only items published before this UTC time (use the published_utc of the last item you got).","title":"Before"},"description":"Paging: only items published before this UTC time (use the published_utc of the last item you got)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Items to return, 1 to 500. Default 30.","default":30,"title":"Limit"},"description":"Items to return, 1 to 500. Default 30."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"externalDocs":{"description":"Endpoint documentation on the Tigzig Unified Data Surface page","url":"https://www.tigzig.com/apis/unified#endpoints"}}},"/v1/news/sources":{"get":{"tags":["V1 - Unified Data Surface - News"],"summary":"The feed list with category, status and last fetch time, and the reader profile behind the relevance score","operationId":"news_sources","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"externalDocs":{"description":"Endpoint documentation on the Tigzig Unified Data Surface page","url":"https://www.tigzig.com/apis/unified#endpoints"}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"externalDocs":{"description":"Full Unified Data Surface documentation","url":"https://www.tigzig.com/apis/unified"}}