# API

For engineers who are launching external services related to CryptoSpells, we will explain the details of the API that can be used with CryptoSpells.&#x20;

### Returns a list of Token IDs of card NFTs held by the user&#x20;

/public\_api/players/\[:user\_id]/cards.json&#x20;

\*Excludes items that are not in-game, listed for trade, or rented.&#x20;

### Return basic information about the player&#x20;

/public\_api/players/\[:user\_id].json&#x20;

### Return basic card information&#x20;

/public\_api/cards/\[:card\_number].json&#x20;

\*card\_number is the number displayed in the card encyclopedia.&#x20;

### Return card token information&#x20;

/public\_api/card\_tokens/\[:token\_id].json&#x20;

\*token\_id is a 9-digit token ID starting from 1.&#x20;

### Returns basic information about the guild&#x20;

/public\_api/guilds/\[:guild\_id].json

&#x20;\*guild\_id is 1,2,3,4,5, and corresponds to 1 = ruby, 2 = sapphire, 3 = emerald, 4 = diamond, 5 = onyx.&#x20;

### Returns data on win rate and usage rate for each color&#x20;

/public\_api/color\_stats?time=\[:time]\&type=\[:type]&.json&#x20;
