🔌 Crownsworn API
Read-only Crownsworn data for your own sites, bots and tools.
The API gives you the same data the game shows players: the card catalog, packs and their odds, leaderboards and the Rift, the Auction House and the Crown's Vault, public profiles, the news, and everything in your own account. It can't change anything.
Every request needs one of your keys, sent in a header:
curl -H "Authorization: Bearer cs_YOUR_KEY" https://play.crownsworn.games/api/v1/cards?rarity=mythic
Replies are JSON. Every reply carries your limits in its headers (X-RateLimit-Remaining-Day, X-RateLimit-Remaining-Minute…).
A request over a limit gets 429 with Retry-After (seconds). Requests turned away don't count. The day resets at midnight Eastern time, like the game's day.
Tiers
Passes are sold in the game's shop, by card or with Credits. Buy one with auto-renew (card only) and it renews at the same price every 30, 60 or 120 days until you turn it off here; turning it off stops the next charge and your pass runs to its end. Buying more days of the tier you have adds them; a higher tier converts the time you have left at its price per day.
Your keys
Loading…
Endpoints
Base address: https://play.crownsworn.games/api/v1. Lists come 100 (cards, collection) or 48 (market, vault) at a time: add ?page=1 for the next.
Try it
The rules
- Stay within your tier's limits. Don't share keys or spread one service's requests across several accounts to get around them.
- Credit the data: "Data from Crownsworn" with a link to crownsworn.games.
- Don't resell the raw data, and don't use it to buy, sell or trade anything from the game for real money.
- Keys can be revoked for abuse. The full terms are in the Terms of Service.