API Documentation

API KEYS

Please login to manage your API keys.

AUTHENTICATION

All API requests require authentication using an API key.

Authorization: Bearer hd_live_xxxxxxxxxxxxxxxx

Or as query parameter:

https://hashdice.click/api/v1/balance?api_key=hd_live_xxxxxxxxxxxxxxxx

ENDPOINTS

Account

GET /api/v1/account

{
  "status": "success",
  "data": {
    "id": 1,
    "username": "satoshi_fan",
    "email": "s***@example.com",
    "created_at": "2024-01-01T00:00:00Z"
  }
}

Balance

GET /api/v1/balance?currency=BTC

currencyBTC, ETH, DOGE, etc (optional, defaults to BTC)

{
  "status": "success",
  "data": {
    "currency": "BTC",
    "balance": 0.01520000,
    "available": 0.01520000,
    "locked": 0.00000000
  }
}

Place Bet

POST /api/v1/bet

{
  "currency": "BTC",
  "amount": 0.001,
  "chance": 68,
  "condition": "under",
  "game": "dice",
  "client_seed": "my_custom_seed"
}

{
  "status": "success",
  "data": {
    "bet_id": 884213,
    "roll": 52.17,
    "win": true,
    "multiplier": 1.4338,
    "payout": 0.00143380,
    "profit": 0.00043380,
    "balance": 0.01563380,
    "nonce": 42
  }
}

Bet History

GET /api/v1/history?limit=10&offset=0¤cy=BTC

limitMax 100, default 50

offsetPagination offset, default 0

currencyFilter by currency (optional)

{
  "status": "success",
  "data": {
    "bets": [
      {"id": 884213, "amount": 0.00100000, "roll": 52.17, "profit": 0.00043380, "win": 1, "created_at": "2024-01-15 10:30:00"}
    ],
    "total": 4812,
    "limit": 10,
    "offset": 0
  }
}

Statistics

GET /api/v1/statistics?currency=BTC

{
  "status": "success",
  "data": {
    "total_bets": 4812,
    "total_wager": 2.44120000,
    "profit": 0.03210000,
    "wins": 3271,
    "losses": 1541,
    "lucky_pct": 67.97
  }
}

Referral

GET /api/v1/referral

{
  "status": "success",
  "data": {
    "referral_count": 38,
    "commission_rate": 10.00,
    "total_earned": 0.14882000,
    "referral_link": "https://hashdice.click/r/abc123"
  }
}

Deposit

GET /api/v1/deposit?currency=BTC

{
  "status": "success",
  "data": {
    "address": "bc1qhd8842f1demoaddressxxxxxxxxxxxxxxxxxxxx",
    "currency": "BTC",
    "confirmations_required": 1
  }
}

Withdraw

POST /api/v1/withdraw

{
  "currency": "BTC",
  "amount": 0.005,
  "address": "bc1qwithdrawdemoaddressxxxxxxxxxxxxxxxxxxxx"
}

{
  "status": "success",
  "data": {
    "withdraw_id": 12345,
    "status": "pending",
    "amount": 0.00500000,
    "fee": 0.00010000,
    "address": "bc1qwithdrawdemoaddressxxxxxxxxxxxxxxxxxxxx"
  }
}

Server Seed

GET /api/v1/server-seed

{
  "status": "success",
  "data": {
    "server_seed_hash": "a1b2c3d4e5f67890...",
    "nonce": 42,
    "auto_rotate": 100000
  }
}

Rotate Seed

POST /api/v1/rotate-seed

{
  "status": "success",
  "data": {
    "server_seed_hash": "f1e2d3c4b5a69876...",
    "nonce": 0,
    "message": "Server seed rotated successfully"
  }
}