Contests

Base URL

https://backend-global.gains.trade/api

Endpoints

1. List All Contests

GET /contests

Response:

[
  {
    "id": "trickortrade",
    "start": 1729608000000,
    "end": 1732026000000,
    "chains": ["arbitrum"],
    "isActive": true
  }
]

---

2. Get Contest Details

GET /contests/:id

Response:

{
  "id": "trickortrade",
  "start": 1729608000000,
  "end": 1732026000000,
  "chains": ["arbitrum"],
  "isActive": true,
  "stats": {
    "totalTraders": 1247,
    "totalTrades": 8931,
    "totalPnl": 125430.5,
    "totalVolumePoints": 9847231.25,
    "top300VolumePoints": 8234192.1
  },
  "rewards": {
    "pnlAbsolute": {
      "1": 40000,
      "2": 20000,
      "3": 15000
      // ... ranks 1-50
    },
    "volume": {
      "proportional": true,
      "pool": 200000,
      "topN": 300
    }
  }
}

---

3. Get Leaderboard

GET /contests/:id/leaderboard

Query Parameters:

• sortBy (optional): "pnl" or "volume" (default: "pnl")

• limit (optional): Number of results to return (default: all)

• offset (optional): Pagination offset (default: 0)

Example Request:

GET /contests/trickortrade/leaderboard?sortBy=volume&limit=50&offset=0

Response:

{
  "contestId": "trickortrade",
  "sortBy": "volume",
  "pagination": {
    "total": 1247,
    "offset": 0,
    "limit": 50,
    "count": 50,
    "hasMore": true
  },
  "leaderboard": [
    {
      "traderAddress": "0x1234...5678",
      "pnlUsd": 12450.75,
      "volumeUsd": 2450000.0,
      "volumePoints": 984532.5,
      "tradeCount": 127,
      "lastUpdated": 1729123456789,
      "rank": 1
    }
    // ... more traders
  ]
}

---

4. Get Trader Stats

GET /contests/:id/leaderboard/:trader

Example Request:

GET /contests/trickortrade/leaderboard/0x1234567890abcdef

Response:

{
  "contestId": "trickortrade",
  "trader": "0x1234567890abcdef",
  "stats": {
    "pnlUsd": 12450.75,
    "volumeUsd": 2450000.0,
    "volumePoints": 984532.5,
    "tradeCount": 127,
    "lastUpdated": 1729123456789
  },
  "rankings": {
    "pnl": 5,
    "volume": 1
  },
  "rewards": {
    "pnl": 8500,
    "volume": 23894.5,
    "total": 32394.5
  }
}

---

Data Refresh Rates

60-90 seconds

Notes

• All timestamps are in Unix milliseconds (UTC)

• Trader addresses are case-insensitive

• Volume rewards are proportionally distributed among top 300 traders

• PnL rewards are fixed amounts for top 50 traders

• volumePoints represents time-weighted volume (used for rankings)

• volumeUsd represents raw dollar volume (all opens/increases/decreases/closes)