API Documentation

Trade programmatically and build powerful apps on top of the JudgeMarket reputation engine.

Getting Started

All API requests should be made to the following base URL:

https://api.judgemarket.com

The API currently supports RESTful architecture and returns JSON responses.

Authentication

To access private endpoints (trading, user info), you must provide your API key in the request headers using the X-API-KEY field.

X-API-KEY: jm_your_api_key_here

Market Data (Public)

These endpoints do not require authentication and can be used to fetch real-time market stats.

GET/assets

Fetch all active figures, including their current base score and tags.

GET/assets/:id/ticker

Get 24h statistics, high/low prices, and volume for a specific asset.

GET/assets/:id/orderbook

Retrieve the current order book depth (top 5 bids and asks).

Trading (Private)

Use these endpoints to execute trades. Requires a valid API Key.

POST/order

Submit a new order to the matching engine.

// Request Body Example
{
  "asset_id": "elon-musk",
  "side": "Bid",        // "Bid" (Buy) or "Ask" (Sell)
  "order_type": "Limit", // "Limit" or "Market"
  "price": "75.20",     // Required for Limit orders
  "amount": "10.0",     // Quantity of shares
  "reduce_only": false  // Set true to only close positions
}