csxp.gg API

The data behind csxp.gg as JSON: player XP and its history, every leaderboard, collectible holder counts, and a feed of each profile change as it is recorded.

Tracked accounts
1,634,814,348
Leaderboards
30
Collectibles
574
Endpoints
21

Access and pricing

The API is paid, and there is no price list. Tell us what you are building, which endpoints you need and roughly how many requests you expect a month, and we will reply with a quote.

Email [email protected], message @csxp_gg on Twitter, or message snek239 on Discord.

Keys are issued by hand. Each one has a requests-per-minute limit, the endpoint groups it may call, and a monthly quota and an expiry date where those were agreed.

Endpoint groupCovers
playersPlayer profiles, histories, batch lookups and comparisons
lookupsQueue a fresh lookup when a requested player is not tracked yet
leaderboardsLeaderboards and per-collectible rankings
collectiblesCollectible catalogue, holder history and holder changes
siteActivity and site-wide statistics
searchName search, collectible holder search and vanity resolution
feedsSnapshot feed of every newly recorded profile change

The API covers the same accounts as the site. Coverage is incomplete and a profile can be weeks out of date; the FAQ explains how often data is refreshed, and every response says when its data was last updated.

One endpoint needs no key: GET /api/{steamid64} returns a player's current leaderboard ranks and XP Overload streak.

Quick start

Send the key in the Authorization header. Every endpoint is a GET under https://csxp.gg/api/v1.

export CSXP_API_KEY="csxp_…"

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/players/76561197960287930"

The response is a JSON object with the result in data and paging and freshness details in meta. Your key shows what a key may call and how much of its quota is left.

Authentication

Every request under /api/v1 needs a key, sent as Authorization: Bearer <key>. The X-API-Key: <key> header works too. Keys are not accepted in the URL.

A key is a secret. Call the API from a server, not from a web page or an app that users can inspect; responses carry no CORS headers. If a key leaks, tell us at [email protected] or on Twitter or Discord and we will revoke it and issue another.

Rate limits and quotas

A key's per-minute allowance refills continuously. A key allowed 60 requests a minute can send 60 at once and then one a second. A request over the limit gets a 429 with Retry-After set to the seconds until the next one is allowed.

A key with a monthly quota is cut off when it reaches it and starts again on the first of the next month, UTC. Requests answered with a 429 or a 5xx status do not count toward the quota; every other response does, including a 400 or a 404.

Response headerMeaning
X-RateLimit-LimitRequests allowed per minute.
X-RateLimit-RemainingRequests that can be sent right now.
X-RateLimit-ResetSeconds until the full allowance is available again.
X-Quota-LimitRequests allowed this month. Sent only for keys with a quota, like the two below.
X-Quota-RemainingRequests left this month.
X-Quota-ResetUnix time at which the quota starts again.

Responses

Successful responses are {"data": …, "meta": {…}}. Lists page with limit and offset, with page, or with a cursor, as each endpoint describes.

  • SteamID64s are strings. They are larger than the integers JavaScript can hold exactly.
  • Times are Unix seconds in UTC. Dates are YYYY-MM-DD in UTC.
  • A value we have not observed is null, never a zero or an empty string.
  • url fields link to the matching page on csxp.gg, and image addresses are absolute.
  • Responses are specific to a key and marked Cache-Control: private, no-store.

Fields can be added to a response at any time, so ignore the ones you do not know. Removing or renaming a field will come with a new version path.

The example responses on this page are real ones with long lists cut to a few rows, so a total in meta can be larger than the rows shown. Player names and SteamID64s in them are placeholders.

Errors

A failed request returns {"error": {"code": …, "message": …}}. Branch on the code; the message is written for people and may change.

StatusCodeMeaning
400invalid_requestA parameter is missing or malformed. The message says which.
401missing_api_keyNo key was sent.
401invalid_api_keyThe key is not recognised.
401revoked_api_keyThe key has been revoked.
401expired_api_keyThe key has passed its expiry date.
403scope_not_grantedThe key does not include this endpoint's group.
404not_foundNo such player, leaderboard, collectible or endpoint.
405method_not_allowedThe API is read-only. Use GET.
404lookup_queuedThe player is not tracked yet and a lookup was queued. Retry after Retry-After seconds.
410cursor_expiredA feed cursor older than the feed keeps. The message gives the oldest usable one.
429rate_limitedThe per-minute rate limit was reached. Retry after Retry-After seconds.
429quota_exceededThe monthly quota is used up. It resets at X-Quota-Reset.
503unavailableThe data or an upstream service is temporarily unavailable. Retry after Retry-After seconds.

Key

Your key

GET/api/v1/key

The calling key's endpoint groups, rate limit and this month's usage. Every key can call it, and it counts as a request.

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/key"

Example response

{
  "data": {
    "created_at": 1793491200,
    "expires_at": null,
    "name": "Acme Analytics",
    "prefix": "csxp_1a2b3c4d",
    "quota": {
      "monthly_requests": 500000,
      "remaining": 371580,
      "resets_at": 1796083200,
      "used": 128420
    },
    "rate_limit": {
      "requests_per_minute": 120
    },
    "scopes": [
      "players",
      "leaderboards",
      "collectibles",
      "site",
      "search"
    ]
  },
  "meta": {}
}

Players

Player profiles, histories, batch lookups and comparisons. Needs the players endpoint group.

Player profile

GET/api/v1/players/{steamid64}

A player's current level, XP, Commends, bans, 2026 service medal progress, XP Overload streak, leaderboard ranks and share of tracked accounts at or above their XP. steam or cs is null when that half has not been collected yet. For a player the site does not track, a key with the lookups group queues a lookup and the response is a 404 with code lookup_queued; retry after a few seconds.

Parameters

steamid64requiredstring, pathThe player's SteamID64, such as 76561197960287930.

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/players/76561197960287930"

Example response

{
  "data": {
    "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
    "cs": {
      "collectible_count": 35,
      "commends": {
        "friendly": 405,
        "leader": 329,
        "teaching": 333,
        "total": 1067
      },
      "exact_xp": true,
      "level": 29,
      "level_xp": 2016,
      "total_level": 1429,
      "total_xp": 7147016,
      "updated_at": 1792489959
    },
    "lookup_pending": false,
    "name": "Kestrel",
    "ranks": [
      {
        "board": "overall",
        "rank": 1,
        "title": "CS2 XP Leaderboard",
        "url": "https://csxp.gg/total#player-76561197960287930"
      },
      {
        "board": "purple_medals",
        "rank": 1,
        "title": "Purple Medal Leaderboard",
        "url": "https://csxp.gg/medals/purple#player-76561197960287930"
      },
      {
        "board": "blue_medals",
        "rank": 307,
        "title": "Blue Medal Leaderboard",
        "url": "https://csxp.gg/medals/blue#player-76561197960287930"
      }
    ],
    "service_medal_2026": {
      "next_tier": 1,
      "next_tier_xp": 200000,
      "tier": 0,
      "xp": 142016
    },
    "steam": {
      "bans": {
        "community_banned": false,
        "days_since_last_ban": null,
        "economy_ban": null,
        "game_bans": 0,
        "vac_bans": 0
      },
      "updated_at": 1790079997
    },
    "steamid64": "76561197960287930",
    "top_percent": 0.000171,
    "url": "https://csxp.gg/players/76561197960287930",
    "xp_overload": {
      "active_weeks": null,
      "longest_weeks": 1,
      "match_url": null,
      "observed_at": null,
      "source": "xp_estimate"
    }
  },
  "meta": {
    "tracked_accounts": 584626
  }
}

Players in bulk

GET/api/v1/players

Summaries of up to 100 players in one request, in the order asked for. Players the site does not track are listed in meta.not_tracked.

Parameters

idsrequiredstring, query1 to 100 SteamID64s, separated by commas.

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/players?ids=76561197960287930,76561197960435530"

Example response

{
  "data": [
    {
      "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
      "bans": {
        "community_banned": false,
        "days_since_last_ban": null,
        "economy_ban": null,
        "game_bans": 0,
        "vac_bans": 0
      },
      "collectible_count": 35,
      "commends": {
        "friendly": 405,
        "leader": 329,
        "teaching": 333,
        "total": 1067
      },
      "cs_updated_at": 1769079159,
      "level": 29,
      "level_xp": 2016,
      "name": "Kestrel",
      "steam_updated_at": 1790079997,
      "steamid64": "76561197960287930",
      "total_level": 1429,
      "total_xp": 7147016,
      "url": "https://csxp.gg/players/76561197960287930",
      "xp_overload": {
        "active_weeks": null,
        "longest_weeks": 1,
        "match_url": null,
        "observed_at": null,
        "source": "xp_estimate"
      }
    },
    {
      "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
      "bans": {
        "community_banned": false,
        "days_since_last_ban": null,
        "economy_ban": null,
        "game_bans": 0,
        "vac_bans": 0
      },
      "collectible_count": 27,
      "commends": {
        "friendly": 231,
        "leader": 178,
        "teaching": 163,
        "total": 572
      },
      "cs_updated_at": 1769132289,
      "level": 2,
      "level_xp": 3921,
      "name": "Marlow",
      "steam_updated_at": 1790075012,
      "steamid64": "76561197960435530",
      "total_level": 1362,
      "total_xp": 6813921,
      "url": "https://csxp.gg/players/76561197960435530",
      "xp_overload": null
    }
  ],
  "meta": {
    "count": 2,
    "not_tracked": []
  }
}

Player XP history

GET/api/v1/players/{steamid64}/xp-history

Every recorded state of the player's level, XP and Commends, oldest first. Each row covers the period from observed_from to observed_until during which nothing changed. At most the newest 5,000 rows are returned; meta.truncated says when older ones were left out.

Parameters

steamid64requiredstring, pathThe player's SteamID64, such as 76561197960287930.
frominteger, queryOnly rows observed at or after this Unix time.
tointeger, queryOnly rows observed at or before this Unix time.

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/players/76561197960287930/xp-history"

Example response

{
  "data": [
    {
      "collectible_count": 34,
      "commends": {
        "friendly": 400,
        "leader": 324,
        "teaching": 328,
        "total": 1052
      },
      "exact_xp": true,
      "level": 9,
      "level_xp": 2326,
      "observed_from": 1787747564,
      "observed_until": 1787747564,
      "total_level": 1409,
      "total_xp": 7047326
    },
    {
      "collectible_count": 34,
      "commends": {
        "friendly": 400,
        "leader": 324,
        "teaching": 328,
        "total": 1052
      },
      "exact_xp": true,
      "level": 9,
      "level_xp": 4366,
      "observed_from": 1787754283,
      "observed_until": 1787754283,
      "total_level": 1409,
      "total_xp": 7049366
    }
  ],
  "meta": {
    "count": 28,
    "truncated": false
  }
}

Player collectibles

GET/api/v1/players/{steamid64}/collectibles

The medals, coins, pins and trophies the player holds, each with its holder count, and every recorded change to that set.

Parameters

steamid64requiredstring, pathThe player's SteamID64, such as 76561197960287930.

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/players/76561197960287930/collectibles"

Example response

{
  "data": {
    "changes": [
      {
        "added": [
          {
            "category": "pickem_coin",
            "holders": 28707,
            "id": 5211,
            "image_url": "https://csxp.gg/images/bud2025_coin_silver_small_png.png",
            "name": "Budapest 2025 Silver Coin",
            "section": "Budapest 2025",
            "share_percent": 4.910319,
            "slug": "bud2025_coin_silver",
            "url": "https://csxp.gg/collectibles/bud2025_coin_silver"
          }
        ],
        "at": 1787763161,
        "previous_at": 1787754283,
        "removed": [
          {
            "category": "pickem_coin",
            "holders": 3501,
            "id": 5210,
            "image_url": "https://csxp.gg/images/bud2025_coin_bronze_small_png.png",
            "name": "Budapest 2025 Coin",
            "section": "Budapest 2025",
            "share_percent": 0.598844,
            "slug": "bud2025_coin_bronze",
            "url": "https://csxp.gg/collectibles/bud2025_coin_bronze"
          }
        ]
      },
      {
        "added": [
          {
            "category": "premier_medal",
            "holders": 3348,
            "id": 5150,
            "image_url": "https://csxp.gg/images/premier_season_3_coin_25_small_png.png",
            "name": "Premier Season Three Medal · 5,000–9,999 · 125+ wins",
            "section": "Season 3 · 5,000–9,999",
            "share_percent": 0.572674,
            "slug": "premier_season_3_coin_25",
            "url": "https://csxp.gg/collectibles/premier_season_3_coin_25"
          }
        ],
        "at": 1792489959,
        "previous_at": 1790813381,
        "removed": []
      }
    ],
    "collectibles": [
      {
        "category": "badge",
        "holders": 421108,
        "id": 874,
        "image_url": "https://csxp.gg/images/5yearcoin_small_png.png",
        "name": "5 Year Veteran Coin",
        "section": null,
        "share_percent": 72.030324,
        "slug": "5-year-veteran-coin",
        "url": "https://csxp.gg/collectibles/5-year-veteran-coin"
      },
      {
        "category": "badge",
        "holders": 155862,
        "id": 969,
        "image_url": "https://csxp.gg/images/10yearcoin_small_png.png",
        "name": "10 Year Veteran Coin",
        "section": null,
        "share_percent": 26.660121,
        "slug": "10-year-veteran-coin",
        "url": "https://csxp.gg/collectibles/10-year-veteran-coin"
      },
      {
        "category": "badge",
        "holders": 341624,
        "id": 970,
        "image_url": "https://csxp.gg/images/prime_badge_small_png.png",
        "name": "Loyalty Badge",
        "section": null,
        "share_percent": 58.434623,
        "slug": "loyalty-badge",
        "url": "https://csxp.gg/collectibles/loyalty-badge"
      }
    ],
    "steamid64": "76561197960287930",
    "updated_at": 1792489959
  },
  "meta": {
    "changes_truncated": false,
    "count": 35,
    "tracked_accounts": 584626
  }
}

Player rank history

GET/api/v1/players/{steamid64}/rank-history

The player's rank on each leaderboard at every publication they were ranked in, as [recorded_at, rank] pairs, oldest first.

Parameters

steamid64requiredstring, pathThe player's SteamID64, such as 76561197960287930.
boardstring, queryOnly this leaderboard, by its key from /api/v1/leaderboards.
frominteger, queryOnly rows observed at or after this Unix time.
tointeger, queryOnly rows observed at or before this Unix time.

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/players/76561197960287930/rank-history?board=overall"

Example response

{
  "data": [
    {
      "board": "overall",
      "current_rank": 1,
      "points": [
        [
          1787747328,
          1
        ],
        [
          1787754272,
          1
        ],
        [
          1787763154,
          1
        ]
      ],
      "title": "CS2 XP Leaderboard"
    }
  ],
  "meta": {
    "truncated": false
  }
}

Player Steam profile history

GET/api/v1/players/{steamid64}/profile-history

Every recorded Steam name, avatar and ban state of the player, oldest first.

Parameters

steamid64requiredstring, pathThe player's SteamID64, such as 76561197960287930.

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/players/76561197960287930/profile-history"

Example response

{
  "data": [
    {
      "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
      "bans": {
        "community_banned": false,
        "days_since_last_ban": null,
        "economy_ban": null,
        "game_bans": 0,
        "vac_bans": 0
      },
      "name": "Kestrel",
      "observed_from": 1787746119,
      "observed_until": 1790079997
    }
  ],
  "meta": {
    "count": 1,
    "truncated": false
  }
}

Compare two players

GET/api/v1/compare/{a}/{b}

Both players' summaries and the collectibles they share or hold alone.

Parameters

arequiredstring, pathThe first player's SteamID64.
brequiredstring, pathThe second player's SteamID64.

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/compare/76561197960287930/76561197960435530"

Example response

{
  "data": {
    "collectibles": {
      "only_first": [
        {
          "category": "operation_coin",
          "holders": 10896,
          "id": 1013,
          "image_url": "https://csxp.gg/images/operation_bravo_bronze_small_png.png",
          "name": "Operation Bravo Challenge Coin",
          "section": "Operation Bravo",
          "share_percent": 1.863756,
          "slug": "operation_bravo_bronze",
          "url": "https://csxp.gg/collectibles/operation_bravo_bronze"
        },
        {
          "category": "operation_coin",
          "holders": 14842,
          "id": 1024,
          "image_url": "https://csxp.gg/images/operation_phoenix_bronze_small_png.png",
          "name": "Operation Phoenix Challenge Coin",
          "section": "Operation Phoenix",
          "share_percent": 2.538717,
          "slug": "operation_phoenix_bronze",
          "url": "https://csxp.gg/collectibles/operation_phoenix_bronze"
        }
      ],
      "only_second": [
        {
          "category": "operation_coin",
          "holders": 3019,
          "id": 1014,
          "image_url": "https://csxp.gg/images/operation_bravo_silver_small_png.png",
          "name": "Silver Operation Bravo Coin",
          "section": "Operation Bravo",
          "share_percent": 0.516399,
          "slug": "operation_bravo_silver",
          "url": "https://csxp.gg/collectibles/operation_bravo_silver"
        },
        {
          "category": "operation_coin",
          "holders": 4949,
          "id": 1026,
          "image_url": "https://csxp.gg/images/operation_phoenix_gold_small_png.png",
          "name": "Gold Operation Phoenix Coin",
          "section": "Operation Phoenix",
          "share_percent": 0.846524,
          "slug": "operation_phoenix_gold",
          "url": "https://csxp.gg/collectibles/operation_phoenix_gold"
        }
      ],
      "shared": [
        {
          "category": "badge",
          "holders": 421108,
          "id": 874,
          "image_url": "https://csxp.gg/images/5yearcoin_small_png.png",
          "name": "5 Year Veteran Coin",
          "section": null,
          "share_percent": 72.030324,
          "slug": "5-year-veteran-coin",
          "url": "https://csxp.gg/collectibles/5-year-veteran-coin"
        },
        {
          "category": "badge",
          "holders": 155862,
          "id": 969,
          "image_url": "https://csxp.gg/images/10yearcoin_small_png.png",
          "name": "10 Year Veteran Coin",
          "section": null,
          "share_percent": 26.660121,
          "slug": "10-year-veteran-coin",
          "url": "https://csxp.gg/collectibles/10-year-veteran-coin"
        }
      ]
    },
    "players": [
      {
        "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
        "bans": {
          "community_banned": false,
          "days_since_last_ban": null,
          "economy_ban": null,
          "game_bans": 0,
          "vac_bans": 0
        },
        "collectible_count": 35,
        "commends": {
          "friendly": 405,
          "leader": 329,
          "teaching": 333,
          "total": 1067
        },
        "cs_updated_at": 1769079159,
        "level": 29,
        "level_xp": 2016,
        "name": "Kestrel",
        "steam_updated_at": 1790079997,
        "steamid64": "76561197960287930",
        "total_level": 1429,
        "total_xp": 7147016,
        "url": "https://csxp.gg/players/76561197960287930",
        "xp_overload": {
          "active_weeks": null,
          "longest_weeks": 1,
          "match_url": null,
          "observed_at": null,
          "source": "xp_estimate"
        }
      },
      {
        "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
        "bans": {
          "community_banned": false,
          "days_since_last_ban": null,
          "economy_ban": null,
          "game_bans": 0,
          "vac_bans": 0
        },
        "collectible_count": 27,
        "commends": {
          "friendly": 231,
          "leader": 178,
          "teaching": 163,
          "total": 572
        },
        "cs_updated_at": 1769132289,
        "level": 2,
        "level_xp": 3921,
        "name": "Marlow",
        "steam_updated_at": 1790075012,
        "steamid64": "76561197960435530",
        "total_level": 1362,
        "total_xp": 6813921,
        "url": "https://csxp.gg/players/76561197960435530",
        "xp_overload": null
      }
    ],
    "url": "https://csxp.gg/compare/76561197960287930/76561197960435530"
  },
  "meta": {
    "tracked_accounts": 584626
  }
}

Leaderboards

Leaderboards and per-collectible rankings. Needs the leaderboards endpoint group.

Leaderboards

GET/api/v1/leaderboards

Every leaderboard with its key, what it ranks by and how many players qualify for it.

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/leaderboards"

Example response

{
  "data": [
    {
      "board": "overall",
      "description": "Sorted by total XP level. Remaining XP breaks ties.",
      "player_count": 584626,
      "title": "CS2 XP Leaderboard",
      "url": "https://csxp.gg/total",
      "value_label": "Level"
    },
    {
      "board": "commendations",
      "description": "Sorted by total commends. Friendly, leader, and teacher counts break ties.",
      "player_count": 573494,
      "title": "Commends Leaderboard",
      "url": "https://csxp.gg/commendations",
      "value_label": "Total Commends"
    }
  ],
  "meta": {
    "count": 30,
    "max_entries": 1000
  }
}

Leaderboard entries

GET/api/v1/leaderboards/{board}

The top 1,000 players of a leaderboard. rank orders by the board's value alone; site_rank is the place on csxp.gg, which lists accounts with a possible Counter-Strike ban after everyone else. rank_change is the places gained since about a day earlier (negative when lost).

Parameters

boardrequiredstring, pathThe leaderboard's key, such as overall or service_medal_2026.
limitinteger, queryRows to return, 1 to 1,000. Default 100.
offsetinteger, queryRows to skip. Default 0.

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/leaderboards/overall?limit=2"

Example response

{
  "data": [
    {
      "ban_note": null,
      "new_entry": false,
      "player": {
        "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
        "bans": {
          "community_banned": false,
          "days_since_last_ban": null,
          "economy_ban": null,
          "game_bans": 0,
          "vac_bans": 0
        },
        "collectible_count": 35,
        "commends": {
          "friendly": 405,
          "leader": 329,
          "teaching": 333,
          "total": 1067
        },
        "cs_updated_at": 1769079159,
        "level": 29,
        "level_xp": 2016,
        "name": "Kestrel",
        "steam_updated_at": 1790079997,
        "steamid64": "76561197960287930",
        "total_level": 1429,
        "total_xp": 7147016,
        "url": "https://csxp.gg/players/76561197960287930",
        "xp_overload": {
          "active_weeks": null,
          "longest_weeks": 1,
          "match_url": null,
          "observed_at": null,
          "source": "xp_estimate"
        }
      },
      "possible_cs_ban": false,
      "rank": 1,
      "rank_change": null,
      "site_rank": 1,
      "tier": null,
      "value": 1429
    },
    {
      "ban_note": null,
      "new_entry": false,
      "player": {
        "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
        "bans": {
          "community_banned": false,
          "days_since_last_ban": null,
          "economy_ban": null,
          "game_bans": 0,
          "vac_bans": 0
        },
        "collectible_count": 27,
        "commends": {
          "friendly": 231,
          "leader": 178,
          "teaching": 163,
          "total": 572
        },
        "cs_updated_at": 1769132289,
        "level": 2,
        "level_xp": 3921,
        "name": "Marlow",
        "steam_updated_at": 1790075012,
        "steamid64": "76561197960435530",
        "total_level": 1362,
        "total_xp": 6813921,
        "url": "https://csxp.gg/players/76561197960435530",
        "xp_overload": null
      },
      "possible_cs_ban": false,
      "rank": 2,
      "rank_change": null,
      "site_rank": 2,
      "tier": null,
      "value": 1362
    }
  ],
  "meta": {
    "leaderboard": {
      "board": "overall",
      "description": "Sorted by total XP level. Remaining XP breaks ties.",
      "player_count": 584626,
      "title": "CS2 XP Leaderboard",
      "url": "https://csxp.gg/total",
      "value_label": "Level"
    },
    "limit": 2,
    "next_offset": 2,
    "offset": 0,
    "total": 1000,
    "updated_at": 1794470201
  }
}

Collectible holders by XP

GET/api/v1/collectibles/{slug}/leaderboard

The top 1,000 holders of a medal, pick'em coin or operation coin by total XP. Other collectibles have no such ranking and return a 404.

Parameters

slugrequiredstring, pathThe collectible's slug, as listed by /api/v1/collectibles.
limitinteger, queryRows to return, 1 to 1,000. Default 100.
offsetinteger, queryRows to skip. Default 0.

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/collectibles/service_medal_2026_lvl2/leaderboard?limit=2"

Example response

{
  "data": [
    {
      "ban_note": null,
      "new_entry": false,
      "player": {
        "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
        "bans": {
          "community_banned": false,
          "days_since_last_ban": null,
          "economy_ban": null,
          "game_bans": 0,
          "vac_bans": 0
        },
        "collectible_count": 30,
        "commends": {
          "friendly": 211,
          "leader": 180,
          "teaching": 178,
          "total": 569
        },
        "cs_updated_at": 1781245373,
        "level": 21,
        "level_xp": 699,
        "name": "Juniper",
        "steam_updated_at": 1815893150,
        "steamid64": "76561197960265731",
        "total_level": 1301,
        "total_xp": 6505699,
        "url": "https://csxp.gg/players/76561197960265731",
        "xp_overload": {
          "active_weeks": null,
          "longest_weeks": 2,
          "match_url": null,
          "observed_at": null,
          "source": "xp_estimate"
        }
      },
      "possible_cs_ban": false,
      "rank": 1,
      "rank_change": null,
      "site_rank": 1,
      "tier": null,
      "value": 1301
    },
    {
      "ban_note": null,
      "new_entry": false,
      "player": {
        "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
        "bans": {
          "community_banned": false,
          "days_since_last_ban": null,
          "economy_ban": null,
          "game_bans": 0,
          "vac_bans": 0
        },
        "collectible_count": 31,
        "commends": {
          "friendly": 155,
          "leader": 146,
          "teaching": 152,
          "total": 453
        },
        "cs_updated_at": 1781243972,
        "level": 11,
        "level_xp": 334,
        "name": "Sable",
        "steam_updated_at": 1815893113,
        "steamid64": "76561197960265738",
        "total_level": 1251,
        "total_xp": 6255334,
        "url": "https://csxp.gg/players/76561197960265738",
        "xp_overload": {
          "active_weeks": null,
          "longest_weeks": 2,
          "match_url": null,
          "observed_at": null,
          "source": "xp_estimate"
        }
      },
      "possible_cs_ban": false,
      "rank": 2,
      "rank_change": null,
      "site_rank": 2,
      "tier": null,
      "value": 1251
    }
  ],
  "meta": {
    "leaderboard": {
      "collectible": "service_medal_2026_lvl2",
      "player_count": 63,
      "title": "2026 Service Medal Tier 2 holders by total XP",
      "url": "https://csxp.gg/medals/service_medal_2026_lvl2",
      "value_label": "Total Level"
    },
    "limit": 2,
    "next_offset": 2,
    "offset": 0,
    "total": 63,
    "updated_at": 1794470201
  }
}

Collectibles

Collectible catalogue, holder history and holder changes. Needs the collectibles endpoint group.

Collectibles

GET/api/v1/collectibles

The whole catalogue: every medal, coin, pin and trophy with its holder count, share of tracked accounts and rarity rank. Collectibles nobody tracked holds have no rank.

Parameters

categorystring, queryOne of service_medal, premier_medal, pickem_coin, operation_coin, major_trophy, pin, genuine_pin, map_coin or badge.
sortstring, querycatalog (default, in-game order) or rarity (rarest first).

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/collectibles?category=genuine_pin&sort=rarity"

Example response

{
  "data": [
    {
      "category": "genuine_pin",
      "holders": 515,
      "id": 6002,
      "image_url": "https://csxp.gg/images/collectible_pin_guardianelite_small_png.png",
      "name": "Genuine Guardian Elite Pin",
      "rarity_rank": 229,
      "section": null,
      "share_percent": 0.088091,
      "slug": "genuine-guardian-elite-pin",
      "url": "https://csxp.gg/collectibles/genuine-guardian-elite-pin"
    },
    {
      "category": "genuine_pin",
      "holders": 527,
      "id": 6001,
      "image_url": "https://csxp.gg/images/collectible_pin_dust2_small_png.png",
      "name": "Genuine Dust II Pin",
      "rarity_rank": 231,
      "section": null,
      "share_percent": 0.090143,
      "slug": "genuine-dust-ii-pin",
      "url": "https://csxp.gg/collectibles/genuine-dust-ii-pin"
    }
  ],
  "meta": {
    "count": 34,
    "tracked_accounts": 584626,
    "updated_at": 1794470201
  }
}

Collectible

GET/api/v1/collectibles/{slug}

One collectible: its description, when it could be earned, its other tiers or variants, related items from the same event, and this week's newest holders.

Parameters

slugrequiredstring, pathThe collectible's slug, as listed by /api/v1/collectibles.

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/collectibles/service_medal_2026_lvl2"

Example response

{
  "data": {
    "awarded_from": "2026-01-01",
    "awarded_until": "2026-12-31",
    "category": "service_medal",
    "description": [
      "Awarded for outstanding service and achievement in 2026."
    ],
    "has_leaderboard": true,
    "holders": 63,
    "id": 5271,
    "image_url": "https://csxp.gg/images/service_medal_2026_lvl2_small_png.png",
    "name": "2026 Service Medal Tier 2",
    "ranked_collectibles": 534,
    "rarity_rank": 210,
    "recent_holders": [],
    "related": [],
    "section": "2026",
    "share_percent": 0.010776,
    "short_label": "Tier 2",
    "siblings": [
      {
        "category": "service_medal",
        "holders": 23462,
        "id": 5270,
        "image_url": "https://csxp.gg/images/service_medal_2026_lvl1_small_png.png",
        "name": "2026 Service Medal Tier 1",
        "section": "2026",
        "share_percent": 4.013164,
        "slug": "service_medal_2026_lvl1",
        "url": "https://csxp.gg/collectibles/service_medal_2026_lvl1"
      },
      {
        "category": "service_medal",
        "holders": 9,
        "id": 5272,
        "image_url": "https://csxp.gg/images/service_medal_2026_lvl3_small_png.png",
        "name": "2026 Service Medal Tier 3",
        "section": "2026",
        "share_percent": 0.001539,
        "slug": "service_medal_2026_lvl3",
        "url": "https://csxp.gg/collectibles/service_medal_2026_lvl3"
      }
    ],
    "slug": "service_medal_2026_lvl2",
    "url": "https://csxp.gg/collectibles/service_medal_2026_lvl2"
  },
  "meta": {
    "tracked_accounts": 584626,
    "updated_at": 1794470201
  }
}

Collectible holder history

GET/api/v1/collectibles/{slug}/history

The holder count over time. With meta.resolution of daily, there is one point per UTC day with that day's gains, losses and ban changes; otherwise the points are sampled counts.

Parameters

slugrequiredstring, pathThe collectible's slug, as listed by /api/v1/collectibles.

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/collectibles/service_medal_2026_lvl2/history"

Example response

{
  "data": [
    {
      "at": 1794095999,
      "banned": 0,
      "gained": 2,
      "holders": 61,
      "holders_excluding_banned": 60,
      "lost": 0,
      "restored": 0
    },
    {
      "at": 1794182399,
      "banned": 0,
      "gained": 1,
      "holders": 62,
      "holders_excluding_banned": 61,
      "lost": 0,
      "restored": 0
    },
    {
      "at": 1794268799,
      "banned": 1,
      "gained": 1,
      "holders": 63,
      "holders_excluding_banned": 61,
      "lost": 0,
      "restored": 0
    }
  ],
  "meta": {
    "collectible": "service_medal_2026_lvl2",
    "count": 120,
    "resolution": "daily"
  }
}

Collectible holder changes

GET/api/v1/collectibles/{slug}/changes

The accounts that gained or lost a collectible in a date range, oldest first, 50 per page, with the totals for the range in meta.summary. kind is first_seen when the account already held it at its first observation, and otherwise gained, lost, banned or restored. Pass meta.next_cursor as cursor for the next page.

Parameters

slugrequiredstring, pathThe collectible's slug, as listed by /api/v1/collectibles.
fromdate, queryFirst UTC day, as YYYY-MM-DD. Default 30 days before to.
todate, queryLast UTC day, as YYYY-MM-DD. Default today.
kindstring, queryOne of all (default), gained, lost, banned or restored.
exclude_bannedboolean, queryCount accounts with a possible Counter-Strike ban as non-holders.
cursorstring, querymeta.next_cursor of the previous page.

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/collectibles/service_medal_2026_lvl2/changes?from=2026-11-01&to=2026-11-07"

Example response

{
  "data": [
    {
      "at": 1793523641,
      "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_medium.jpg",
      "delta": 1,
      "kind": "gained",
      "name": "Juniper",
      "steamid64": "76561197960265731",
      "url": "https://csxp.gg/players/76561197960265731"
    },
    {
      "at": 1793610207,
      "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_medium.jpg",
      "delta": 1,
      "kind": "first_seen",
      "name": "Sable",
      "steamid64": "76561197960265738",
      "url": "https://csxp.gg/players/76561197960265738"
    }
  ],
  "meta": {
    "collectible": "service_medal_2026_lvl2",
    "count": 50,
    "from": "2026-11-01",
    "next_cursor": "1793995112:76561197960265738",
    "summary": {
      "banned": 0,
      "gained": 57,
      "lost": 0,
      "net": 57,
      "restored": 0
    },
    "to": "2026-11-07"
  }
}

Site data

Activity and site-wide statistics. Needs the site endpoint group.

Recent activity

GET/api/v1/activity

The week's biggest XP gains, leaderboard climbs, newly seen rare collectibles, 2026 service medal tier-ups and XP Overload streaks gained and lost, as shown on csxp.gg/activity.

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/activity"

Example response

{
  "data": {
    "rank_climbs": [
      {
        "board": "overall",
        "climbs": [
          {
            "from_rank": 412,
            "passed": {
              "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
              "name": "Sable",
              "steamid64": "76561197960265738",
              "url": "https://csxp.gg/players/76561197960265738"
            },
            "places": 7,
            "player": {
              "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
              "name": "Juniper",
              "steamid64": "76561197960265731",
              "url": "https://csxp.gg/players/76561197960265731"
            },
            "to_rank": 405
          }
        ],
        "since": 1793729723,
        "title": "CS2 XP Leaderboard"
      }
    ],
    "rare_collectibles": [
      {
        "collectible": {
          "category": "pickem_coin",
          "holders": 4,
          "id": 5312,
          "image_url": "https://csxp.gg/images/cologne2026_coin_bronze_small_png.png",
          "name": "Cologne 2026 Coin",
          "section": "Cologne 2026",
          "share_percent": 0.000684,
          "slug": "cologne2026_coin_bronze",
          "url": "https://csxp.gg/collectibles/cologne2026_coin_bronze"
        },
        "first_seen_at": 1794301122,
        "player": {
          "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
          "name": "Marlow",
          "steamid64": "76561197960435530",
          "url": "https://csxp.gg/players/76561197960435530"
        }
      }
    ],
    "service_medal_2026_tiers": [
      {
        "at": 1794412877,
        "from_tier": 1,
        "player": {
          "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
          "name": "Kestrel",
          "steamid64": "76561197960287930",
          "url": "https://csxp.gg/players/76561197960287930"
        },
        "to_tier": 2
      }
    ],
    "xp_gains": {
      "day": [
        {
          "from_at": 1794383991,
          "from_total_level": 1428,
          "from_total_xp": 7141204,
          "player": {
            "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
            "name": "Kestrel",
            "steamid64": "76561197960287930",
            "url": "https://csxp.gg/players/76561197960287930"
          },
          "to_at": 1794466310,
          "to_total_level": 1429,
          "to_total_xp": 7147016,
          "xp_gained": 5812
        }
      ],
      "week": [
        {
          "from_at": 1793866102,
          "from_total_level": 1421,
          "from_total_xp": 7108650,
          "player": {
            "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
            "name": "Kestrel",
            "steamid64": "76561197960287930",
            "url": "https://csxp.gg/players/76561197960287930"
          },
          "to_at": 1794466310,
          "to_total_level": 1429,
          "to_total_xp": 7147016,
          "xp_gained": 38366
        }
      ]
    },
    "xp_overload": {
      "gained": [
        {
          "at": 1794362400,
          "player": {
            "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
            "name": "Marlow",
            "steamid64": "76561197960435530",
            "url": "https://csxp.gg/players/76561197960435530"
          },
          "weeks": 4
        }
      ],
      "lost": [
        {
          "at": 1794362400,
          "player": {
            "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
            "name": "Sable",
            "steamid64": "76561197960265738",
            "url": "https://csxp.gg/players/76561197960265738"
          },
          "weeks": 11
        }
      ]
    }
  },
  "meta": {
    "players_measured": 90606,
    "tracked_accounts": 584626,
    "updated_at": 1794470201,
    "url": "https://csxp.gg/activity"
  }
}

Site statistics

GET/api/v1/stats

Totals across tracked accounts and the distributions of levels, Commends, collectibles and 2026 service medal tiers, as shown on csxp.gg/stats.

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/stats"

Example response

{
  "data": {
    "collectibles_per_account": [
      {
        "accounts": 516,
        "collectibles": 0
      },
      {
        "accounts": 32767,
        "collectibles": 1
      }
    ],
    "commends": {
      "accounts_by_total": [
        {
          "accounts": 11132,
          "from": 0,
          "to": 0
        },
        {
          "accounts": 104066,
          "from": 1,
          "to": 9
        }
      ],
      "friendly": {
        "accounts": 567821,
        "received": 39561326
      },
      "leader": {
        "accounts": 560555,
        "received": 38094844
      },
      "teaching": {
        "accounts": 557181,
        "received": 37791857
      }
    },
    "current_level": [
      {
        "accounts": 22123,
        "level": 0
      },
      {
        "accounts": 22346,
        "level": 1
      }
    ],
    "service_medal_2026_tier": [
      {
        "accounts": 561091,
        "tier": 0
      },
      {
        "accounts": 23462,
        "tier": 1
      }
    ],
    "total_level": {
      "accounts_by_level": [
        {
          "accounts": 0,
          "from": 0,
          "to": 0
        },
        {
          "accounts": 0,
          "from": 1,
          "to": 9
        }
      ],
      "leveled_accounts": 584626,
      "top_slices": [
        {
          "accounts": 58605,
          "top_percent": 10.0,
          "total_level": 565
        },
        {
          "accounts": 5868,
          "top_percent": 1.0,
          "total_level": 887
        }
      ]
    },
    "totals": {
      "collectibles_held": 5289445,
      "commends_received": 115448027,
      "levels_earned": 121739323,
      "service_medal_2026_holders": 23535,
      "tracked_accounts": 584626
    }
  },
  "meta": {
    "updated_at": 1794470201,
    "url": "https://csxp.gg/stats"
  }
}

Feeds

Snapshot feed of every newly recorded profile change. Needs the feeds endpoint group.

Snapshot feed

GET/api/v1/feeds/snapshots

Every newly recorded change to a tracked account's level, XP, Commends or collectibles, in the order it was stored, with what changed since the account's previous observation. Call it without after to get a starting cursor, then poll with the latest meta.next_after; when meta.caught_up is true, wait before asking again. Rows appear about 30 seconds after they are recorded. The feed keeps the most recent five million snapshots: an older cursor returns 410 cursor_expired.

Parameters

afterinteger, queryReturn snapshots with an id above this cursor. Omit to start at the newest.
limitinteger, queryRows to return, 1 to 500. Default 200.

Example request

curl -H "Authorization: Bearer $CSXP_API_KEY" \
  "https://csxp.gg/api/v1/feeds/snapshots?after=412345678&limit=2"

Example response

{
  "data": [
    {
      "collectibles": [
        874,
        970,
        5270
      ],
      "collectibles_added": [
        5270
      ],
      "collectibles_removed": [],
      "commends": {
        "friendly": 41,
        "leader": 38,
        "teaching": 35
      },
      "exact_xp": true,
      "id": 412345679,
      "level": 2,
      "level_xp": 312,
      "previous": {
        "commends": {
          "friendly": 41,
          "leader": 38,
          "teaching": 35
        },
        "exact_xp": true,
        "last_seen_at": 1794381200,
        "level": 40,
        "recorded_at": 1794294800,
        "total_level": 279,
        "total_xp": 1399104
      },
      "recorded_at": 1794467512,
      "steamid64": "76561197960265731",
      "total_level": 281,
      "total_xp": 1405312,
      "url": "https://csxp.gg/players/76561197960265731",
      "xp_gained": 6208
    },
    {
      "collectibles": [],
      "collectibles_added": null,
      "collectibles_removed": null,
      "commends": {
        "friendly": 0,
        "leader": 0,
        "teaching": 0
      },
      "exact_xp": true,
      "id": 412345683,
      "level": 3,
      "level_xp": 1190,
      "previous": null,
      "recorded_at": 1794467518,
      "steamid64": "76561197960265738",
      "total_level": 3,
      "total_xp": 16190,
      "url": "https://csxp.gg/players/76561197960265738",
      "xp_gained": null
    }
  ],
  "meta": {
    "caught_up": false,
    "count": 2,
    "next_after": 412345683,
    "oldest_after": 407350112
  }
}