📊 Orderly Data API
Fetch Orderly Network metrics for content creation, reporting, and analysis.
When to Use
- Content bot needs fresh Orderly metrics (volume, TVL, users, revenue)
- Building reports or dashboards about Orderly Network
- Comparing Orderly performance over time
Auth
Two APIs with different auth:
| API |
Base URL |
Auth |
| Data API (internal metrics) |
https://data-api.orderly.network/orderly/api/v1 |
X-API-KEY header with ORDERLY_DATA_API_KEY from .env |
| Public API (on-chain stats) |
https://api.orderly.org/v1/public |
No auth required |
Endpoints
Data API (requires ORDERLY_DATA_API_KEY)
| Endpoint |
Description |
Key Fields |
GET /metrics/overview?range=weekly |
Weekly/monthly KPIs over time |
avg_daily_volume, avg_daily_revenue, avg_new_users, avg_active_users |
GET /metrics/volume-segments |
Volume by segment (B2B/B2C/MM) |
b2b_volume, b2c_volume, mm_volume |
GET /metrics/stake-users |
$ORDER staker count |
unique_stakers |
GET /metrics/stake-vs-supply |
Staked vs circulating |
total_staked, circulating_supply |
GET /metrics/omnivault-tvl |
TVL by vault (weekly) |
total_tvl, vault breakdowns |
GET /distributors/stats |
All distributor stats |
invitee_count, revenue_share_30d, volume_30d |
GET /distributors/invitees?distributor_id=X |
Invitees for a distributor |
dex_name, volume, revenue |
GET /data/summary |
API health + DB stats |
status |
range parameter: Use weekly or monthly for /metrics/overview.
Public API (no auth)
| Endpoint |
Description |
Key Fields |
GET /balance/stats |
Total platform holdings |
total_holding (USDC TVL) |
GET /volume/stats |
Volume aggregates |
perp_volume_ytd, perp_volume_ltd, perp_volume_last_30_days |
GET /funding_rates |
All perp funding rates |
est_funding_rate, last_funding_rate per symbol |
GET /funding_rate/{symbol} |
Single symbol funding |
e.g. PERP_BTC_USDC |
GET /trading_rewards/epoch_data |
$ORDER reward epochs |
epoch_id, reward_status, r_major, r_alts |
GET /info |
All trading pairs/instruments |
symbol specs, tick sizes |
GET /futures |
Futures contract info |
contract details |
GET /token |
Supported tokens |
token list |
GET /chain_info |
Supported chains |
chain IDs, RPCs |
Quick Start
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()
Content Bot Cheat Sheet
For a quick Orderly health snapshot, pull these three:
- Volume:
GET /volume/stats → perp_volume_last_30_days, perp_volume_ytd
- TVL:
GET /balance/stats → total_holding
- Growth:
GET /metrics/overview?range=weekly → latest week's avg_daily_volume, avg_new_users
Current Numbers (as of March 20, 2026)
- Perp Volume YTD: $72.6B
- Perp Volume LTD: $186.8B
- 30d Volume: $1.16B
- Platform TVL: $18.3M
- Distributors: 399
- $ORDER Rewards: 23M tokens distributed across 15 epochs
Error Handling
- Data API returns
{"detail": "Invalid API key"} on bad auth
- Public API returns
{"success": false, "code": -1106, "message": "..."} on bad params
- Both return standard HTTP status codes
Notes
- Data API metrics update daily; not real-time
- Public API balance/volume stats update every ~10 minutes
- Funding rates update every 8 hours (with estimated rates between)
1---2name: 1247-orderly-data3description: Fetch Orderly Network metrics for content creation, reporting, and analysis.4---56# 📊 Orderly Data API78Fetch Orderly Network metrics for content creation, reporting, and analysis.910## When to Use11- Content bot needs fresh Orderly metrics (volume, TVL, users, revenue)12- Building reports or dashboards about Orderly Network13- Comparing Orderly performance over time1415## Auth1617Two APIs with different auth:1819| API | Base URL | Auth |20|-----|----------|------|21| **Data API** (internal metrics) | `https://data-api.orderly.network/orderly/api/v1` | `X-API-KEY` header with `ORDERLY_DATA_API_KEY` from `.env` |22| **Public API** (on-chain stats) | `https://api.orderly.org/v1/public` | No auth required |2324## Endpoints2526### Data API (requires `ORDERLY_DATA_API_KEY`)2728| Endpoint | Description | Key Fields |29|----------|-------------|------------|30| `GET /metrics/overview?range=weekly` | Weekly/monthly KPIs over time | `avg_daily_volume`, `avg_daily_revenue`, `avg_new_users`, `avg_active_users` |31| `GET /metrics/volume-segments` | Volume by segment (B2B/B2C/MM) | `b2b_volume`, `b2c_volume`, `mm_volume` |32| `GET /metrics/stake-users` | $ORDER staker count | `unique_stakers` |33| `GET /metrics/stake-vs-supply` | Staked vs circulating | `total_staked`, `circulating_supply` |34| `GET /metrics/omnivault-tvl` | TVL by vault (weekly) | `total_tvl`, vault breakdowns |35| `GET /distributors/stats` | All distributor stats | `invitee_count`, `revenue_share_30d`, `volume_30d` |36| `GET /distributors/invitees?distributor_id=X` | Invitees for a distributor | `dex_name`, `volume`, `revenue` |37| `GET /data/summary` | API health + DB stats | `status` |3839**`range` parameter:** Use `weekly` or `monthly` for `/metrics/overview`.4041### Public API (no auth)4243| Endpoint | Description | Key Fields |44|----------|-------------|------------|45| `GET /balance/stats` | Total platform holdings | `total_holding` (USDC TVL) |46| `GET /volume/stats` | Volume aggregates | `perp_volume_ytd`, `perp_volume_ltd`, `perp_volume_last_30_days` |47| `GET /funding_rates` | All perp funding rates | `est_funding_rate`, `last_funding_rate` per symbol |48| `GET /funding_rate/{symbol}` | Single symbol funding | e.g. `PERP_BTC_USDC` |49| `GET /trading_rewards/epoch_data` | $ORDER reward epochs | `epoch_id`, `reward_status`, `r_major`, `r_alts` |50| `GET /info` | All trading pairs/instruments | symbol specs, tick sizes |51| `GET /futures` | Futures contract info | contract details |52| `GET /token` | Supported tokens | token list |53| `GET /chain_info` | Supported chains | chain IDs, RPCs |5455## Quick Start5657```python58import os, requests5960# Data API (authed)61DATA_BASE = "https://data-api.orderly.network/orderly/api/v1"62API_KEY = os.environ["ORDERLY_DATA_API_KEY"]63headers = {"X-API-KEY": API_KEY}6465overview = requests.get(f"{DATA_BASE}/metrics/overview", params={"range": "weekly"}, headers=headers).json()6667# Public API (no auth)68PUB_BASE = "https://api.orderly.org/v1/public"69volume = requests.get(f"{PUB_BASE}/volume/stats").json()70balance = requests.get(f"{PUB_BASE}/balance/stats").json()71```7273## Content Bot Cheat Sheet7475For a quick Orderly health snapshot, pull these three:76771. **Volume**: `GET /volume/stats` → `perp_volume_last_30_days`, `perp_volume_ytd`782. **TVL**: `GET /balance/stats` → `total_holding`793. **Growth**: `GET /metrics/overview?range=weekly` → latest week's `avg_daily_volume`, `avg_new_users`8081### Current Numbers (as of March 20, 2026)82- **Perp Volume YTD:** $72.6B83- **Perp Volume LTD:** $186.8B84- **30d Volume:** $1.16B85- **Platform TVL:** $18.3M86- **Distributors:** 39987- **$ORDER Rewards:** 23M tokens distributed across 15 epochs8889## Error Handling9091- Data API returns `{"detail": "Invalid API key"}` on bad auth92- Public API returns `{"success": false, "code": -1106, "message": "..."}` on bad params93- Both return standard HTTP status codes9495## Notes9697- Data API metrics update daily; not real-time98- Public API balance/volume stats update every ~10 minutes99- Funding rates update every 8 hours (with estimated rates between)
starchild-ai-agent