Standings

{
  "success": true,
  "data": {
    "competition_id": "9c1d2e3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f",
    "status": "running",
    "metric": "pnl_usd",
    "rules_version": 1,
    "updated_at": "2026-11-02T09:15:00Z",
    "final": false,
    "standings": [
      {
        "rank": 1,
        "ranked": true,
        "external_id": "user_8412",
        "csid_id": "3f9a1c2e-5b7d-4e8f-a1b2-c3d4e5f60718",
        "score": 3968.6,
        "pnl": 48.2,
        "pnl_usd": 3968.6,
        "volume": 408.7,
        "volume_usd": 33649.8,
        "trades": 40,
        "buys": 22,
        "sells": 18,
        "win_count": 14,
        "closed_count": 18,
        "win_rate": 77.78,
        "tokens": 21,
        "wallets": 2
      },
      {
        "rank": null,
        "ranked": false,
        "external_id": "user_8413",
        "csid_id": "8e2b4d6f-1a3c-4e5f-9b7d-0c2e4a6b8d10",
        "score": 12.4,
        "pnl": 0.15,
        "pnl_usd": 12.4,
        "volume": 0.9,
        "volume_usd": 74.1,
        "trades": 2,
        "buys": 1,
        "sells": 1,
        "win_count": 1,
        "closed_count": 1,
        "win_rate": 100.0,
        "tokens": 1,
        "wallets": 1
      }
    ]
  },
  "pagination": { "limit": 50, "total": 2, "has_more": false, "next_cursor": null },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-11-02T09:16:02Z"
  }
}

{
  "success": true,
  "data": {
    "competition_id": "9c1d2e3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f",
    "status": "running",
    "metric": "pnl_usd",
    "rules_version": 1,
    "updated_at": "2026-11-02T09:15:00Z",
    "final": false,
    "standings": [
      {
        "rank": 1,
        "ranked": true,
        "external_id": "user_8412",
        "csid_id": "3f9a1c2e-5b7d-4e8f-a1b2-c3d4e5f60718",
        "score": 3968.6,
        "pnl": 48.2,
        "pnl_usd": 3968.6,
        "volume": 408.7,
        "volume_usd": 33649.8,
        "trades": 40,
        "buys": 22,
        "sells": 18,
        "win_count": 14,
        "closed_count": 18,
        "win_rate": 77.78,
        "tokens": 21,
        "wallets": 2
      },
      {
        "rank": null,
        "ranked": false,
        "external_id": "user_8413",
        "csid_id": "8e2b4d6f-1a3c-4e5f-9b7d-0c2e4a6b8d10",
        "score": 12.4,
        "pnl": 0.15,
        "pnl_usd": 12.4,
        "volume": 0.9,
        "volume_usd": 74.1,
        "trades": 2,
        "buys": 1,
        "sells": 1,
        "win_count": 1,
        "closed_count": 1,
        "win_rate": 100.0,
        "tokens": 1,
        "wallets": 1
      }
    ]
  },
  "pagination": { "limit": 50, "total": 2, "has_more": false, "next_cursor": null },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-11-02T09:16:02Z"
  }
}

The ranking of a competition: the ranked traders first, by rank, then the participants below the minimums. Each entry has the score and the trading stats during the competition. Standings are recomputed every 5 minutes while the competition runs and once more at the end. After the end final is true and the standings are the results.

Query Parameters

string

required

The competition id.

integer

default:"100"

Entries per page, 1 to 1,000.

integer

default:"0"

How many to skip. Compare offset + limit with pagination.total to know whether more follow.

string

Your Instance ID. Only needed when your account has several instances.

string

required

Your API key. Alternatively pass it as an Authorization Bearer header.

Usage Example

curl "https://api-id.cabalspy.xyz/v1/competitions/standings?id=9c1d2e3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f&limit=50" \
  -H "Authorization: Bearer YOUR_KEY"

import requests

d = requests.get("https://api-id.cabalspy.xyz/v1/competitions/standings",
                 params={"id": "9c1d2e3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f", "limit": 50},
                 headers={"Authorization": "Bearer YOUR_KEY"}).json()["data"]
print(d["status"], "final" if d["final"] else "as of " + str(d["updated_at"]))
for s in d["standings"]:
    print(s["rank"], s["external_id"], s["score"], s["trades"])

const p = new URLSearchParams({ id: "9c1d2e3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f" });
const res = await fetch(`https://api-id.cabalspy.xyz/v1/competitions/standings?${p}`, {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
const { data } = await res.json();
data.standings.filter(s => s.ranked).forEach(s => console.log(s.rank, s.external_id, s.score));

Response

object

Show data

string

The competition id.

string

The competition’s status.

string

The metric the score is in.

integer

The current rules version.

string

When the standings were computed, or null before the first computation.

boolean

True once the competition ended.

array

Show entry

integer

Position, starting at 1. Null below the minimums.

boolean

Whether the participant is ranked.

string

Your id of the participant.

string

Their CabalSpy ID account id.

number

The value of the competition’s metric.

number

Sells minus buys during the competition, native and USD.

number

Buy plus sell volume, native and USD.

integer

Number of trades, buys and sells.

integer

Winning and closed positions.

number

Winning closed positions in percent.

integer

Tokens traded.

integer

Wallets the participant competed with.

object

limit, total (all entries), has_more and next_cursor. Page with offset.

{
  "success": true,
  "data": {
    "competition_id": "9c1d2e3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f",
    "status": "running",
    "metric": "pnl_usd",
    "rules_version": 1,
    "updated_at": "2026-11-02T09:15:00Z",
    "final": false,
    "standings": [
      {
        "rank": 1,
        "ranked": true,
        "external_id": "user_8412",
        "csid_id": "3f9a1c2e-5b7d-4e8f-a1b2-c3d4e5f60718",
        "score": 3968.6,
        "pnl": 48.2,
        "pnl_usd": 3968.6,
        "volume": 408.7,
        "volume_usd": 33649.8,
        "trades": 40,
        "buys": 22,
        "sells": 18,
        "win_count": 14,
        "closed_count": 18,
        "win_rate": 77.78,
        "tokens": 21,
        "wallets": 2
      },
      {
        "rank": null,
        "ranked": false,
        "external_id": "user_8413",
        "csid_id": "8e2b4d6f-1a3c-4e5f-9b7d-0c2e4a6b8d10",
        "score": 12.4,
        "pnl": 0.15,
        "pnl_usd": 12.4,
        "volume": 0.9,
        "volume_usd": 74.1,
        "trades": 2,
        "buys": 1,
        "sells": 1,
        "win_count": 1,
        "closed_count": 1,
        "win_rate": 100.0,
        "tokens": 1,
        "wallets": 1
      }
    ]
  },
  "pagination": { "limit": 50, "total": 2, "has_more": false, "next_cursor": null },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-11-02T09:16:02Z"
  }
}

Errors

Status	Code	Meaning
400	missing_parameter	id missing.
400	invalid_parameter	id, limit or offset invalid.
401	missing_api_key	API key missing.
403	invalid_api_key	API key invalid or not enabled for CabalSpy ID.
404	competition_not_found	No competition with this id in your instance.
429	rate_limit_exceeded	Rate limit exceeded.

See Errors for the full list.

Introduction

Login

Data API

Users

Trading

Theses

Streams

White-Label

Competitions

Reference

Query Parameters

Usage Example

Response

Errors

​Query Parameters

​Usage Example

​Response

​Errors

Query Parameters

Usage Example

Response

Errors