Market Data

Public market data endpoints - prices, orderbooks, candles

Get L2 order book

get

https://api.margin.tradehttp://localhost:8080

/api/l2book

Returns aggregated order book levels (bids and asks) from the order book cache

Query parameters

symbolstringRequired

Market symbol (e.g., BTC, ETH, SOL)

Example: BTC

Responses

200

Order book snapshot

application/json

coinstringRequiredExample: BTC

timeinteger · int64Required

Timestamp in milliseconds

spreadstringOptionalExample: 1.00

get

/api/l2book

HTTPcURLJavaScriptPython

GET /api/l2book?symbol=BTC HTTP/1.1
Host: api.margin.trade
Accept: */*

200

Order book snapshot

{
  "coin": "BTC",
  "time": 1,
  "levels": [
    [
      {
        "px": "43250.00",
        "sz": "1.5",
        "n": 3
      },
      {
        "px": "43249.50",
        "sz": "2.1",
        "n": 5
      }
    ],
    [
      {
        "px": "43251.00",
        "sz": "1.8",
        "n": 4
      },
      {
        "px": "43251.50",
        "sz": "0.9",
        "n": 2
      }
    ]
  ],
  "spread": "1.00"
}

Get engine L2 order book

get

https://api.margin.tradehttp://localhost:8080

/api/l2book/engine

Returns order book directly from matching engine with real-time data

Query parameters

symbolstringRequired

Market symbol (e.g., BTC, ETH, SOL)

Example: BTC

Responses

200

Engine order book

application/json

coinstringRequiredExample: BTC

timeinteger · int64Required

Timestamp in milliseconds

spreadstringOptionalExample: 1.00

500

Internal server error

application/json

get

/api/l2book/engine

HTTPcURLJavaScriptPython

GET /api/l2book/engine?symbol=BTC HTTP/1.1
Host: api.margin.trade
Accept: */*

{
  "coin": "BTC",
  "time": 1,
  "levels": [
    [
      {
        "px": "43250.00",
        "sz": "1.5",
        "n": 3
      },
      {
        "px": "43249.50",
        "sz": "2.1",
        "n": 5
      }
    ],
    [
      {
        "px": "43251.00",
        "sz": "1.8",
        "n": 4
      },
      {
        "px": "43251.50",
        "sz": "0.9",
        "n": 2
      }
    ]
  ],
  "spread": "1.00"
}

Get user positions

get

https://api.margin.tradehttp://localhost:8080

/api/positions

Returns open positions for a specific user

Query parameters

userstringOptional

User address to filter positions (optional)

Example: 0x1234567890abcdef1234567890abcdef12345678

Responses

200

List of user positions

application/json

coinstringOptionalExample: BTC

szistringOptional

Signed size (positive for long, negative for short)

Example: 1.5

entryPxstring · nullableOptionalExample: 43000.00

positionValuestringOptionalExample: 64500.00

unrealizedPnlstringOptionalExample: 375.75

liquidationPxstring · nullableOptionalExample: 38700.00

marginUsedstringOptionalExample: 6450.00

500

Internal server error

application/json

get

/api/positions

HTTPcURLJavaScriptPython

GET /api/positions HTTP/1.1
Host: api.margin.trade
Accept: */*

[
  {
    "coin": "BTC",
    "szi": "1.5",
    "leverage": {
      "type": "cross",
      "value": 10
    },
    "entryPx": "43000.00",
    "positionValue": "64500.00",
    "unrealizedPnl": "375.75",
    "liquidationPx": "38700.00",
    "marginUsed": "6450.00"
  }
]

Get position count for a market

get

https://api.margin.tradehttp://localhost:8080

/api/marketPositionCount

Returns number of open positions for a specific market up to a given sequence number

Query parameters

midinteger · uint16Required

Market ID (0 = BTC, 1 = ETH, etc.)

Example: 0

maxSequenceinteger · int64Required

Maximum sequence number to include

Example: 1000000

Responses

200

Position count

application/json

countintegerOptionalExample: 145

get

/api/marketPositionCount

HTTPcURLJavaScriptPython

GET /api/marketPositionCount?mid=0&maxSequence=1000000 HTTP/1.1
Host: api.margin.trade
Accept: */*

200

Position count

{
  "count": 145
}