概述
Orderly Data 提供对 Orderly Network 各项指标的访问能力，主要用于内容创作、报告生成和数据分析。该技能聚合了两套 API：内部指标 Data API 与公开链上数据 Public API。
主要能力与接口
Data API（需认证）
基础 URL：https://data-api.orderly.network/orderly/api/v1 认证方式：请求头 X-API-KEY，密钥从 .env 中的 ORDERLY_DATA_API_KEY 读取。
可用端点：
- GET /metrics/overview?range=weekly：按周或月度返回随时间变化的 KPI，关键字段包括 avg_daily_volume、avg_daily_revenue、avg_new_users、avg_active_users；range 参数支持 weekly 或 monthly。
- GET /metrics/volume-segments：按 B2B/B2C/MM 分段的成交量，关键字段 b2b_volume、b2c_volume、mm_volume。
- GET /metrics/stake-users：$ORDER 质押者数量，关键字段 unique_stakers。
- GET /metrics/stake-vs-supply：质押量与流通量对比，关键字段 total_staked、circulating_supply。
- GET /metrics/omnivault-tvl：按金库的周度 TVL，关键字段 total_tvl 及金库明细。
- GET /distributors/stats：全部分发商统计，关键字段 invitee_count、revenue_share_30d、volume_30d。
- GET /distributors/invitees?distributor_id=X：指定分发商的被邀请人，关键字段 dex_name、volume、revenue。
- GET /data/summary：API 健康与数据库统计，关键字段 status。
Public API（无需认证）
基础 URL：https://api.orderly.org/v1/public
可用端点：
- GET /balance/stats：平台总持有量，关键字段 total_holding（USDC TVL）。
- GET /volume/stats：成交量聚合，关键字段 perp_volume_ytd、perp_volume_ltd、perp_volume_last_30_days。
- GET /funding_rates：所有永续合约资金费率，关键字段为每个交易对的 est_funding_rate、last_funding_rate。
- GET /funding_rate/{symbol}：单个交易对的资金费率，例如 PERP_BTC_USDC。
- GET /trading_rewards/epoch_data：$ORDER 奖励 epoch 数据，关键字段 epoch_id、reward_status、r_major、r_alts。
- GET /info：全部交易对/合约信息，含 symbol 规格与最小变动价位。
- GET /futures：期货合约信息。
- GET /token：支持的代币列表。
- GET /chain_info：支持的链信息，含 chain ID 与 RPC。
使用方式
资料给出 Python 调用示例：
import os, requests
Data API (authed)
DATA_BASE = "https://data-api.orderly.network/orderly/api/v1" API_KEY = os.environ["ORDERLY_DATA_API_KEY"] headers = {"X-API-KEY": API_KEY}
overview = requests.get(f"{DATA_BASE}/metrics/overview", params={"range": "weekly"}, headers=headers).json()
Public API (no auth)
PUB_BASE = "https://api.orderly.org/v1/public" volume = requests.get(f"{PUB_BASE}/volume/stats").json() balance = requests.get(f"{PUB_BASE}/balance/stats").json()
内容机器人快速快照（Cheat Sheet）：
- 成交量：GET /volume/stats → perp_volume_last_30_days、perp_volume_ytd
- TVL：GET /balance/stats → total_holding
- 增长：GET /metrics/overview?range=weekly → 最近一周的 avg_daily_volume、avg_new_users
适用场景
- 内容机器人需要获取最新的 Orderly 指标（成交量、TVL、用户数、收入）。
- 构建关于 Orderly Network 的报告或仪表盘。
- 对比 Orderly 在不同时间段的表现。
数据更新与错误处理
- Data API 指标每日更新，并非实时。
- Public API 余额/成交量统计约每 10 分钟更新。
- 资金费率每 8 小时更新（期间提供估算费率）。
- Data API 认证失败返回 {"detail": "Invalid API key"}。
- Public API 参数错误返回 {"success": false, "code": -1106, "message": "..."}。
- 两者均返回标准 HTTP 状态码。
示例数据（截至 2026 年 3 月 20 日）
- 永续合约成交量 YTD：$72.6B
- 永续合约成交量 LTD：$186.8B
- 30 天成交量：$1.16B
- 平台 TVL：$18.3M
- 分发商数量：399
- $ORDER 奖励：15 个 epoch 内分发 2300 万代币
限制
除上述接口、认证方式与更新频率外，资料未提供更多关于用量上限、费用、平台兼容性或部署环境的信息。