get_coins
Retrieve cryptocurrency data with market statistics, filtering by symbols, tags, or tiers, and customize results with sorting and time period options.
Instructions
Get a list of coins. Coins are by default ordered by their rank, which - somewhat simplified - means that they are ordered on marketcap. The response not only returns a list of coins, but also statistics regarding the requested list, such as the volume in the last 24 hours.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| referenceCurrencyUuid | No | UUID of reference currency, in which all the prices are calculated. This includes the price, the change and the sparkline. Defaults to US Dollar Default value: yhjMzLPhuIDl | |
| timePeriod | No | By setting the timeperiod the change percentage and sparkline in the response will be calculated accordingly Default value: 24h Allowed values: 3h 24h 7d 30d 3m 1y 3y 5y | |
| symbols | No | Symbols to filter the list on. Array parameters should be suffixed with brackets. Example: ?symbols[]=BTC&symbols[]=ETH. | |
| uuids | No | UUIDs to filter the list on. If you know the UUIDs of the coins you want to fetch, you can use this filter to get the specific coins. Array parameters should be suffixed with brackets. Example: ?uuids[]=razxDUgYGNAdQ&uuids[]=Qwsogvtv82FCd. | |
| tiers | No | We seperate coins into three tiers. With this parameter you can filter coins on the tiers you need. Read more about out our tiers in our methodology Array parameters should be suffixed with brackets. Example: ?tiers[]=1&tiers[]=2. | |
| tags | No | Tags to filter the list on. Allowed values: defi, stablecoin, nft, dex, exchange, staking, dao, meme, privacy Array parameters should be suffixed with brackets. Example: ?tags[]=defi&tags[]=nft. | |
| orderBy | No | Index to order by. All sortings excluding listedAt still take our different tiers of coins into account, read more about it in our methodology. Default value: marketCap Allowed values: price marketCap 24hVolume change listedAt | |
| orderDirection | No | Applies direction to the orderBy query, which can be in ascending or descending order. Default value: desc Allowed values: desc asc | |
| limit | No | Limit. Used for pagination. Default value: 50 Size range: 0-100 | 50 |
| offset | No | Offset. Used for pagination. Default value: 0 | 0 |