FinData4AI

API Reference

Market-aware FinData4AI Data API reference for financial agents.

Company

公司资料、交易所、行业、标识符和估值快照。

Market bars

股票历史 OHLCV 行情。

Financials

标准化利润表、资产负债表、现金流量表和分部财务。

Filings

SEC 文件；港股与 A 股交易所公告按预览 / 路线图逐步补齐。

Ownership

内部人、机构持仓和市场特定资金信号。

News

公司归因新闻与跨市场新闻。

Showing endpoints: 9

GET/market/barsMarket data

Historical OHLCV bars

OHLCV and quote data with market-specific symbol examples.

US: AvailableHK: AvailableA-shares: AvailableCrypto: Planned

Try this endpoint

Preview only. Real calls should run server-side with X-API-Key.

A-shares

Request URL

https://api.findata4ai.com/market/bars?market=CN&ticker=600519&from=2026-08-01&to=2026-08-14&interval=1d
curl+
curl "https://api.findata4ai.com/market/bars?market=CN&ticker=600519&from=2026-08-01&to=2026-08-14&interval=1d" \
  -H "X-API-Key: fd4a_..."
fetch+
const response = await fetch("https://api.findata4ai.com/market/bars?market=CN&ticker=600519&from=2026-08-01&to=2026-08-14&interval=1d", {
  headers: { "X-API-Key": process.env.FINDATA4AI_API_KEY }
});
const data = await response.json();
Preview response+
{
  "requestId": "req_preview_01",
  "endpoint": "/market/bars",
  "market": "cn",
  "ticker": "600519",
  "credits": 1,
  "data": [
    {
      "date": "2026-08-13",
      "open": 101.2,
      "high": 103.4,
      "low": 100.8,
      "close": 102.7,
      "volume": 1842200
    },
    {
      "date": "2026-08-14",
      "open": 102.7,
      "high": 104.1,
      "low": 101.9,
      "close": 103.8,
      "volume": 2198600
    }
  ],
  "meta": {
    "partial": false,
    "generatedAt": "2026-08-15T00:00:00Z"
  }
}

Agent use

Retrieve compact price context before writing market summaries or alerts.

GET/company/factsCompany data

Company facts

Company profile, exchange, sector, market cap, listing date, and key identifiers.

US: AvailableHK: AvailableA-shares: AvailableCrypto: N/A

Try this endpoint

Preview only. Real calls should run server-side with X-API-Key.

A-shares

Request URL

https://api.findata4ai.com/company/facts?market=CN&ticker=600519
curl+
curl "https://api.findata4ai.com/company/facts?market=CN&ticker=600519" \
  -H "X-API-Key: fd4a_..."
fetch+
const response = await fetch("https://api.findata4ai.com/company/facts?market=CN&ticker=600519", {
  headers: { "X-API-Key": process.env.FINDATA4AI_API_KEY }
});
const data = await response.json();
Preview response+
{
  "requestId": "req_preview_01",
  "endpoint": "/company/facts",
  "market": "cn",
  "ticker": "600519",
  "credits": 1,
  "data": {
    "name": "600519 Holdings",
    "exchange": "CN",
    "sector": "Consumer / Technology",
    "marketCap": 128400000000
  },
  "meta": {
    "partial": false,
    "generatedAt": "2026-08-15T00:00:00Z"
  }
}

Agent use

Ground company names, exchanges, and identifiers before calling deeper endpoints.

GET/financials/income-statementsFinancials

Income statements

Normalized revenue, gross profit, operating income, net income, EPS, and margins.

US: AvailableHK: AvailableA-shares: AvailableCrypto: N/A

Try this endpoint

Preview only. Real calls should run server-side with X-API-Key.

A-shares

Request URL

https://api.findata4ai.com/financials/income-statements?market=CN&ticker=600519&period=annual
curl+
curl "https://api.findata4ai.com/financials/income-statements?market=CN&ticker=600519&period=annual" \
  -H "X-API-Key: fd4a_..."
fetch+
const response = await fetch("https://api.findata4ai.com/financials/income-statements?market=CN&ticker=600519&period=annual", {
  headers: { "X-API-Key": process.env.FINDATA4AI_API_KEY }
});
const data = await response.json();
Preview response+
{
  "requestId": "req_preview_01",
  "endpoint": "/financials/income-statements",
  "market": "cn",
  "ticker": "600519",
  "credits": 1,
  "data": {
    "fiscalYear": 2025,
    "revenue": 58420000000,
    "grossMargin": 0.61,
    "operatingIncome": 18420000000,
    "netIncome": 13240000000
  },
  "meta": {
    "partial": false,
    "generatedAt": "2026-08-15T00:00:00Z"
  }
}

Agent use

Compare growth, margin changes, and reporting trends with consistent fields.

GET/financials/balance-sheetsFinancials

Balance sheets

Assets, liabilities, debt, equity, cash, and working capital fields.

US: AvailableHK: AvailableA-shares: AvailableCrypto: N/A

Try this endpoint

Preview only. Real calls should run server-side with X-API-Key.

A-shares

Request URL

https://api.findata4ai.com/financials/balance-sheets?market=CN&ticker=000001&period=annual
curl+
curl "https://api.findata4ai.com/financials/balance-sheets?market=CN&ticker=000001&period=annual" \
  -H "X-API-Key: fd4a_..."
fetch+
const response = await fetch("https://api.findata4ai.com/financials/balance-sheets?market=CN&ticker=000001&period=annual", {
  headers: { "X-API-Key": process.env.FINDATA4AI_API_KEY }
});
const data = await response.json();
Preview response+
{
  "requestId": "req_preview_01",
  "endpoint": "/financials/balance-sheets",
  "market": "cn",
  "ticker": "000001",
  "credits": 1,
  "data": {
    "fiscalYear": 2025,
    "totalAssets": 91200000000,
    "totalLiabilities": 38400000000,
    "cashAndEquivalents": 14200000000
  },
  "meta": {
    "partial": false,
    "generatedAt": "2026-08-15T00:00:00Z"
  }
}

Agent use

Check balance-sheet risk before summarizing company quality or leverage.

GET/financials/cash-flow-statementsFinancials

Cash flow statements

Operating, investing, financing cash flow, capex, and free cash flow.

US: AvailableHK: AvailableA-shares: AvailableCrypto: N/A

Try this endpoint

Preview only. Real calls should run server-side with X-API-Key.

A-shares

Request URL

https://api.findata4ai.com/financials/cash-flow-statements?market=CN&ticker=300750&period=annual
curl+
curl "https://api.findata4ai.com/financials/cash-flow-statements?market=CN&ticker=300750&period=annual" \
  -H "X-API-Key: fd4a_..."
fetch+
const response = await fetch("https://api.findata4ai.com/financials/cash-flow-statements?market=CN&ticker=300750&period=annual", {
  headers: { "X-API-Key": process.env.FINDATA4AI_API_KEY }
});
const data = await response.json();
Preview response+
{
  "requestId": "req_preview_01",
  "endpoint": "/financials/cash-flow-statements",
  "market": "cn",
  "ticker": "300750",
  "credits": 1,
  "data": {
    "fiscalYear": 2025,
    "operatingCashFlow": 16400000000,
    "capex": -3200000000,
    "freeCashFlow": 13200000000
  },
  "meta": {
    "partial": false,
    "generatedAt": "2026-08-15T00:00:00Z"
  }
}

Agent use

Give agents cash conversion and free-cash-flow context without raw filings.

GET/filings/secFilings

SEC filings

10-K, 10-Q, 8-K, and related source links for US public companies.

US: AvailableHK: N/AA-shares: N/ACrypto: N/A

Try this endpoint

Preview only. Real calls should run server-side with X-API-Key.

US

Request URL

https://api.findata4ai.com/filings/sec?market=US&ticker=NVDA&form_type=10-K
curl+
curl "https://api.findata4ai.com/filings/sec?market=US&ticker=NVDA&form_type=10-K" \
  -H "X-API-Key: fd4a_..."
fetch+
const response = await fetch("https://api.findata4ai.com/filings/sec?market=US&ticker=NVDA&form_type=10-K", {
  headers: { "X-API-Key": process.env.FINDATA4AI_API_KEY }
});
const data = await response.json();
Preview response+
{
  "requestId": "req_preview_01",
  "endpoint": "/filings/sec",
  "market": "us",
  "ticker": "NVDA",
  "credits": 1,
  "data": [
    {
      "formType": "10-K",
      "filedAt": "2026-02-26",
      "accessionNumber": "preview-0001",
      "sourceUrl": "https://sec.gov/..."
    }
  ],
  "meta": {
    "partial": false,
    "generatedAt": "2026-08-15T00:00:00Z"
  }
}

Agent use

Extract risk factors, management discussion, and source-backed filing context.

GET/company/announcementsFilings

Company announcements

Exchange announcements, company disclosures, and normalized press-release coverage.

US: PartialHK: AvailableA-shares: AvailableCrypto: N/A

Try this endpoint

Preview only. Real calls should run server-side with X-API-Key.

A-shares

Request URL

https://api.findata4ai.com/company/announcements?market=CN&ticker=600519
curl+
curl "https://api.findata4ai.com/company/announcements?market=CN&ticker=600519" \
  -H "X-API-Key: fd4a_..."
fetch+
const response = await fetch("https://api.findata4ai.com/company/announcements?market=CN&ticker=600519", {
  headers: { "X-API-Key": process.env.FINDATA4AI_API_KEY }
});
const data = await response.json();
Preview response+
{
  "requestId": "req_preview_01",
  "endpoint": "/company/announcements",
  "market": "cn",
  "ticker": "600519",
  "credits": 1,
  "data": [
    {
      "title": "Quarterly results announcement",
      "publishedAt": "2026-08-14T09:30:00Z",
      "source": "exchange"
    }
  ],
  "meta": {
    "partial": false,
    "generatedAt": "2026-08-15T00:00:00Z"
  }
}

Agent use

Help agents cite local-market disclosures instead of relying on scraped summaries.

GET/ownership/institutional-holdingsOwnership

Institutional holdings

Institutional holder signals with market filters and report-period context.

US: AvailableHK: AvailableA-shares: AvailableCrypto: N/A

Try this endpoint

Preview only. Real calls should run server-side with X-API-Key.

A-shares

Request URL

https://api.findata4ai.com/ownership/institutional-holdings?market=CN&ticker=600519
curl+
curl "https://api.findata4ai.com/ownership/institutional-holdings?market=CN&ticker=600519" \
  -H "X-API-Key: fd4a_..."
fetch+
const response = await fetch("https://api.findata4ai.com/ownership/institutional-holdings?market=CN&ticker=600519", {
  headers: { "X-API-Key": process.env.FINDATA4AI_API_KEY }
});
const data = await response.json();
Preview response+
{
  "requestId": "req_preview_01",
  "endpoint": "/ownership/institutional-holdings",
  "market": "cn",
  "ticker": "600519",
  "credits": 1,
  "data": [
    {
      "holder": "Institutional holder preview",
      "shares": 18420000,
      "percentOfFloat": 0.032
    }
  ],
  "meta": {
    "partial": false,
    "generatedAt": "2026-08-15T00:00:00Z"
  }
}

Agent use

Add holder, insider, or capital-flow evidence to investment workflows.

GET/newsNews

Market and company news

Company-attributed and market news across supported markets.

US: AvailableHK: AvailableA-shares: AvailableCrypto: Planned

Try this endpoint

Preview only. Real calls should run server-side with X-API-Key.

A-shares

Request URL

https://api.findata4ai.com/news?market=CN&ticker=600519
curl+
curl "https://api.findata4ai.com/news?market=CN&ticker=600519" \
  -H "X-API-Key: fd4a_..."
fetch+
const response = await fetch("https://api.findata4ai.com/news?market=CN&ticker=600519", {
  headers: { "X-API-Key": process.env.FINDATA4AI_API_KEY }
});
const data = await response.json();
Preview response+
{
  "requestId": "req_preview_01",
  "endpoint": "/news",
  "market": "cn",
  "ticker": "600519",
  "credits": 1,
  "data": [
    {
      "headline": "Market update preview",
      "publishedAt": "2026-08-14T12:00:00Z",
      "source": "licensed-news"
    }
  ],
  "meta": {
    "partial": false,
    "generatedAt": "2026-08-15T00:00:00Z"
  }
}

Agent use

Give monitoring agents fresh context for alerts and summaries.

Quickstart

Validate the first financial-agent workflow with sourced financial context.

Company

Next Page