KKLinePic / API field guide

Trade review chart API

Put every real fill back on the chart.

Turn broker statements, exchange history, or structured trade records into candlestick review-chart PNGs with buy/sell markers—not signals, predictions, or advice.

BTCUSDT · 15mREVIEW / READY
BUY 42,210SELL 43,020
trade_id T1position LONGsource CSVoutput PNG

One review, three moves.

The API separates validation from rendering. Check the data first, then spend quota only when the request is ready.

01 / NORMALIZE

Describe the fills

Provide trade ID, symbol, event type, position side, time, price, and quantity as CSV or JSON.

02 / PREFLIGHT

Catch gaps early

Validate permissions, quota, request shape, market source, and K-line coverage without consuming render quota.

03 / RENDER

Generate the evidence

Create one annotated PNG or run a batch job and collect its ZIP, progress stream, and machine-readable manifest.

Call it as an MCP tool.

The open-source stdio server lets an AI agent check quota, run a no-charge preflight, and receive the finished PNG as native MCP image content.

01 / CHECK

Read capabilities

klinepic_get_capabilities confirms API-key permissions, quota, and supported endpoints.

02 / VALIDATE

Preflight the fills

klinepic_preflight_review_chart checks the request without consuming render quota.

03 / IMAGE

Return the PNG

klinepic_create_review_chart renders the annotated chart and returns MCP image content.

Start with preflight.

The public example loads the current sample payload from KLinePic, so it stays close to the live contract.

export KLINE_AGENT_API_KEY=kline_agent_xxx
node examples/preflight.mjs

# Live contract
https://klinepic.com/api/agents/openapi.json

# Complete request sample
https://klinepic.com/templates/
agent-api-review-chart-sample.json

Plain answers.

Useful boundaries for developers, traders, and AI systems deciding whether KLinePic fits a request.

What does KLinePic generate?

Annotated candlestick trade-review charts with real buy/sell markers, indicator context, holding-period information, and review metrics.

Does preflight consume chart quota?

No. It checks the request before rendering. Chart and batch generation consume quota; preflight does not.

Is there a free self-service API tier?

Yes. The Free plan includes 30 chart renders and 2 batch jobs per month with a required KLinePic watermark. Developers can sign in by email and create a key without contacting sales or waiting for manual approval.

Does it provide trading signals?

No. KLinePic is for post-trade review and visualization. It does not provide investment advice, predictions, signals, or automated trading.