Clash Arena API

Locked Data Access

This API exposes Clash Arena datasets behind API-key auth. Public route names are clean and stable. Database collection names stay internal. Every dataset route requires a scoped key.

Open API Explorer View OpenAPI JSON
API Key Send the full token in X-API-Key or as a Bearer token.

Quick Start

curl -H "X-API-Key: ca_live_..." "https://api.clasharena.net/v1/ratings?limit=5" curl -H "Authorization: Bearer ca_live_..." "https://api.clasharena.net/v1/matches/12345" curl -H "X-API-Key: ca_live_..." "https://api.clasharena.net/v1/clans?filter.tag=%232JYQ2QQLY"

Supported list query params: limit, offset, sort, order, and filter.FIELD=value. Use id in filters and responses instead of Mongo _id.

Browser homepage is public documentation only. Dataset endpoints stay locked behind API keys.

Datasets

GET

Players

Registered Clash Arena player accounts.

/v1/players
Scope: dataset:players:read
Lookup fields: tag, id
Legacy aliases: arena_players
GET

Clans

Registered Clash Arena clans and ownership data.

/v1/clans
Scope: dataset:clans:read
Lookup fields: tag, id
Legacy aliases: arena_clans
GET

Preferences

Per-user bot preference overrides such as language.

/v1/preferences
Scope: dataset:preferences:read
Lookup fields: userId, id
Legacy aliases: arena_user_prefs, user-prefs
GET

Queue

Current matchmaking queue entries.

/v1/queue
Scope: dataset:queue:read
Lookup fields: id, clanTag
Legacy aliases: arena_queue
GET

Matches

Created and completed Clash Arena matches.

/v1/matches
Scope: dataset:matches:read
Lookup fields: matchId, id
Legacy aliases: arena_matches
GET

Ratings

Player and clan ELO per season and mode.

/v1/ratings
Scope: dataset:ratings:read
Lookup fields: id, entityId
Legacy aliases: arena_ratings
GET

Support Requests

Submitted support cases for match review.

/v1/supportRequests
Scope: dataset:supportRequests:read
Lookup fields: id, matchId, clanTag
Legacy aliases: arena_support_requests, support-requests
GET

Audit Log

Developer audit events and moderation-side traces.

/v1/auditLog
Scope: dataset:auditLog:read
Lookup fields: id
Legacy aliases: arena_dev_audit, dev-audit, audit-log
GET

Giveaways

Giveaway definitions and winner state.

/v1/giveaways
Scope: dataset:giveaways:read
Lookup fields: id, messageId
Legacy aliases: arena_giveaways
GET

Giveaway Entries

Giveaway entrants per giveaway.

/v1/giveawayEntries
Scope: dataset:giveawayEntries:read
Lookup fields: id, giveawayId, userId
Legacy aliases: arena_giveaway_entries, giveaway-entries
GET

Counters

Internal numeric counters such as match ids.

/v1/counters
Scope: dataset:counters:read
Lookup fields: id
Legacy aliases: arena_counters
GET

Runtime Flags

Runtime feature and maintenance flags.

/v1/runtimeFlags
Scope: dataset:runtimeFlags:read
Lookup fields: id
Legacy aliases: arena_runtime_flags, runtime-flags
GET

API Keys

API key metadata. Secret material is never exposed.

/v1/apiKeys
Scope: dataset:apiKeys:read
Lookup fields: keyId, id
Legacy aliases: arena_api_keys, api-keys