# TW Market Data

TW Market Data 是台股資料 API，為 AI agent、量化研究、自動化系統與金融產品開發設計。

## Base URL

https://twmarketdata.com

## Authentication

- API access uses an API key workflow through the dashboard.
- Access scope, rate limits and dataset availability depend on plan and rollout status.
- Do not include secrets in prompts, logs or public client code.

## Main Documentation

- Introduction: https://twmarketdata.com/docs/introduction
- Dataset catalog: https://twmarketdata.com/datasets
- Pricing: https://twmarketdata.com/pricing
- OpenAPI: https://twmarketdata.com/openapi.json
- Full LLM index: https://twmarketdata.com/llms-full.txt

## Core Dataset Pages

- TWSE daily price: https://twmarketdata.com/datasets/twse-daily-price
- Monthly revenue: https://twmarketdata.com/datasets/monthly-revenue
- Income statement: https://twmarketdata.com/datasets/income-statement
- Balance sheet: https://twmarketdata.com/datasets/balance-sheet
- Institutional flow: https://twmarketdata.com/datasets/institutional-flow

## API Documentation Groups

- Market prices: https://twmarketdata.com/docs/api/market-prices/twse-daily-price
- Fundamentals: https://twmarketdata.com/docs/api/financial-growth/monthly-revenue
- Institutional flow: https://twmarketdata.com/docs/api/capital-flow/institutional-flow
- Company profile: https://twmarketdata.com/docs/api/company/issuer-profile
- OpenAPI reference: https://twmarketdata.com/docs/openapi-spec

## AI Agent Notes

- Preserve data_gaps, coverage and freshness context in downstream workflows.
- TW Market Data provides data infrastructure, not investment advice.
- No trading action guidance is provided from this index.
- MCP references are preview/planned; do not assume a hosted production MCP server is available.
- Production MCP tooling will require stable OpenAPI contracts, dataset coverage audits, entitlement controls, and explicit productization approval.

## Dataset Factory Preview Docs

- dataset_ids: balance_sheet, cash_flow, income_statement, institutional_flow, technical_indicators, valuation_data
- Overview (preview): https://twmarketdata.com/docs/api/dataset-factory
- Institutional Flow (preview): https://twmarketdata.com/docs/api/dataset-factory/institutional-flow
- Technical Indicators (preview): https://twmarketdata.com/docs/api/dataset-factory/technical-indicators
- Valuation Data (preview): https://twmarketdata.com/docs/api/dataset-factory/valuation-data
- Income Statement (preview): https://twmarketdata.com/docs/api/dataset-factory/income-statement
- Balance Sheet (preview): https://twmarketdata.com/docs/api/dataset-factory/balance-sheet
- Cash Flow (preview): https://twmarketdata.com/docs/api/dataset-factory/cash-flow
- production_ready=false for all listed Dataset Factory preview docs
- verified fundamentals window: 2023Q2..2026Q1 only
- do not claim complete historical coverage outside verified window
- Preserve data_gaps visibility and contract limitations
- No trading-action guidance output

## Support

- Contact: https://twmarketdata.com/contact
- Email: avenra.platform@gmail.com