TradeLayer

Challenges & Demo Accounts

TradeLayer is optimized for demo & challenge platforms. These endpoints are for admins/platform operators.

Create Challenge

POST /challenges (admin auth)

1{
2  "name": "Pro Trader Sprint",
3  "description": "30-day BTC/USDT leveraged trading challenge",
4  "start_time": 1700600000000,
5  "end_time": 1703192000000,
6  "base_currency": "USDT",
7  "starting_balance": "100000.00",
8  "max_drawdown_percent": 10,
9  "max_daily_loss_percent": 5,
10  "leverage_cap": 100,
11  "allowed_symbols": ["BTCUSDT"],
12  "status": "DRAFT",
13  "metadata": {
14    "prize_pool": "5000 USDT",
15    "sponsor": "MyPlatform"
16  }
17}

Response:

1{
2  "success": true,
3  "data": {
4    "challenge_id": "tl_ch_93817",
5    "status": "DRAFT",
6    "created_at": 1700483073000
7  }
8}

Publish / Activate Challenge

POST /challenges/{challenge_id}/activate

1{ "success": true, "data": { "challenge_id": "tl_ch_93817", "status": "ACTIVE" } }

Enroll User into Challenge

POST /challenges/{challenge_id}/enroll

1{
2  "user_id": "tl_user_9e8127"
3}

Response:

1{
2  "success": true,
3  "data": {
4    "challenge_id": "tl_ch_93817",
5    "user_id": "tl_user_9e8127",
6    "account_id": "ch_acc_77191",
7    "starting_balance": "100000.00",
8    "status": "ACTIVE",
9    "created_at": 1700600100000
10  }
11}

Challenge Leaderboard

GET /challenges/{challenge_id}/leaderboard?sort=equity_desc&page=1&page_size=50

1{
2  "success": true,
3  "data": [
4    {
5      "rank": 1,
6      "user_id": "tl_user_9e8127",
7      "external_user_id": "user_12345",
8      "display_name": "ProTrader01",
9      "equity": "142350.23",
10      "return_percent": 42.35,
11      "max_drawdown_percent": 6.2,
12      "trades_count": 184
13    }
14  ],
15  "pagination": { ... }
16}