Preview API

This is the preview API for the demo venue. It is read only, no authentication is required, and CORS is open for GET requests. The trading API publishes at launch. Every response includes a disclaimer field.

Rate limit: 60 requests per minute per caller. Over the limit you get HTTP 429 with a clear message and a retry-after header. Wallet addresses are never returned.

See venue activity

GET/api/v1/round

The current round with both pools, both multipliers and seconds left in the phase. One series is active: BTC higher or lower on a five minute cadence.

Parameters

duration (integer) Series interval in seconds. Defaults to 150. Any other value returns the five minute series, because it is the only one running.

Example Request

curl -s https://juniorshot.xyz/api/v1/round

Example Response

{
  "round": {
    "id": 3,
    "phase": "OPEN",
    "opened_at": "2026-08-14T19:45:00+00:00",
    "freeze_at": "2026-08-14T19:47:00+00:00",
    "settle_at": "2026-08-14T19:47:30+00:00",
    "open_price": 62906,
    "higher_pool": 0,
    "lower_pool": 0,
    "higher_multiplier": 1,
    "lower_multiplier": 1,
    "seconds_left": 104
  },
  "disclaimer": "Demo venue. Points are free, have no cash value, and are not redeemable for any token or asset."
}

GET/api/v1/rounds?limit=50

Recent finished rounds with open and settle price, winning side and both pools.

Parameters

limit (integer) 1 to 200, default 50.

Example Request

curl -s https://juniorshot.xyz/api/v1/rounds?limit=50

Example Response

{
  "limit": 2,
  "rounds": [
    {
      "id": 2,
      "opened_at": "2026-08-14T19:33:00+00:00",
      "settle_at": "2026-08-14T19:35:30+00:00",
      "open_price": 62834,
      "settle_price": 62852,
      "winning_side": "HIGHER",
      "status": "SETTLED",
      "higher_pool": 500,
      "lower_pool": 300
    }
  ],
  "disclaimer": "Demo venue. Points are free, have no cash value, and are not redeemable for any token or asset."
}

GET/api/v1/leaderboard?limit=50

Points leaderboard by handle. No wallet addresses, ever.

Parameters

limit (integer) 1 to 200, default 50.

Example Request

curl -s https://juniorshot.xyz/api/v1/leaderboard?limit=50

Example Response

{
  "limit": 3,
  "leaderboard": [
    {
      "handle": "trader_qj9yko",
      "points": 10000,
      "wins": 0,
      "rounds_played": 0,
      "best_streak": 0
    }
  ],
  "disclaimer": "Demo venue. Points are free, have no cash value, and are not redeemable for any token or asset."
}

GET/api/v1/stats

The aggregates behind the venue activity page, including a 14 day daily series.

Parameters

None.

Example Request

curl -s https://juniorshot.xyz/api/v1/stats

Example Response

{
  "stats": {
    "roundsSettledAllTime": 1,
    "roundsSettled24h": 1,
    "roundsVoid": 1,
    "voidRate": 50,
    "uniquePlayers": 1,
    "positionsPlaced": 0,
    "pointsStaked": 0,
    "higherWins": 1,
    "lowerWins": 0,
    "avgWinningMultiplier": null,
    "daily": [{ "day": "2026-08-14", "rounds": 3, "positions": 0 }],
    "generatedAt": "2026-08-14T19:45:21.709Z"
  },
  "disclaimer": "Demo venue. Points are free, have no cash value, and are not redeemable for any token or asset."
}

About Points

Points are free, have no cash value, and are not redeemable for any token or asset. They cannot be purchased, sold, transferred or withdrawn, and may be reset at any time.