ZanoX Public API

Getting Started

curl -H "X-API-Key: zx_your_key_here" \
  "https://zanox.io/api/v1/predictions/markets"

Requesting an API Key

Authentication

Rate Limits

Response Format

{
  "data": [ ... ],
  "meta": {
    "timestamp": "2026-03-31T12:00:00.000Z",
    "request_id": "a1b2c3d4-..."
  },
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 142,
    "total_pages": 8,
    "has_more": true
  }
}

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Please wait and try again.",
    "details": {
      "limit": 60,
      "reset_at": "2026-03-31T12:01:00.000Z"
    }
  },
  "meta": {
    "timestamp": "2026-03-31T12:00:30.000Z",
    "request_id": "e5f6g7h8-..."
  }
}

Error Codes

JavaScript Example

const API_KEY = 'zx_your_key_here';
const BASE = 'https://zanox.io/api/v1';

async function getMarkets() {
  const res = await fetch(`${BASE}/predictions/markets?status=active&per_page=10`, {
    headers: { 'X-API-Key': API_KEY },
  });
  const json = await res.json();
  console.log(json.data);          // Array of markets
  console.log(json.pagination);    // { page, per_page, total, ... }
}

getMarkets();

Trading API

Place orders programmatically using your own Zano wallet. Supports both prediction markets (fUSD) and sports betting (ZANO or fUSD), with limit and market orders.

Prerequisites

How It Works

Authentication

Step 1: Get a Trading Token

With your simplewallet running in RPC mode, complete the three-step auth handshake:

# Step 1: Request challenge
curl -X POST -H "X-API-Key: zx_your_key" \
  -H "Content-Type: application/json" \
  -d '{"address": "ZxYourAddress...", "alias": "youralias"}' \
  "https://zanox.io/api/v1/trade/auth/challenge"

# Response includes challenge_base64

# Step 2: Sign with your wallet RPC
curl -X POST http://127.0.0.1:11212/json_rpc \
  -d '{"jsonrpc":"2.0","id":0,"method":"sign_message","params":{"buff":"<challenge_base64>"}}'

# Response: { "result": { "pkey": "abc...", "sig": "def..." } }

# Step 3: Verify signature and get trading token
curl -X POST -H "X-API-Key: zx_your_key" \
  -H "Content-Type: application/json" \
  -d '{"address":"ZxYourAddress...","alias":"youralias","challenge":"<original_challenge>","signature":"<sig>","pkey":"<pkey>"}' \
  "https://zanox.io/api/v1/trade/auth/verify"

# Response: { "data": { "trading_token": "eyJ...", "expires_in": 86400 } }

Step 2: Place an Order

All trade endpoints require both X-API-Key and Authorization: Bearer <trading_token>.

# Limit order: sits in orderbook at your price until filled or cancelled
curl -X POST -H "X-API-Key: zx_your_key" \
  -H "Authorization: Bearer <trading_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "market_type": "prediction",
    "market_id": "uuid-of-market",
    "outcome_id": "uuid-of-outcome",
    "side": "buy",
    "order_type": "limit",
    "price": 0.65,
    "size": 10
  }' \
  "https://zanox.io/api/v1/trade/orders"

# Market order: fills immediately at best available price
curl -X POST -H "X-API-Key: zx_your_key" \
  -H "Authorization: Bearer <trading_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "market_type": "sports",
    "market_id": "uuid-of-market",
    "outcome_id": "uuid-of-outcome",
    "side": "yes",
    "order_type": "market",
    "price": 0.70,
    "size": 5,
    "currency": "ZANO"
  }' \
  "https://zanox.io/api/v1/trade/orders"

# Response includes payment instructions for buy orders:
# { "data": { "order_id": "...", "status": "pending",
#   "payment": { "address": "Zx...", "amount": 7.15,
#     "payment_id": "01abc...", "asset_id": "86143..." } } }

Step 3: Send Payment and Confirm

# Send payment from your wallet
curl -X POST http://127.0.0.1:11212/json_rpc \
  -d '{"jsonrpc":"2.0","id":0,"method":"transfer","params":{
    "destinations":[{"address":"Zx...","amount":7150000000000,
      "asset_id":"86143388bd056a8f0bab669f78f14873fac8e2dd8d57898cdb725a2d5e2e4f8f",
      "payment_id":1234567890123456}],
    "fee":10000000000,"mixin":15}}'

# Confirm with tx_hash
curl -X PUT -H "X-API-Key: zx_your_key" \
  -H "Authorization: Bearer <trading_token>" \
  -H "Content-Type: application/json" \
  -d '{"tx_hash": "<64_char_hex_hash>"}' \
  "https://zanox.io/api/v1/trade/orders/<order_id>/confirm"

Trading Endpoints Reference

Order Types

Polymarket Mirror Thresholds

Order Lifecycle