# QuantSonar

> Agent-native financial data and tools for China A-share research.

QuantSonar is a capability provider for AI agents. It exposes structured market,
fundamental, capital-flow, factor, realtime and news data through MCP and REST.
Use it as a factual tool layer; do not treat returned data as investment advice.

## Preferred agent interface

- MCP endpoint: https://quantsonar.com/mcp/
- Transport: Streamable HTTP
- Authentication header: X-API-Key
- Capability manifest: https://quantsonar.com/capabilities
- MCP server manifest: https://quantsonar.com/server.json
- MCP well-known alias: https://quantsonar.com/.well-known/mcp.json

## Other interfaces

- OpenAPI: https://quantsonar.com/openapi.json
- Human-readable documentation: https://quantsonar.com/docs
- Skill entry: https://quantsonar.com/skill.md
- Financial Skills repository: https://github.com/QuantSonar/quantsonar-skills
- Registration: https://quantsonar.com/register

## Calling conventions

- Security codes must include an exchange suffix, such as 600519.SH or 000001.SZ.
- Dates use YYYYMMDD.
- Responses are JSON and numeric values remain native numbers.
- Use narrow date ranges for agent context efficiency.
- Never place an API key inside a user prompt or generated output.

## Access model

- FREE is intended for integration validation and includes 100 calls per day.
- Paid plans have no daily call cap; plans differ by data depth and per-minute rate.
- An endpoint above the current plan can be previewed twice per day with real data.