데이터 API
LinkHash 데이터 API
터미널을 구동하는 데이터를 하나의 깔끔한 REST API로 제공합니다: 여러 거래소의 OHLCV 가격, 서버에서 계산한 기술 지표, 시장이 반영한 상승/하락 예측, 코인별 Polymarket·Kalshi 배당, 그리고 크립토 관련 거시경제 확률. 아래에서 무료 키를 발급받으면 2분 안에 데이터를 받아볼 수 있습니다.
1내 API 키
무료 API 키를 발급하려면 지갑을 연결하세요.
지갑이 없나요? Phantom(Solana) 지갑이면 됩니다 — 키 발급을 위한 신원 확인일 뿐입니다. 무료이며 결제가 없습니다.
2빠른 시작
모든 엔드포인트는 JSON을 반환하는 인증된 GET 요청입니다 — 어떤 언어에서도 사용할 수 있습니다. 키는 Authorization 헤더(또는 ?api_key= / X-API-Key 헤더)로 전달하세요.
cURL
curl -H "Authorization: Bearer lhx_live_..." \
"https://link-hash.com/api/v1/prices?symbol=BTC&exchanges=binance,okx&interval=1h&limit=100"Python
import requests
BASE = "https://link-hash.com/api/v1"
HEADERS = {"Authorization": "Bearer lhx_live_..."} # your key from link-hash.com/developers
# 1) Multi-exchange candles + cross-exchange aggregate
r = requests.get(f"{BASE}/prices",
params={"symbol": "BTC", "exchanges": "binance,okx",
"interval": "1h", "limit": 100},
headers=HEADERS).json()
print(r["aggregate"][-1]) # {'t':..., 'close_mean':..., 'close_median':..., 'sources':2}
# 2) Technical indicators
r = requests.get(f"{BASE}/indicators",
params={"symbol": "BTC", "interval": "1h",
"indicators": "rsi,macd,bollinger"},
headers=HEADERS).json()
print(r["data"]["indicators"]["rsi"]["latest"]) # e.g. 61.3
# 3) Market-implied up/down prediction (what the prediction chart shows)
r = requests.get(f"{BASE}/prediction",
params={"symbol": "BTC", "cycle": "15m"},
headers=HEADERS).json()
print(r["data"]["cycles"]["15m"]) # {'direction':'up','up_probability':51.5, ...}
# 4) Per-coin Polymarket + Kalshi odds
requests.get(f"{BASE}/odds", params={"symbol": "BTC"}, headers=HEADERS).json()
# 5) Macro probabilities (Fed / CPI / FOMC / recession / crypto policy)
requests.get(f"{BASE}/macro", params={"limit": 10}, headers=HEADERS).json()JavaScript (fetch)
const r = await fetch(
"https://link-hash.com/api/v1/prediction?symbol=ETH&cycle=1h",
{ headers: { Authorization: "Bearer lhx_live_..." } }
);
const { data } = await r.json();
console.log(data.cycles["1h"]); // { direction, up_probability, down_probability, ... }모든 응답 형식은 { "ok": true, "count": N, "data": ... }. 예측/배당 지원 자산: BTC ETH SOL XRP DOGE BNB HYPE ZEC · 가격/지표 거래소: binance coinbase upbit bithumb okx bitget · 주기: 5m 15m 1h 4h.
3엔드포인트
기본 URL https://link-hash.com/api/v1 · 인증 헤더 Authorization: Bearer <key>.
GET/prices
하나의 자산에 대해 하나 이상의 거래소에서 OHLCV 캔들을 제공하며, 캔들 타임스탬프 기준으로 정렬된 거래소 간 집계(종가 평균·중앙값)도 함께 반환합니다.
| 파라미터 | 기본값 | 설명 |
|---|---|---|
| symbol req | — | 기준 자산 (예: BTC, ETH, SOL). |
| exchanges | binance | 쉼표로 구분된 목록: binance, coinbase, upbit, bithumb, okx, bitget. |
| interval | 1h | 캔들 크기: 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w (거래소에 따라 다름). |
| limit | 200 | 거래소별 캔들 개수 (등급 한도 내로 제한됨). |
{ "ok": true, "symbol": "BTC", "interval": "1h",
"exchanges": ["binance","okx"],
"aggregate": [ { "t": 1791183600, "close_mean": 86257.1, "close_median": 86257.1, "sources": 2 } ],
"data": [ { "exchange": "binance", "count": 100,
"candles": [ { "t": 1791183600, "o": 86200, "h": 86400, "l": 86100, "c": 86257, "v": 512.3 } ] } ] }GET/indicators
한 거래소의 캔들로 서버에서 계산한 기술 지표 — 터미널 전략 엔진이 사용하는 것과 동일한 계산식입니다.
| 파라미터 | 기본값 | 설명 |
|---|---|---|
| symbol req | — | 기준 자산 (예: BTC, ETH, SOL). |
| exchange | binance | 계산에 사용할 단일 거래소. |
| interval | 1h | 캔들 크기: 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w (거래소에 따라 다름). |
| indicators | rsi,macd | 다음 중 쉼표 구분: sma, ema, wma, rsi, macd, bollinger, momentum, roc, cci, willr, mfi, stochrsi. |
| length | per-indicator | 단일 길이 지표의 룩백 길이를 재정의합니다. |
| series | false | true이면 전체 [t, value] 시리즈를 반환하고, 그렇지 않으면 최신 값만 반환합니다. |
{ "ok": true, "data": { "symbol": "BTC", "exchange": "binance", "interval": "1h", "as_of": 1791183600,
"indicators": {
"rsi": { "length": 14, "latest": 61.3 },
"macd": { "length": 20, "latest": { "line": 6.79, "signal": 6.50, "hist": 0.29 } },
"bollinger": { "length": 20, "latest": { "mid": 85900, "up": 86900, "lo": 84900 } } } } }GET/prediction
터미널 예측 차트가 표시하는, 시장이 반영한 상승/하락 예측을 짧은 주기별로 제공합니다. 확률, 예측 방향, 현재 구간의 기준 가격(price-to-beat)을 포함합니다.
| 파라미터 | 기본값 | 설명 |
|---|---|---|
| symbol req | — | 지원 자산: BTC ETH SOL XRP DOGE BNB HYPE ZEC. |
| cycle | 전체 | 5m, 15m, 1h, 4h 중 하나. 생략하면 모든 주기를 반환합니다. |
{ "ok": true, "data": { "symbol": "BTC", "price": 86212.5, "as_of": "2026-10-05T07:05:30+00:00",
"cycles": {
"15m": { "direction": "up", "up_probability": 51.5, "down_probability": 48.5,
"price_to_beat": 86233.6, "ends_at": "2026-10-05T07:15:00Z", "source": "polymarket" } } } }GET/odds
코인별 상승/하락 예측시장 배당 원본입니다. Polymarket 배당은 지원 자산에 대해 항상 제공되며, Kalshi 배당은 가능할 때만(매칭 시장이 활성화되어 있고 Kalshi 접근이 설정된 경우) 반환됩니다.
| 파라미터 | 기본값 | 설명 |
|---|---|---|
| symbol req | — | 기준 자산 (예: BTC, ETH, SOL). |
| cycle | 전체 | 5m, 15m, 1h, 4h 중 하나. 생략하면 모든 주기를 반환합니다. |
| venue | all | all, polymarket, 또는 kalshi. |
{ "ok": true, "symbol": "BTC", "kalshi_available": false, "data": {
"polymarket": [ { "cycle": "5m", "up_pct": 35.5, "down_pct": 64.5, "volume_24h": 456.8,
"title": "Bitcoin Up or Down ...", "ends_at": "2026-10-05T07:10:00Z",
"url": "https://polymarket.com/event/..." } ],
"kalshi": [] } }GET/macro
크립토 관련 거시경제 예측시장 확률 — 연준 금리 결정, FOMC, CPI, 경기침체 확률, 크립토 정책 — 을 Polymarket에서 제공하며 Kalshi는 가능할 때 함께 제공합니다.
| 파라미터 | 기본값 | 설명 |
|---|---|---|
| venue | all | all, polymarket, 또는 kalshi. |
| limit | 20 | 거래소별 최대 항목 수 (1–50). |
{ "ok": true, "venue": "all", "data": {
"polymarket": [ { "question": "Will there be no change in Fed interest rates ...",
"yes_pct": 83.5, "ends_at": "2026-10-29T03:59:00Z",
"volume_24h": 50877.0, "volume_total": 7265538.6,
"url": "https://polymarket.com/event/..." } ],
"kalshi": [] } }GET/usage GET/status
/usage는 키의 등급과 남은 일일 할당량을 반환합니다. /status는 서비스 상태와 데이터 소스 목록을 반환합니다. 둘 다 키가 필요합니다.
4제한 및 참고 사항
- 무료 등급: 최대 5000 요청/일; 일일 할당량은 UTC 00:00에 초기화됩니다. 상위 등급은 준비 중입니다.
- 레이트리밋 헤더: 모든 응답에 포함됩니다 X-RateLimit-Limit / X-RateLimit-Remaining; 429는 일일 한도에 도달했음을 의미합니다.
- 최신성: 가격과 지표는 실시간 거래소 피드로부터 요청 시 계산되며, 예측과 배당은 터미널이 사용하는 동일한 스냅샷에서 수 초마다 갱신됩니다.
- CORS: 모든 응답은 Access-Control-Allow-Origin: * 를 전송하므로 브라우저에서 직접 API를 호출할 수 있습니다.
- 보안: 키는 한 번만 표시되고 해시로만 저장됩니다. 기존 키를 폐기하고 새로 생성해 언제든 교체할 수 있습니다.