> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cryptorank.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Trending Currencies
> Returns coins with elevated interest right now.
Available from: Sandbox
Cost: 1 credit per request
Ranked by CryptoRank's internal Trending Score; reflects the moment of the request and can change quickly.
## OpenAPI
````yaml https://api.cryptorank.io/v3/documentation-json get /v3/currencies/trending
openapi: 3.0.0
info:
title: Cryptorank API V3
description: >
# Overview
Cryptorank Public API v3 — comprehensive cryptocurrency data for B2B clients
and partners.
Useful Links:
- [API Plans](https://cryptorank.io/public-api)
- [Dashboard](https://cryptorank.io/public-api/dashboard)
# Getting Started
Primary Server URL:
[https://api.cryptorank.io/v3/](https://api.cryptorank.io/v3/)
**Authentication**
Generate an API key in the
[dashboard](https://cryptorank.io/public-api/dashboard) and pass it in the
`X-Api-Key` header.
Keep your keys secret — never commit them to public repositories or expose
them in client-side code.
version: 3.0.0
contact:
name: Cryptorank Team
url: https://cryptorank.io
email: info@cryptorank.io
servers:
- url: https://api.cryptorank.io
security: []
tags: []
paths:
/v3/currencies/trending:
get:
tags:
- Currencies
summary: Trending Currencies
description: >-
**Description**
Returns coins with elevated interest right now.
> **Note:** Ranked by CryptoRank's internal Trending Score; reflects the
moment of the request and can change quickly.
**Access**
- Available from: **Sandbox**
- Cost: 1 credit per request
operationId: CurrenciesController_getTrending
parameters: []
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
required:
- data
- status
properties:
data:
type: array
items:
$ref: '#/components/schemas/CurrencyTrendingItemDto'
status:
$ref: '#/components/schemas/ResponseStatusDto'
'400':
description: Request validation failed
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
- status
properties:
code:
type: string
enum:
- VALIDATION_ERROR
example: VALIDATION_ERROR
message:
type: string
example: Validation failed
status:
type: number
example: 400
'401':
description: API key is missing or invalid
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
- status
properties:
code:
type: string
enum:
- API_KEY_MISSING
- API_KEY_INVALID
example: API_KEY_MISSING
message:
type: string
example: API key is missing
status:
type: number
example: 401
'403':
description: >-
No active subscription, the endpoint is not available in your plan,
or the request goes beyond what your plan allows
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
- status
properties:
code:
type: string
enum:
- NO_ACTIVE_SUBSCRIPTION
- ENDPOINT_NOT_AVAILABLE
- PLAN_LIMIT_EXCEEDED
example: NO_ACTIVE_SUBSCRIPTION
message:
type: string
example: No active subscription found
status:
type: number
example: 403
'429':
description: Rate limit or credit limit exceeded
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
- status
properties:
code:
type: string
enum:
- RATE_LIMIT_EXCEEDED
- DAILY_CREDITS_EXCEEDED
- MONTHLY_CREDITS_EXCEEDED
example: RATE_LIMIT_EXCEEDED
message:
type: string
example: Rate limit exceeded
status:
type: number
example: 429
'500':
description: Internal server error
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
- status
properties:
code:
type: string
enum:
- INTERNAL_ERROR
example: INTERNAL_ERROR
message:
type: string
example: Internal server error
status:
type: number
example: 500
security:
- X-Api-Key: []
components:
schemas:
CurrencyTrendingItemDto:
type: object
properties:
id:
type: number
example: 1
rank:
type: number
example: 1
description: Position in the trending list (1-based).
slug:
type: string
example: bitcoin
symbol:
type: string
example: BTC
nullable: true
name:
type: string
example: Bitcoin
imageUrl:
type: string
example: https://images.cryptorank.io/coins/150x150.bitcoin.png
nullable: true
description: Coin logo (150×150); null when no image is available.
category:
nullable: true
description: Coin category; null when the coin has none.
type: object
allOf:
- $ref: '#/components/schemas/CurrencyCategoryDto'
price:
type: string
example: '65000.5'
nullable: true
description: Price, USD; null when the coin is not actively traded.
priceChangePercent24h:
type: number
example: 2.34
nullable: true
description: 24h price change, percent; null when unavailable.
high24h:
type: string
example: '65500'
nullable: true
description: 24h high price, USD.
low24h:
type: string
example: '64000'
nullable: true
description: 24h low price, USD.
volume24h:
type: string
example: '32000000000'
nullable: true
description: 24h trading volume, USD; null when the coin is not actively traded.
marketCap:
type: string
example: '1280000000000'
nullable: true
description: Market cap, USD.
volMcapRatio:
type: number
example: 0.025
nullable: true
description: >-
Volume / market-cap ratio. Null when market cap is unavailable or
zero.
listingDate:
type: string
example: '2009-01-03T00:00:00.000Z'
nullable: true
description: First exchange listing date.
required:
- id
- rank
- slug
- symbol
- name
- imageUrl
- category
- price
- priceChangePercent24h
- high24h
- low24h
- volume24h
- marketCap
- volMcapRatio
- listingDate
ResponseStatusDto:
type: object
properties:
usedCredits:
type: number
example: 1
description: Credits charged for this request
timestamp:
type: number
example: 1780000000000
description: Server time of the response. Unix timestamp in milliseconds
required:
- usedCredits
- timestamp
CurrencyCategoryDto:
type: object
properties:
id:
type: number
example: 7
slug:
type: string
example: smart-contracts
name:
type: string
example: Smart Contracts
required:
- id
- slug
- name
securitySchemes:
X-Api-Key:
name: X-Api-Key
type: apiKey
in: header
````