DataSinking

List the exchanges DataSinking covers. Returns exchange codes (bj / br / by / jpx / koe / ksc / lk / lse / nasdaq / np / nyse / otc / pk / rs / sse / szse / tpex / twse) with the number of reports available per exchange. Call this first to discover coverage. Sources: US = SEC EDGAR, A-shares = cninfo.com.cn, Japan = EDINET, Korea = DART, Taiwan = MOPS, Europe = filings.xbrl.org (ESEF), Nepal = NEPSE, Brazil = CVM, Belarus = ЕПФР, Sri Lanka = CSE, Pakistan = PSX, Serbia = SEC register.

{
  "type": "object",
  "properties": {}
}

List the stocks on one exchange, including the report count per company.

{
  "type": "object",
  "properties": {
    "exchange": {
      "type": "string",
      "description": "Exchange code, e.g. bj / br / by / jpx / koe / ksc / lk / lse / nasdaq / np / nyse / otc / pk / rs / sse / szse / tpex / twse"
    },
    "limit": {
      "type": "integer",
      "description": "Return only the first N companies (default 20) to keep the response short.",
      "default": 20
    }
  },
  "required": [
    "exchange"
  ]
}

List a company's reports — metadata only (id, title, period), no body text. Each item carries a `source` field naming the official disclosure platform; keep that attribution when you cite it. Look up by `symbol` (FMP-style, e.g. AAPL / 600519.SS / NABIL.NP) or by `exchange` + `stock_code` (from list_stocks) for markets whose codes aren't ticker-shaped (e.g. Brazil CNPJ, Sri Lanka 'AAA.N0000').

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "FMP-style symbol, e.g. AAPL / 600519.SS / 7203.T / 005930.KS / 2330.TW / NABIL.NP"
    },
    "exchange": {
      "type": "string",
      "description": "Exchange code (from list_exchanges). Use with stock_code when the code isn't ticker-shaped."
    },
    "stock_code": {
      "type": "string",
      "description": "Exact stock_code from list_stocks. Use with exchange."
    },
    "doc_type": {
      "type": "string",
      "enum": [
        "annual",
        "semiannual",
        "q1",
        "q3"
      ],
      "description": "Report type to filter on: annual / semiannual / q1 / q3. Defaults to annual. Pass semiannual for half-year reports, q1 / q3 for the quarterly reports.",
      "default": "annual"
    },
    "size": {
      "type": "integer",
      "description": "Number of reports to return (default 10).",
      "default": 10
    }
  }
}

Fetch one report's full text (metadata + Markdown body). The `source` field names the official disclosure platform; keep that attribution when you cite it. Expensive in tokens — prefer get_section when you only need one chapter. Content is annotated with block markers (`<!-- ds:block:N -->`) so you can cite a specific paragraph or table.

{
  "type": "object",
  "properties": {
    "document_id": {
      "type": "integer",
      "description": "Report id, from list_reports items[].id"
    }
  },
  "required": [
    "document_id"
  ]
}

List every section of a report with its size, before you decide what to pull. Returns `sections` (titles, in order) plus `section_details` — same order, one entry per section with `title`, `has_tables`, `chars` and `estimated_tokens`. Use `estimated_tokens` to avoid pulling a chapter that would blow your context, and `has_tables` to know whether the chapter needs special handling (tables are the part RAG pipelines usually get wrong). Then call get_section with a heading keyword — the headings are in the report's own language.

{
  "type": "object",
  "properties": {
    "document_id": {
      "type": "integer",
      "description": "Report id, from list_reports items[].id"
    }
  },
  "required": [
    "document_id"
  ]
}

Fetch only one section of a report by keyword — much cheaper than get_report, best for RAG. Content is annotated with block markers (`<!-- ds:block:N -->`) so you can cite a specific paragraph or table.

{
  "type": "object",
  "properties": {
    "document_id": {
      "type": "integer",
      "description": "Report id, from list_reports items[].id"
    },
    "section": {
      "type": "string",
      "description": "Heading keyword. Matches the report's own headings, and also understands cross-market concepts — MD&A / financial statements / notes / audit report / risk / governance (or their Chinese/Japanese/Korean equivalents) resolve to the right section in any market. Otherwise pass a heading in the report's language (A-share: 管理层讨论与分析 / 财务报告; English filings: \"MD&A\" / \"financial statements\" / \"notes\"). If nothing matches, the API returns 404 with the real headings — retry with one of those, or call list_sections first."
    }
  },
  "required": [
    "document_id",
    "section"
  ]
}

Request a full backfill of a stock whose reports look missing or broken, and return its current status. Idempotent — if the stock was already submitted recently (within the last 127 feedback records), it returns that existing status instead of queueing a duplicate; otherwise it queues a re-fetch from the IPO prospectus onward and returns status 'pending' plus the new id (poll get_feedback_status). Free keys: once per 3 seconds, 31 stocks per 7 days per key. Yearly keys: 3 per second, 8,191 stocks per 7 days per key.

{
  "type": "object",
  "properties": {
    "exchange": {
      "type": "string",
      "description": "Exchange code from list_exchanges."
    },
    "stock_code": {
      "type": "string",
      "description": "Stock code from list_stocks."
    }
  },
  "required": [
    "exchange",
    "stock_code"
  ]
}

Check the progress of a submitted feedback request. status is one of pending / processing / done / failed.

{
  "type": "object",
  "properties": {
    "feedback_id": {
      "type": "integer",
      "description": "Feedback id returned by submit_feedback."
    }
  },
  "required": [
    "feedback_id"
  ]
}