---
title: "Market Reading — LLM 자연어 판독 (v0.2)"
method: GET
path: "/api/v1/public/reading/{symbol}/{primary_tf}/explain"
tags: ["Public — Market Reading"]
---

# Market Reading — LLM 자연어 판독 (v0.2)

`GET /api/v1/public/reading/{symbol}/{primary_tf}/explain`

## Request

- Base URL: `https://api.decker-ai.com`
- URL: `https://api.decker-ai.com/api/v1/public/reading/{symbol}/{primary_tf}/explain`
- Auth: none declared

reading_view_v0.2 를 LLM (Claude or OpenAI) 에 주입해 Q1-Q4 한국어 자연어 판독 응답 생성. ENV 로 provider 선택. `ENABLE_CLAUDE_READING=true` + `ANTHROPIC_API_KEY` · `OPENAI_API_KEY` · 비활성 시 rule-based fallback. X-API-Key 필수.

## Path parameters

- `symbol` string, required: Symbol, e.g. ETHUSDT
- `primary_tf` string, required: Primary timeframe

## Query parameters

- `include_tfs` string, nullable: Comma-separated additional TFs. Default: 1h,4h,1d
- `provider` string, nullable: LLM provider override: claude | openai | auto (default: ENV)
- `extra` string, nullable: Extra instructions appended to user prompt (optional)

## Headers

- `X-API-Key` string, nullable

## Response `200`

Reading view + LLM narrative returned

- object

## Other responses

- `400`: Invalid symbol or primary_tf
- `401`: Invalid or missing X-API-Key
- `422`: Validation Error
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/decker-ai/apis/decker-public-api.md) · [All operations](https://skmtc.dev/decker-ai/apis/decker-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decker-ai/apis/decker-public-api/revisions/fc19ddf728bf?raw)