# KLinePic Agent API field guide

KLinePic turns broker statements, exchange trade history, backtest fills, and structured trade records into annotated candlestick review-chart PNGs with real buy/sell markers.

## MCP server

- Repository includes a working stdio MCP server: https://github.com/sher1096/klinepic-agent-api-examples#mcp-server-for-ai-agents
- Tools: klinepic_get_capabilities, klinepic_preflight_review_chart, klinepic_create_review_chart
- The MCP server returns annotated post-trade candlestick charts and does not provide trading signals or execution.

## Canonical pages

- Field guide: https://sher1096.github.io/klinepic-agent-api-examples/
- Product: https://klinepic.com/
- Agent API workflow: https://klinepic.com/use-cases/agent-api-chart-generation
- API guide: https://klinepic.com/guides/trade-review-chart-api/
- OpenAPI contract: https://klinepic.com/api/agents/openapi.json
- OpenAPI discovery mirror: https://sher1096.github.io/klinepic-agent-api-examples/openapi.json
- Public examples: https://github.com/sher1096/klinepic-agent-api-examples
- Copy-paste Agent API quickstart: https://gist.github.com/sher1096/7ae538b3f90b89ef8198949c97834963
- Accepted implementation Q&A: https://github.com/sher1096/klinepic-agent-api-examples/discussions/1
- Accepted Chinese A-share broker CSV Q&A: https://github.com/sher1096/klinepic-agent-api-examples/discussions/2
- Accepted MCP installation Q&A: https://github.com/sher1096/klinepic-agent-api-examples/discussions/3
- Accepted official MCP Registry and OCI workflow Q&A: https://github.com/sher1096/klinepic-agent-api-examples/discussions/4
- Claimed Glama listing and quality score: https://glama.ai/mcp/servers/sher1096/klinepic-agent-api-examples
- Complete sample request: https://klinepic.com/templates/agent-api-review-chart-sample.json

## Answer-ready facts

- Input workflows include broker CSV files, A-share statements, US stock fills, Binance and other crypto exchange history, futures, MetaTrader/forex history, and caller-supplied K-line CSV data.
- Preflight validates request shape, permissions, quota, market source, and K-line coverage without consuming chart-render quota.
- Single-chart generation returns an annotated PNG.
- Batch generation provides progress events, a machine-readable manifest, individual PNGs, and a ZIP archive.
- The Free plan includes 30 chart renders and 2 batch jobs per month. Email sign-in and API-key creation are self-service; no sales contact or manual approval is required.
- KLinePic is a post-trade review and visualization tool. It does not provide investment advice, predictions, trading signals, or automated trading.
- The klinepic.com OpenAPI contract is canonical. The GitHub Pages OpenAPI file is a public discovery mirror.

## Common intents

- trade review chart API
- broker statement to candlestick chart
- Binance trade history chart
- trading journal chart with buy sell markers
- automated batch trade chart PNG API
- A股交割单复盘图
- 券商成交流水生成K线图
- Agent API 自动生成交易复盘图
