Judge Market LogoJudgeMarketUS
Rewards Invite Friends News Blog Builders Support
© 2026 JudgeMarket
AboutPrivacyTermsWhat is OPSNewsBlog
HomeWallet
API Docs
Getting StartedAuthenticationMarket DataTradingAccountSocialWebSocketError Codes

Market Data

Public endpoints for prices, orderbooks, and historical data. No authentication required.

List All Assets

GET/assets

Returns all active figures with metadata.

[
  {
    "id": "elon-musk",
    "name": "Elon Musk",
    "title": "CEO of Tesla & SpaceX",
    "image_url": "https://upload.wikimedia.org/...",
    "era": "contemporary",
    "tags": ["Business", "Tech", "USA"],
    "wiki_summary_text": "Elon Reeve Musk is a businessman...",
    "wiki_url": "https://en.wikipedia.org/wiki/Elon_Musk"
  }
]

All Tickers

GET/assets/ticker

Returns 24h statistics for all assets. Cached and refreshed every 5 seconds.

[
  {
    "asset_id": "elon-musk",
    "price": "86.31",
    "change_24h": "2.50",
    "volume_24h": "1234.56",
    "total_volume": "57846.26",
    "high_24h": "88.00",
    "low_24h": "84.00",
    "trade_count": 240,
    "post_count": 3
  }
]

Single Ticker

GET/assets/:id/ticker

Returns ticker for a specific asset.

Order Book

GET/assets/:id/orderbook

Returns current bids and asks (top levels).

{
  "bids": [
    { "price": "79.45", "amount": "1.00" },
    { "price": "77.83", "amount": "1.00" }
  ],
  "asks": [
    { "price": "88.72", "amount": "1.17" },
    { "price": "89.32", "amount": "1.17" }
  ]
}

Price History

GET/assets/:id/history

Returns historical price data points for charting.

Recent Trades

GET/assets/:id/trades

Returns the most recent executed trades for an asset.

[
  {
    "price": "86.31",
    "amount": "2.00",
    "side": "BID",
    "created_at": "2026-04-07T02:30:00Z"
  }
]

K-Line Data

GET/assets/:id/klines

Returns OHLCV candlestick data. Query params: interval (1m, 5m, 1h, 1d), limit.

Asset Stats

GET/assets/:id/stats

Returns total trade count and post count for an asset.

Top Holders

GET/assets/:id/holders

Returns top position holders for an asset (public leaderboard).

[
  {
    "user_id": "0x1234...",
    "username": "whale_trader",
    "side": "LONG",
    "amount": "150.00",
    "percentage": "12.5"
  }
]

Wiki Data

GET/assets/:id/wiki

Returns Wikipedia summary HTML and text for an asset.