ZerCEX Public API

📋 Get Available Markets

Endpoint: /api/v1/markets

Method: GET

Description: Returns the list of available trading pairs.

Example Request:

GET https://zercex.xyz/api/v1/markets

Example Response:

[
  {
    "symbol": "BTC/USDC",
    "base_currency": "BTC",
    "quote_currency": "USDC"
  },
  {
    "symbol": "ZERC/USDC",
    "base_currency": "ZERC",
    "quote_currency": "USDC"
  }
]

📈 Get Ticker Data

Endpoint: /api/v1/ticker

Method: GET

Description: Returns the latest price and volume data for a specific market.

Parameters:

Example Request:

GET https://zercex.xyz/api/v1/ticker?market=ZERC/USDC

Example Response:

{
  "symbol": "ZERC/USDC",
  "last_price": "0.00600000",
  "high": "0.00900000",
  "low": "0.00500000",
  "volume": "203.07687855",
  "price_change_percent": 0,
  "timestamp": 1750677360
}

📊 Get Platform Statistics

Endpoint: /api/v1/stats

Method: GET

Description: Returns global platform statistics such as total 24h volume, number of users, trades, and markets.

Example Request:

GET https://zercex.xyz/api/v1/stats

Example Response:

{
  "volume_24h": "20345.12451200",
  "markets_count": 5,
  "users_count": 128,
  "trades_count": 7821,
  "updated_at": 1750678200
}

📚 Get Order Book

Endpoint: /api/v1/orders

Method: GET

Description: Returns the current order book (bids and asks) for a specific market.

Parameters:

Example Request:

GET https://zercex.xyz/api/v1/orders?market=ZERC/USDC

Example Response:

{
  "market": "ZERC/USDC",
  "bids": [
    {"price": 0.0060, "amount": 10.5},
    {"price": 0.0059, "amount": 5.0}
  ],
  "asks": [
    {"price": 0.0061, "amount": 7.2},
    {"price": 0.0062, "amount": 12.0}
  ]
}

🕒 Get Historical Trades

Endpoint: /api/v1/historical_trades

Method: GET

Description: Returns recent trades for a specific market.

Parameters:

Example Request:

GET https://zercex.xyz/api/v1/historical_trades?ticker_id=ZERC/USDC&limit=10

Example Response:

[
  {
    "trade_id": 120,
    "price": "0.00600000",
    "base_volume": "100.00000000",
    "quote_volume": "0.60000000",
    "timestamp": 1750679120,
    "type": "buy"
  },
  {
    "trade_id": 119,
    "price": "0.00590000",
    "base_volume": "50.00000000",
    "quote_volume": "0.29500000",
    "timestamp": 1750679000,
    "type": "sell"
  }
]