> ## 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.
# Ecosystem Profile
> Full metrics for a single ecosystem.
Available from: Advanced
Cost: 1 credit per request
List this ecosystem’s projects via [/currencies/list](/api-reference/currencies/currency-list-with-market-data) with the `ecosystemId` filter.
## OpenAPI
````yaml https://api.cryptorank.io/v3/documentation-json get /v3/ecosystems/{id}
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/ecosystems/{id}:
get:
tags:
- Ecosystems
summary: Ecosystem Profile
description: >-
**Description**
Full metrics for a single ecosystem.
> **Tip:** List this ecosystem’s projects via
[/currencies/list](/api-reference/currencies/currency-list-with-market-data)
with the `ecosystemId` filter.
**Access**
- Available from: **Advanced**
- Cost: 1 credit per request
operationId: EcosystemsController_getById
parameters:
- name: id
required: true
in: path
description: Ecosystem ID. Resolve via /ecosystems/list
schema:
type: integer
minimum: 1
example: 1
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
required:
- data
- status
properties:
data:
$ref: '#/components/schemas/EcosystemByIdDto'
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
'404':
description: Ecosystem not found
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
- status
properties:
code:
type: string
enum:
- NOT_FOUND
example: NOT_FOUND
message:
type: string
example: Resource not found
status:
type: number
example: 404
'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:
EcosystemByIdDto:
type: object
properties:
id:
type: number
example: 1
description: Unique numeric identifier.
slug:
type: string
example: ethereum
description: URL-friendly slug.
name:
type: string
example: Ethereum
description: Display name.
imageUrl:
type: string
nullable: true
example: https://images.cryptorank.io/coins/150x150.ethereum1765201517428.png
description: Logo image URL, 150×150; null when no image is available.
shortDescription:
type: string
example: Smart-contract platform launched in 2015.
description: Short description.
projectsCount:
type: number
example: 1432
description: Total number of projects.
newProjectsCount:
type: number
example: 27
description: Projects added in the last 3 months.
marketCap:
type: string
nullable: true
example: '420000000000'
description: >-
Total market cap of all ecosystem tokens, USD. Null when none have a
price.
marketCapChangePercent24h:
type: number
nullable: true
example: 1.23
description: 24h market cap change, %. Null when no 24h baseline is available.
totalValueLocked:
type: string
nullable: true
example: '85000000000'
description: Total Value Locked, USD. Null when not tracked.
totalValueLockedChangePercent24h:
type: number
nullable: true
example: -0.42
description: 24h TVL change, %. Null when no 24h baseline is available.
tags:
description: Currency tags associated with the ecosystem.
type: array
items:
$ref: '#/components/schemas/EcosystemProfileTagDto'
links:
description: Ecosystem links (website, socials, explorer).
type: array
items:
$ref: '#/components/schemas/LinkDto'
funds:
description: Top 6 ecosystem backers.
type: array
items:
$ref: '#/components/schemas/EcosystemFundDto'
required:
- id
- slug
- name
- imageUrl
- shortDescription
- projectsCount
- newProjectsCount
- marketCap
- marketCapChangePercent24h
- totalValueLocked
- totalValueLockedChangePercent24h
- tags
- links
- funds
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
EcosystemProfileTagDto:
type: object
properties:
id:
type: number
example: 1
description: Unique tag identifier.
slug:
type: string
example: layer-1
description: URL-friendly entity slug.
name:
type: string
example: Layer 1
description: Display name.
projectsCount:
type: number
example: 42
description: Number of ecosystems carrying this tag.
required:
- id
- slug
- name
- projectsCount
LinkDto:
type: object
properties:
type:
type: string
enum:
- referral
- web
- twitter
- reddit
- slack
- discord
- blog
- github
- gitlab
- linkedin
- facebook
- google+
- explorer
- weibo
- chat
- messageboard
- wechat
- telegram
- medium
- announcement
- youtube
- fees
- whitepaper
- gitbook
- farcaster
example: twitter
value:
type: string
required:
- type
- value
EcosystemFundDto:
type: object
properties:
id:
type: number
example: 42
description: Unique fund identifier.
slug:
type: string
example: a16z
description: URL-friendly entity slug.
name:
type: string
example: Andreessen Horowitz
description: Display name.
imageUrl:
type: string
nullable: true
example: https://images.cryptorank.io/funds/150x150.a16z1524754012028.png
description: Fund logo URL, 150×150; null when no image is available.
required:
- id
- slug
- name
- imageUrl
securitySchemes:
X-Api-Key:
name: X-Api-Key
type: apiKey
in: header
````