KKLinePic

Trade review chart API

Let external agents generate review-chart PNGs and batch ZIP exports.

The KLinePic Agent API is for automated trading journals, research agents, and strategy tools that need repeatable K-line review charts from structured trade records.

Free tier: 150 chart renders and 20 batch jobs per month with a required KLinePic watermark. Preflight does not consume render quota, and no payment is required to start.

Real KLinePic candlestick review chart with market candles, indicators, and trade markers
Real market K-line output. The phone layout switches to the 1080×1920 mobile share format.

Get an API key

  1. Open the self-service Agent API page and sign in by email.
  2. Choose the smallest scopes needed: single-chart rendering, batch creation, or batch reads.
  3. Create the key and copy the full kline_agent_... secret when it appears. The full secret is shown only once.
  4. Call /api/agents/me or preflight to verify the key without consuming render quota.

No sales contact or manual approval is required for the Free plan.

API surfaces

preflight

Validate payload shape, entitlement, quota, market source, and render readiness before spending a chart generation call.

review-chart

Generate one trade review PNG from structured trades and market K-line data.

review-batch

Create a batch job for many trade groups and download a ZIP when the job finishes.

Minimal request shape

Agents can send trade CSV plus K-line CSV for deterministic rendering from their own data source. The shortened shape below shows the main fields; use the complete runnable sample for preflight or rendering.

{
  "kind": "review-chart",
  "requestId": "agent-demo-btcusdt-001",
  "chart": {
    "tradesText": "trade_id,symbol,event_type,position_side,time,price,quantity\nT1,BTCUSDT,buy,long,2024-01-02T12:00:00.000Z,42210,0.2\nT1,BTCUSDT,sell,long,2024-01-02T14:30:00.000Z,43020,0.2",
    "tradesFormat": "csv",
    "symbol": "BTCUSDT",
    "market": "crypto",
    "period": "15m",
    "source": "csv",
    "klineCsv": "symbol,time,open,high,low,close,volume\nBTCUSDT,2024-01-02T12:00:00.000Z,42180,42600,42140,42490,156"
  }
}

For Chinese search intent: 这个页面对应“自动生成交易复盘图 API”“Agent API 出图”“批量交易复盘图 ZIP”等具体需求。

For multilingual Agent/API search intent, this page also covers 取引履歴チャート API, 自動チャート生成 API, 一括チャート出力, 거래 복기 차트 API, 자동 차트 생성 API, and 일괄 차트 내보내기.

Integration checklist

  1. Read the OpenAPI contract and choose single-chart or batch output.
  2. Start from the quota-safe Postman collection, the public GitHub examples, the open-source MCP server, or the complete sample JSON instead of rebuilding the payload from memory.
  3. Use a stable requestId for traceability and a stable trade_id for each complete trade.
  4. Call preflight before production rendering when user payloads may be incomplete.
  5. Keep generated PNGs and ZIP archives attached to your own trading journal, report, or research run.

FAQ

Can an external agent generate a trade review PNG?

Yes. An agent can validate a payload with preflight, call review-chart for one PNG, or call review-batch for a batch job and ZIP export.

Is there a free Agent API tier?

Yes. The Free plan includes 150 chart renders and 20 batch jobs per month with a required KLinePic watermark. Preflight does not consume render quota.

How do I get an Agent API key?

Open the self-service Agent API page, sign in by email, choose the required scopes, and create a key. No sales contact or manual approval is required for the Free plan.