API 快速入门

额度价格：$0.001（注册赠送 1000 免费额度）。基础 URL https://api.marketapi.app/v1。请在 Authorization 请求头中发送密钥。URL 中的密钥会被拒绝。

curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/prices/latest?symbols=EURUSD,XAUUSD&require_live=true"
curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/bars?symbol=EURUSD&timeframe=M1&from=2026-09-01T00:00:00Z&to=2026-09-02T00:00:00Z"
curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/symbols/EURUSD"

EURUSD 和 XAUUSD 只是示例：请换成您需要的代码，写法与价格列表（按市场分组：外汇、金属、指数、股票、能源、加密货币，可搜索）或代码列表（CSV）中完全一致。多个代码用逗号分隔。

两款产品，一个 API 密钥。下方的市场价格 API 为应用、机器人和仪表盘提供价格。链上价格预言机以签名报告的形式提供相同价格，供智能合约在链上验证。

端点

K 线可回溯多远： M1 7 days · M2–M6 30 days · M10–M30 3 months · H1 12 months · H2–H12 3 years · D1–MN1 5 years （以该市场自身历史所及为限）。

链上价格预言机（用于智能合约）

在智能合约中使用同样的外汇、黄金、指数和股票价格，用于 DeFi 借贷、代币化资产（RWA）、链上外汇、稳定币支付和合成资产。您的应用获取已签名的价格报告；您的合约将其交给我们的验证合约，在链上校验签名。价格在传输中无法被伪造，也无需信任传递者。

1. 使用您的 API 密钥获取报告：

   curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/oracle/report?symbols=XAUUSD&chain_id=10"

2. 在您的交易中将其 report 和 signature 提交给验证合约的 submit()。
3. 用 getPriceNoOlderThan(feedId, maxAge) 读取已验证的价格。它只返回比 maxAge 更新的实时价格（市场 OPEN）。

每份报告都注明市场状态（OPEN、CLOSED、HALTED）和买卖价差，并在签名后约一分钟过期。数据源有固定 ID（keccak256("XAUUSD")），熔断机制会拦截异常跳变，并提供兼容 Chainlink 的适配器（latestRoundData）。我们的中继器已存储在链上的价格可免费读取。

预言机文档 数据源、网络和合约

免费版（无需密钥）

无需账户即可试用 API：每个 IP 地址每分钟 10 次请求、每天 1000 次，每次请求最多 5 个代码。

curl "https://api.marketapi.app/v1/free/prices/latest?symbols=EURUSD"
curl "https://api.marketapi.app/v1/free/symbols"
curl "https://api.marketapi.app/v1/free/market-status?symbols=EURUSD"

需要更多？创建账户，用您自己的 API 密钥获得完整访问。

价格状态

每个价格都带有一个 status，它只说明一件事：价格有多新。

添加 require_live=true 可只接收 LIVE 价格；被排除的代码不计费。每个请求的代码只会出现在一个列表中：data（有价格）、no_data（已知代码，暂无价格）或 unknown（未提供）。

交易时间。外汇、金属和大多数指数从周日晚间交易至周五晚间（UTC）。股票和 ETF 差价合约按其交易所当地时间的常规时段交易，并遵循夏令时：纽约 09:30–16:00，伦敦 08:00–16:30，法兰克福和巴黎 09:00–17:30。交易所假日（NYSE、LSE、Xetra、Euronext）视为休市。在这些时间之外，价格为 MARKET_CLOSED，而非 STALE；如果来源仍在报价（例如开盘前），价格为 LIVE。

品种规格

GET /v1/symbols/{symbol} 返回来源提供的完整品种规格，包括货币、合约大小、最小变动单位和交易量限制，以及交易时段。GET /v1/symbols/{symbol}/properties/history 列出其每次变更。代码列表（CSV）包含主要规格字段。

安全重试

发送 Idempotency-Key 请求头可确保重试安全：24 小时内用相同键重复请求，会原样返回第一次的响应，且不扣费（响应不超过 2 MB）。需要最新数据时请使用新键；响应已不再保存的键会收到 409 idempotency_key_used。

实时价格（交易机器人、仪表盘）

获取最新价格的两种方式。两者提供相同的报价；按您程序的工作方式选择。

价格有多新？

您正在流式订阅的代码，或在过去 5 分钟内通过 /prices/latest 请求过的代码，会约每秒从数据源刷新一次（所有客户合计同时最多 个此类代码）。其他代码会在后台持续刷新，但频率较低。所以：请求或订阅您交易的代码，它们就会变快。

每条报价都带有 time（来源生成报价的时刻，UTC）和 status。交易程序应始终检查两者：

• 在 REST 调用中使用 require_live=true：只返回 LIVE 价格（其他价格单独列出且不计费）。
• 将 time 与您的时钟比较，忽略比策略可容忍范围更旧的报价。市场可能很平静：价格在一段时间内不变是正常的。

REST 示例

curl -H "Authorization: Bearer $API_KEY" \
  "https://api.marketapi.app/v1/prices/latest?symbols=EURUSD,XAUUSD&require_live=true"

{"data": [{"symbol": "EURUSD", "bid": "1.12946", "ask": "1.12967", "last": null,
           "time": "2026-10-02T09:15:42.381Z", "status": "LIVE"}],
 "not_live": [], "unknown": [], "no_data": []}

轮询频率高于每秒一次没有任何好处：活跃代码的数据源就是每秒读取一次。

WebSocket 协议

使用请求头 Authorization: Bearer <your key>（权限 read:latest）连接 /stream，然后发送 JSON 消息：

> {"action": "subscribe",   "symbols": ["EURUSD", "XAUUSD"]}
< {"type": "subscribed", "symbols": ["EURUSD", "XAUUSD"], "rejected": []}
< {"type": "quote", "symbol": "EURUSD", "bid": "1.12946", "ask": "1.12967", "last": null,
   "time": "2026-10-02T09:15:42.381Z", "status": "LIVE"}
> {"action": "unsubscribe", "symbols": ["XAUUSD"]}
< {"type": "error", "code": "...", "detail": "..."}

限制：每个连接最多 50 个代码。关闭代码：4401 密钥无效，4402 余额用完（充值后重新连接），4429 打开的连接过多。服务器每 20 秒发送一次 ping；大多数 WebSocket 库会自动响应。

Python 示例（pip install "websockets>=14"）

import asyncio, json, os, websockets

async def main():
    url = "/stream"
    headers = {"Authorization": "Bearer " + os.environ["API_KEY"]}
    while True:                                   # reconnect with backoff
        try:
            async with websockets.connect(url, additional_headers=headers) as ws:
                await ws.send(json.dumps({"action": "subscribe", "symbols": ["EURUSD"]}))
                async for raw in ws:
                    msg = json.loads(raw)
                    if msg["type"] == "quote" and msg["status"] == "LIVE":
                        print(msg["symbol"], msg["bid"], msg["ask"], msg["time"])
        except websockets.ConnectionClosed as e:
            if e.code in (4401, 4402):            # wrong key / no balance: retrying will not help
                raise
        await asyncio.sleep(5)

asyncio.run(main())

Node.js 示例（npm install ws）

const WebSocket = require("ws");
const ws = new WebSocket("/stream", { headers: { Authorization: "Bearer " + process.env.API_KEY } });
ws.on("open", () => ws.send(JSON.stringify({ action: "subscribe", symbols: ["EURUSD"] })));
ws.on("message", (raw) => {
  const m = JSON.parse(raw);
  if (m.type === "quote" && m.status === "LIVE") console.log(m.symbol, m.bid, m.ask, m.time);
});
ws.on("close", (code) => console.log("closed", code));   // reconnect after a few seconds unless 4401/4402

请将 API 密钥保存在您的服务器或机器人中。切勿放入他人可打开的网页或应用中：任何持有密钥的人都能花掉您的余额。

须知

• 价格为数据源自身的买价和卖价；/symbols 中的 price_basis 说明 K 线基于哪种价格构建。这些是参考性市场数据，不是交易执行场所：您的订单按您自己券商的价格成交。
• 时间始终为 UTC。小数以字符串形式提供，保留品种自身精度，不会因取整而丢失信息。
• 历史数据（K 线和逐笔）请参见上方端点；实时和历史数据使用相同的代码和密钥。

图表、指标、画线工具和价格提醒（网站）

每个代码都有免费的交互式图表，地址为 /price/<ticker>，例如 /price/EURUSD。这些是网站功能：不消耗 API 额度，只有保存分析和设置提醒才需要账户。

刚接触图表？用通俗语言学习每个指标和画线工具：原理、公式、用法和示例。

自选列表、对比、多图表和筛选器（网站）

交易观点、个人主页与关注（网站）

手机应用（iPhone 和 Android）

用您的账户登录，即可使用带实时价格的自选列表、完整图表（所有指标、画线工具和形态向导，以及您保存的分析）、手机通知形式的价格提醒（在提醒中勾选 push；在应用的“账户”中开启通知）以及社区观点。双因素登录与网站相同。您登录过的每台手机都列在账户中，可在那里退出登录；修改密码会让所有手机退出登录。套餐和充值在本网站管理。您可以在应用中或此处的“账户”中删除账户。

邀请好友（推荐）

在控制台 → 邀请好友中可以找到您的专属链接（/r/your-code；加上 ?next=/premium 或本站任意页面即可将人引导到那里）。打开链接并在 30 天内创建账户的人会与您关联。在其注册后的 12 个月内，对方每次付费充值（主流网络上的加密货币或银行卡，至少 $5）都会为您带来 20% 返现。返现会等待 14 天以防退款，之后计入您的余额：可用于 API 额度、套餐或 Chart Premium。 您也可以提现（稳定币或 PayPal），最低 $50，需邮件确认并经我们团队审核。 邀请自己或自己的第二个账户不计入，且每位邀请人每月有上限。

合作伙伴计划（券商和培训者）

企业可为客户提供 Chart Premium：在 控制台 → 合作伙伴 申请；获批后您将获得合作伙伴 ID 和 5 个免费试用席位（每个 14 天 Pro）。席位按套餐（10, 50, 250）以 30% 折扣从余额购买，可选 Pro 或 Pro+，每个 1、3、6 或 12 个月。每个席位会成为一次性激活码，可在合作伙伴页面或通过合作伙伴 API 生成，并可附上您自己的客户编号（以掩码方式保存）。未使用的码可取消并退回席位。客户在 Premium 页面输入兑换码。

形态向导（网站）

图表上的 ✦ 向导会扫描当前周期的 K 线并列出发现结果，附上每个结果通过的规则、建议交易，以及可在图表上显示或保留为您自己画线的图形。这是对历史价格的自动分析，不构成投资建议。如何解读结果、历史表现、置信区间和显著性：形态向导指南。

Chart Premium（网站）

图表免费。Chart Premium 可在 1、3、6 或 12 个月内提供更多重型工具，从与 API 相同的预付余额中支付（周期越长，每月越便宜）。

策略测试器（网站）

图表上的策略会在当前周期的历史 K 线上测试交易策略，并在图表上显示每笔交易、盈利、回撤、胜率以及与买入持有对比的资金曲线。选择内置策略并修改参数，或用 JavaScript 编写您自己的策略。登录后可在多达 20,000 根 K 线上测试，并保存最多 50 个策略。您的脚本只在浏览器中运行，处于无法访问互联网、您的账户或本网站的沙箱内。

完整的回测控制台指南讲解每项设置和结果、完整的脚本参考（包括代码中全部 71 个指标）以及 11 个可直接运行的示例。

const len = input("Average period", 50, { min: 2, max: 500 });
const avg = ta.sma(close, len);
plot(avg, "SMA " + len, "#2F80ED");

function onBar(i) {
  if (avg[i] == null) return;                       // still warming up
  if (position <= 0 && close[i] > avg[i]) long({ slPct: 2 });
  if (position >= 0 && close[i] < avg[i]) short({ slPct: 2 });
}

分享分析与俱乐部

通过链接分享一个分析，或在俱乐部中协作：一个带聊天和图表分析书架的共享工作区。

提醒发送到：电子邮件、Telegram、手机、浏览器和 webhook

# Python: check that a webhook really comes from us (Flask example)
import hashlib, hmac, time
from flask import Flask, request, abort
SECRET = b"your-webhook-secret"
app = Flask(__name__)

@app.post("/alerts")
def alerts():
    ts = request.headers.get("X-Alert-Timestamp", "")
    sig = request.headers.get("X-Alert-Signature", "").removeprefix("sha256=")
    good = hmac.new(SECRET, ts.encode() + b"." + request.get_data(), hashlib.sha256).hexdigest()
    if not hmac.compare_digest(sig, good) or abs(time.time() - int(ts or 0)) > 300:
        abort(401)
    alert = request.get_json()
    print(alert)            # your trading bot, Slack, a spreadsheet…
    return "ok"

限制与错误（价格 API）

您的账户：API 密钥、安全与团队

额度、充值与套餐

任务

重型任务（形态扫描、大批量兑换码、长报告）会在公平队列中等待，而不会拖慢网站。控制台 → 任务会显示每个任务的排队位置和预计时间；您可以离开页面，完成后会在控制台通知您（耗时长的还会发邮件）。失败的任务会自动重试，绝不会悄无声息地消失。

帮助与支持

• 支持工单：从控制台给我们写信（可附截图）；回复会通过电子邮件和工单送达。
• 问 AI（右下角的聊天按钮）随时解答有关平台的问题。
• 学习讲解每个指标和画线工具；博客提供教程；更新日志列出新功能。
• 价格状态：GET /v1/prices/latest 会为每条报价标明 LIVE、STALE 或 MARKET_CLOSED（参见价格状态）。

指标和画线在您的浏览器中计算。图表、指标和提醒仅为信息，不构成投资建议。