数据 API

LinkHash 数据 API

一套简洁的 REST API,提供终端背后的数据:多交易所 OHLCV 价格、服务器计算的技术指标、市场隐含的涨跌预测、各币种的 Polymarket + Kalshi 赔率,以及与加密相关的宏观概率。在下方创建一个免费密钥,两分钟内即可开始获取数据。

1你的 API 密钥

连接你的钱包以创建免费 API 密钥。

没有钱包?任何 Phantom (Solana) 钱包均可——它只是用于发放密钥的身份标识。免费,无需付款。

2快速开始

每个端点都是一个简单的经过认证的 GET 请求,返回 JSON——可在任何语言中使用。在 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 K 线,外加一个跨交易所聚合值(按 K 线时间戳对齐的平均收盘价与中位收盘价)。
参数默认值说明
symbol req—基础资产,例如 BTC、ETH、SOL。
exchangesbinance以逗号分隔的列表,取值自:binance、coinbase、upbit、bithumb、okx、bitget。
interval1hK 线周期:1m、5m、15m、30m、1h、4h、1d、1w(取决于交易所)。
limit200每个交易所的 K 线数量(受你的层级限制)。
{ "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
基于某一交易所 K 线在服务器端计算的技术指标——与终端策略引擎使用的核心算法相同。
参数默认值说明
symbol req—基础资产,例如 BTC、ETH、SOL。
exchangebinance用于计算的单个交易所。
interval1hK 线周期:1m、5m、15m、30m、1h、4h、1d、1w(取决于交易所)。
indicatorsrsi,macd以逗号分隔的列表:sma、ema、wma、rsi、macd、bollinger、momentum、roc、cci、willr、mfi、stochrsi。
lengthper-indicator覆盖单一长度指标的回溯周期长度。
seriesfalse设为 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
终端预测图表按每个短周期渲染的市场隐含涨跌预测。包含概率、隐含方向,以及当前窗口的目标价格。
参数默认值说明
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 之一。省略则返回每个周期。
venueallall、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
与加密相关的宏观预测市场概率——Fed 利率决议、FOMC、CPI、衰退概率及加密政策——来自 Polymarket,并尽力而为提供 Kalshi。
参数默认值说明
venueallall、polymarket 或 kalshi。
limit20每个来源的最大条目数(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 次请求/天;每日配额于 00:00 UTC 重置。更高层级即将推出。
  • 速率限制头: 每个响应都带有 X-RateLimit-Limit / X-RateLimit-Remaining; 返回 429 表示你已达到每日上限。
  • 数据新鲜度: 价格和指标按需根据实时交易所数据源计算;预测和赔率每隔几秒从终端所用的同一快照刷新。
  • CORS: 每个响应都发送 Access-Control-Allow-Origin: *,因此你可以直接从浏览器调用该 API。
  • 安全性: 密钥仅显示一次,且仅以哈希形式存储。可随时通过吊销并创建新密钥来轮换。