> ## 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.
# Fund Portfolio
> Returns the full portfolio of a fund: every project it has backed, with market data for traded coins and aggregates of the rounds the fund took part in.
Available from: Pro
Cost: 1 credit per request
`totalInvested` is the total size of every round the fund participated in — the full round size, not the fund's individual contribution.
Projects backed without a disclosed funding round are included with `viaRound: false` and `roundsCount: 0`. To list the rounds themselves, use [/funding-rounds/list?fundId={id}](https://docs.cryptorank.io/api-reference/funding-rounds/funding-rounds-feed).
Market fields (`price`, `marketCap`, `volume24h`, `priceChangePercent24h`, `retailRoi`) are `null` for projects that are not traded.
## OpenAPI
````yaml /openapi.json get /v3/funds/{id}/portfolio
openapi: 3.0.0
info:
contact:
email: info@cryptorank.io
name: Cryptorank Team
url: https://cryptorank.io
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.
title: Cryptorank API V3
version: 3.0.0
servers:
- url: https://api.cryptorank.io
security: []
tags: []
paths:
/v3/funds/{id}/portfolio:
get:
tags:
- Funds
summary: Fund Portfolio
description: >-
**Description**
Returns the full portfolio of a fund: every project it has backed, with
market data for traded coins and aggregates of the rounds the fund took
part in.
> **Note:** `totalInvested` is the total size of every round the fund
participated in — the full round size, not the fund's individual
contribution.
> **Tip:** Projects backed without a disclosed funding round are
included with `viaRound: false` and `roundsCount: 0`. To list the rounds
themselves, use
[/funding-rounds/list?fundId={id}](https://docs.cryptorank.io/api-reference/funding-rounds/funding-rounds-feed).
> **Note:** Market fields (`price`, `marketCap`, `volume24h`,
`priceChangePercent24h`, `retailRoi`) are `null` for projects that are
not traded.
**Access**
- Available from: **Pro**
- Cost: 1 credit per request
operationId: FundsController_getPortfolio
parameters:
- description: >-
Fund ID. See: [GET
/v3/funds/map](https://docs.cryptorank.io/api-reference/funds/funds-map-id-reference).
in: path
name: id
required: true
schema:
example: 1
type: integer
- description: Page number (1-based). Returns up to 50 items per page.
in: query
name: page
required: false
schema:
default: 1
maximum: 1000
minimum: 1
type: number
- description: >-
Comma-separated lifecycle states: scheduled, funding, crowdsale,
traded, inactive, unknown. Omit to include all states.
in: query
name: lifecycle
required: false
schema:
example: traded,funding
type: string
- description: >-
Filter by the project's primary category. See: [GET
/v3/currencies/categories](https://docs.cryptorank.io/api-reference/currencies/coin-categories).
in: query
name: categoryId
required: false
schema:
example: 54
type: number
- description: >-
True keeps projects where the fund led at least one round. False
keeps projects where the fund never led a round, including
backer-only projects. Omit to include both.
in: query
name: isLead
required: false
schema:
example: true
type: boolean
- description: >-
Lower bound on the first round with fund participation (inclusive).
Accepts ISO 8601 or Unix timestamp (sec/ms). Projects without a
known first round date are excluded.
in: query
name: from
required: false
schema:
example: '2024-01-01T00:00:00.000Z'
type: string
- description: >-
Upper bound on the first round with fund participation (inclusive).
Accepts ISO 8601 or Unix timestamp (sec/ms). Bare YYYY-MM-DD means
end-of-day UTC. Projects without a known first round date are
excluded.
in: query
name: to
required: false
schema:
example: '2024-12-31T23:59:59.999Z'
type: string
- description: Sort field.
in: query
name: sortBy
required: false
schema:
default: id
enum:
- id
- marketCap
- retailRoi
- latestRoundDate
- firstRoundDate
- totalInvested
- roundsCount
- name
type: string
- description: Sort direction. Null values are always placed last.
in: query
name: sortOrder
required: false
schema:
default: desc
enum:
- asc
- desc
type: string
- description: >-
Fiat ISO code for price, marketCap, volume24h and totalInvested.
See: [GET
/v3/fiat/list](https://docs.cryptorank.io/api-reference/fiat/supported-fiat-currency-list).
in: query
name: convert
required: false
schema:
default: USD
type: string
responses:
'200':
content:
application/json:
schema:
properties:
data:
items:
$ref: '#/components/schemas/FundPortfolioItemDto'
type: array
meta:
$ref: '#/components/schemas/ListMetaDto'
status:
$ref: '#/components/schemas/ResponseStatusDto'
required:
- data
- meta
- status
type: object
description: ''
'400':
content:
application/json:
schema:
properties:
error:
properties:
code:
enum:
- VALIDATION_ERROR
example: VALIDATION_ERROR
type: string
message:
example: Validation failed
type: string
status:
example: 400
type: number
required:
- code
- message
- status
type: object
required:
- error
type: object
description: Request validation failed
'401':
content:
application/json:
schema:
properties:
error:
properties:
code:
enum:
- API_KEY_MISSING
- API_KEY_INVALID
example: API_KEY_MISSING
type: string
message:
example: API key is missing
type: string
status:
example: 401
type: number
required:
- code
- message
- status
type: object
required:
- error
type: object
description: API key is missing or invalid
'403':
content:
application/json:
schema:
properties:
error:
properties:
code:
enum:
- NO_ACTIVE_SUBSCRIPTION
- ENDPOINT_NOT_AVAILABLE
- PLAN_LIMIT_EXCEEDED
example: NO_ACTIVE_SUBSCRIPTION
type: string
message:
example: No active subscription found
type: string
status:
example: 403
type: number
required:
- code
- message
- status
type: object
required:
- error
type: object
description: >-
No active subscription, the endpoint is not available in your plan,
or the request goes beyond what your plan allows
'404':
content:
application/json:
schema:
properties:
error:
properties:
code:
enum:
- NOT_FOUND
example: NOT_FOUND
type: string
message:
example: Resource not found
type: string
status:
example: 404
type: number
required:
- code
- message
- status
type: object
required:
- error
type: object
description: Fund not found
'429':
content:
application/json:
schema:
properties:
error:
properties:
code:
enum:
- RATE_LIMIT_EXCEEDED
- DAILY_CREDITS_EXCEEDED
- MONTHLY_CREDITS_EXCEEDED
example: RATE_LIMIT_EXCEEDED
type: string
message:
example: Rate limit exceeded
type: string
status:
example: 429
type: number
required:
- code
- message
- status
type: object
required:
- error
type: object
description: Rate limit or credit limit exceeded
'500':
content:
application/json:
schema:
properties:
error:
properties:
code:
enum:
- INTERNAL_ERROR
example: INTERNAL_ERROR
type: string
message:
example: Internal server error
type: string
status:
example: 500
type: number
required:
- code
- message
- status
type: object
required:
- error
type: object
description: Internal server error
security:
- X-Api-Key: []
components:
schemas:
FundPortfolioItemDto:
properties:
category:
allOf:
- $ref: '#/components/schemas/CurrencyCategoryDto'
description: Primary project category.
nullable: true
type: object
currencyId:
description: Currency identifier.
example: 28
type: number
firstRoundDate:
description: >-
Date of the first round with fund participation, ISO 8601 UTC. Null
when no participated round has a known date.
example: '2022-01-15T00:00:00.000Z'
nullable: true
type: string
imageUrl:
description: 150 × 150 px image link. Null when no image is available.
example: https://images.cryptorank.io/coins/150x150.ethereum1524754015525.png
nullable: true
type: string
isLead:
description: Whether the fund led at least one round in this project.
example: true
type: boolean
latestRoundDate:
description: >-
Date of the latest round with fund participation, ISO 8601 UTC. Null
when no participated round has a known date.
example: '2024-08-15T00:00:00.000Z'
nullable: true
type: string
lifecycle:
enum:
- scheduled
- funding
- crowdsale
- traded
- inactive
- unknown
example: traded
type: string
marketCap:
description: >-
Market cap in the requested fiat. Null for projects that are not
traded or when unavailable.
example: '450000000000'
nullable: true
type: string
name:
description: Project name.
example: Ethereum
type: string
price:
description: >-
Current price in the requested fiat. Null for projects that are not
traded or when unavailable.
example: '3200.123456789012'
nullable: true
type: string
priceChangePercent24h:
description: >-
Price change over the last 24 hours, %. Null for projects that are
not traded or when unavailable.
example: 2.34
nullable: true
type: number
rank:
description: >-
Market cap rank. Null for projects that are not traded or have no
rank.
example: 2
nullable: true
type: number
retailRoi:
description: >-
ROI from the public retail sale price as a multiplier (1.0 =
breakeven). Null for projects that are not traded or when no retail
price reference is available.
example: 12.34
nullable: true
type: number
roundsCount:
description: >-
Number of rounds with fund participation. Zero for projects backed
without a disclosed round.
example: 3
type: number
slug:
description: Project slug.
example: ethereum
type: string
symbol:
description: Token ticker symbol.
example: ETH
nullable: true
type: string
totalInvested:
description: >-
Sum of the full sizes of rounds with fund participation in the
requested fiat, not the fund contribution. Null when no round raise
amount is known.
example: '5000000'
nullable: true
type: string
type:
description: Project type, e.g. coin, token or no-token.
example: coin
type: string
viaRound:
description: >-
Whether the fund participated in a disclosed round. False for
projects backed without such a round.
example: true
type: boolean
volume24h:
description: >-
Trading volume over the last 24 hours in the requested fiat. Null
for projects that are not traded or when unavailable.
example: '12000000000'
nullable: true
type: string
required:
- currencyId
- name
- symbol
- slug
- imageUrl
- type
- lifecycle
- category
- rank
- price
- priceChangePercent24h
- marketCap
- volume24h
- retailRoi
- isLead
- roundsCount
- firstRoundDate
- latestRoundDate
- totalInvested
- viaRound
type: object
ListMetaDto:
properties:
hasNextPage:
description: Whether a further page of results exists
example: true
type: boolean
page:
description: Current page number (1-based)
example: 1
type: number
pageSize:
description: >-
Fixed number of items per page for this endpoint (varies per
endpoint)
example: 25
type: number
required:
- page
- pageSize
- hasNextPage
type: object
ResponseStatusDto:
properties:
timestamp:
description: Server time of the response. Unix timestamp in milliseconds
example: 1780000000000
type: number
usedCredits:
description: Credits charged for this request
example: 1
type: number
required:
- usedCredits
- timestamp
type: object
CurrencyCategoryDto:
properties:
id:
example: 54
type: number
name:
example: DeFi
type: string
slug:
example: defi
type: string
required:
- id
- slug
- name
type: object
securitySchemes:
X-Api-Key:
in: header
name: X-Api-Key
type: apiKey
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.