Omni Terminal · Traders

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://omniterminal.app/api/x402/v1/traders/:symbol", {
  method: "GET",
});
const data = await res.json();

curl -X GET \
  "https://omniterminal.app/api/x402/v1/traders/:symbol?limit=10&rank=best&scope=current" \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "data_as_of": 1784116800000,
  "freshness": {
    "age_seconds": 0,
    "data_as_of": "2026-07-15T12:00:00.000Z",
    "max_age_seconds": 300,
    "status": "fresh"
  },
  "generated_at": "2026-07-15T12:00:00.000Z",
  "product_version": "v1",
  "rank": "best",
  "rows": [
    {
      "address": "0x45d26f28196d226497130c4bac709d808fed4029",
      "total_pnl": 3635032.76,
      "total_size": -103,
      "total_value": 6682743
    }
  ],
  "schema": "hyperliquid_trader_leaderboard.v1",
  "scope": "current",
  "service": "omni.hyperliquid_trader_leaderboard",
  "symbol": "BTC",
  "usage": {
    "item_count": 1,
    "item_limit": 10
  }
}