> ## 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.
# Fundraising Trends (Aggregate)
> Returns an aggregated time series of funding rounds, bucketed by the selected `interval`: total raised, round count, and average/median round size per bucket.
Available from: Advanced
Cost: 1 credit per request
By default, late-stage / non-VC round types (IPO, Post-IPO, Post-IPO Debt, Debt Financing, M\&A, PIPE) are excluded — override with `excludeStages`.
## OpenAPI
````yaml https://api.cryptorank.io/v3/documentation-json get /v3/funding-rounds/trends
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/funding-rounds/trends:
get:
tags:
- Funding Rounds
summary: Fundraising Trends (Aggregate)
description: >-
**Description**
Returns an aggregated time series of funding rounds, bucketed by the
selected `interval`: total raised, round count, and average/median round
size per bucket.
> **Note:** By default, late-stage / non-VC round types (IPO, Post-IPO,
Post-IPO Debt, Debt Financing, M&A, PIPE) are excluded — override with
`excludeStages`.
**Access**
- Available from: **Advanced**
- Cost: 1 credit per request
operationId: FundingRoundsController_getTrends
parameters:
- name: interval
required: true
in: query
description: >-
Bucket size for aggregation: `1d` — daily, `1w` — weekly (ISO week),
`1m` — monthly.
schema:
example: 1m
type: string
enum:
- 1d
- 1w
- 1m
- name: from
required: true
in: query
description: >-
Lower bound on the round date (inclusive). Accepts ISO 8601 string
or Unix timestamp (sec/ms).
schema:
example: '2024-01-01T00:00:00.000Z'
type: string
- name: to
required: false
in: query
description: >-
Upper bound on the round date (inclusive). Accepts ISO 8601 string
or Unix timestamp (sec/ms). Bare `YYYY-MM-DD` is coerced to
end-of-day UTC. Defaults to now.
schema:
example: '2024-12-31T23:59:59.999Z'
type: string
- name: categoryId
required: false
in: query
description: Filter by coin primary category identifier.
schema:
type: number
example: 12
- name: excludeStages
required: false
in: query
description: >-
Comma-separated round types to exclude from the aggregate. Defaults
to late-stage / non-VC types: IPO, Post-IPO, Post-IPO Debt, Debt
Financing, M&A, PIPE.
schema:
example: IPO,Post-IPO,M&A
type: array
items:
type: string
enum:
- ANGEL
- Debt Financing
- Extended Pre-Seed
- Extended Seed
- Extended Series A
- Extended Series B
- Extended Series C
- Extended Series D
- Grant
- IPO
- Incubation
- KOL
- M&A
- OTC Purchase
- PIPE
- Post-IPO
- Post-IPO Debt
- PRESALE
- PRE SEED
- Pre-Series A
- Pre-Series B
- Private Token Sale
- SEED
- SERIES A
- SERIES B
- SERIES C
- SERIES D
- Series E
- Series F
- Series G
- Series H
- STRATEGIC
- Treasury Diversification
- Undisclosed
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
required:
- data
- status
properties:
data:
type: array
items:
$ref: '#/components/schemas/FundingRoundsTrendPointDto'
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:
FundingRoundsTrendPointDto:
type: object
properties:
date:
type: string
example: '2024-08-01T00:00:00.000Z'
description: >-
Bucket start (ISO 8601 UTC). For `1w` the bucket starts on Monday;
for `1m` on the 1st.
totalRaised:
type: string
example: '125000000'
description: >-
Sum of `raised` (USD) across all rounds in the bucket with disclosed
raise.
roundsCount:
type: number
example: 42
description: Number of rounds in the bucket with disclosed `raised` amount.
avgRoundSize:
type: string
example: '2976190'
description: Arithmetic mean of `raised` (USD) across the bucket.
medianRoundSize:
type: string
example: '1500000'
description: Median of `raised` (USD) across the bucket (continuous percentile).
required:
- date
- totalRaised
- roundsCount
- avgRoundSize
- medianRoundSize
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
securitySchemes:
X-Api-Key:
name: X-Api-Key
type: apiKey
in: header
````