API Documentation

Quick Start

Base URL: https://api.bituce.com/v1

Auth: Authorization: Bearer <token> for authenticated routes.

curl -s "https://api.bituce.com/v1/markets/tickers"

fetch("https://api.bituce.com/v1/markets/tickers")
  .then(r => r.json())
  .then(console.log)

Conventions: ISO-8601 timestamps in UTC, money as strings with up to 8 decimals, pagination via ?page=&per_page=.

Markets

List markets, last prices, and depth.

GET https://api.bituce.com/v1/exchange/markets

List available markets.

{
  "data": [
    {
      "market_code": "BTC-USDT",
      "base": "BTC",
      "quote": "USDT",
      "price_precision": 2,
      "min_amount": "0.0001"
    },
    {
      "market_code": "ETH-USDT",
      "base": "ETH",
      "quote": "USDT",
      "price_precision": 2,
      "min_amount": "0.001"
    }
  ],
  "page": 1,
  "per_page": 50,
  "total": 2
}

GET https://api.bituce.com/v1/markets/tickers

Last price, 24h change and volume per market.

{
  "data": [
    {
      "market": "BTC-USDT",
      "last_price": "64250.10",
      "change_24h": "-1.25",
      "volume_24h": "1250.45"
    },
    {
      "market": "ETH-USDT",
      "last_price": "3180.50",
      "change_24h": "2.10",
      "volume_24h": "980.02"
    }
  ],
  "ts": "2025-08-24T15:00:00Z"
}

GET https://api.bituce.com/v1/markets/orderbook?market=BTC-USDT

Aggregated order book (top levels).

{
  "market": "BTC-USDT",
  "bids": [
    [
      "64210.00",
      "0.25"
    ],
    [
      "64200.00",
      "0.80"
    ]
  ],
  "asks": [
    [
      "64260.00",
      "0.40"
    ],
    [
      "64270.00",
      "0.60"
    ]
  ],
  "ts": "2025-08-24T15:00:00Z"
}

Trading Pairs

GET https://api.bituce.com/v1/markets/pairs

All tradable pairs with precision and limits.

{
  "data": [
    {
      "market": "BTC-UST",
      "base_id": 1,
      "quote_id": 2,
      "step_size": "0.0001",
      "tick_size": "0.01",
      "min_notional": "5"
    },
    {
      "market": "ETH-USDT",
      "base_id": 3,
      "quote_id": 2,
      "step_size": "0.001",
      "tick_size": "0.01",
      "min_notional": "5"
    }
  ]
}

Stake Rates

GET https://api.bituce.com/v1/stake/rates

Latest APRs per currency and term.

{
  "data": [
    {
      "currency": "USDT",
      "term": "7d",
      "apr": "6.50"
    },
    {
      "currency": "BTC",
      "term": "30d",
      "apr": "2.10"
    },
    {
      "currency": "ETH",
      "term": "30d",
      "apr": "3.20"
    }
  ],
  "ts": "2025-08-24T15:00:00Z"
}

GET https://api.bituce.com/v1/stake/pools

{
  "data": [
    {
      "pool_id": 10,
      "currency": "USDT",
      "min_amount": "50",
      "lock_days": 30,
      "apr": "8.20",
      "capacity": "500000"
    },
    {
      "pool_id": 12,
      "currency": "BTC",
      "min_amount": "0.002",
      "lock_days": 90,
      "apr": "3.00",
      "capacity": "50"
    }
  ]
}

POST https://api.bituce.com/v1/stake/open

Open a new stake (authenticated).

POST {{} }   
{
  "pool_id": 10,
  "amount": "250.00"
}
Headers:
  Authorization: Bearer <token>
  Content-Type: application/json

{
  "stake_id": 991234,
  "status": "open",
  "currency": "USDT",
  "amount": "250.00",
  "apr": "8.20",
  "lock_days": 30,
  "opened_at": "2025-08-24T15:02:00Z"
}

Games & Provably Fair

GET https://api.bituce.com/v1/games

Games catalogue.

{
  "data": [
    {
      "slug": "mirage-sevens",
      "title": "Mirage Sevens",
      "type": "slot",
      "max_win_x": 25000,
      "volatility": "high"
    },
    {
      "slug": "roulette",
      "title": "Roulette",
      "type": "table",
      "rtp": "97.3"
    }
  ]
}

GET https://api.bituce.com/v1/games/mirage-sevens

Single game info.

{
  "slug": "mirage-sevens",
  "title": "Mirage Sevens",
  "type": "slot",
  "reels": "3x1",
  "lines": 1,
  "volatility": "high",
  "rtp": "96.2",
  "max_win_x": 25000,
  "symbols": [
    "SEVEN",
    "BAR",
    "CHERRY",
    "WILD",
    "SCATTER"
  ]
}

GET https://api.bituce.com/v1/games/roulette/rounds/123456

Provably fair round payload.

{
  "round_id": 123456,
  "server_hash": "aab3d7...9f2",
  "server_seed": "8c9e9a...2a1",
  "client_seed": "user-abc",
  "nonce": 42,
  "result": {
    "game": "roulette",
    "index": 17,
    "label": "BLACK 17"
  },
  "settled_at": "2025-08-24T15:04:12Z"
}

WebSocket Streams

Real-time updates over WebSocket.

• wss://ws.bituce.com/v1/market/tickers — public tickers
• wss://ws.bituce.com/v1/market/orderbook?market=BTC-USDT — orderbook
• wss://ws.bituce.com/v1/games/rounds — public round results

{
  "stream": "tickers",
  "market": "BTC-USDT",
  "last_price": "64255.80",
  "change_24h": "-1.10",
  "volume_24h": "1251.02",
  "ts": 1692791112123
}

Errors

Errors use a consistent envelope.

{
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "market is required",
    "details": {
      "field": "market"
    }
  },
  "ts": "2025-08-24T15:05:00Z"
}

Rate Limits

• Public REST: 60 req / 60s per IP
• Auth REST: 120 req / 60s per user
• WebSocket: 1 connection / 10s; subscribe up to 20 streams

Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Try It

CORS must allow this origin. Do not paste private tokens you care about.