Skip to main content
GET
/
v2
/
amplify
/
vaultTvls
List vault TVLs
curl --request GET \
  --url https://api.paxoslabs.com/v2/amplify/vaultTvls \
  --header 'x-api-key: <api-key>'
{
  "vaultTvls": [
    {
      "vaultAddress": "0x1234567890abcdef1234567890abcdef12345678",
      "chainId": 1,
      "timestamp": "2026-01-21T00:00:00Z",
      "interval": "86400s",
      "tvl": "1234567.89",
      "tvlAsset": "USD"
    }
  ],
  "nextPageToken": "eyJvZmZzZXQiOjI1fQ==",
  "tokenMetadata": {}
}

Documentation Index

Fetch the complete documentation index at: https://developers.paxoslabs.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

API key in format: pxl_<public_id>_

Query Parameters

​
pageSize
number
default:25

Maximum items per page. Default: 25. Min: 1, max: 100.

Required range: 1 <= x <= 100
Example:

25

​
pageToken
string

Opaque token for the next page. Omit for the first page.

​
startTime
string

Start of time range (RFC 3339 UTC). Optional; used with endTime. Takes precedence over lookback if set.

Example:

"2026-01-01T00:00:00Z"

​
endTime
string

End of time range (RFC 3339 UTC). Optional; used with startTime. Clamped to now if in the future.

Example:

"2026-01-21T00:00:00Z"

​
interval
string

Duration between data points (e.g. 86400s). Default: 86400s (1 day).

Example:

"86400s"

​
lookback
string

Duration from now backward (e.g. 604800s for 7 days). Default when no startTime/endTime: 2592000s (30 days).

Example:

"604800s"

​
includeCurrent
boolean

Deprecated: current on-chain TVL is now always included. Accepted for backward compatibility but has no effect.

Example:

false

​
orderByTimestamp
enum<string>

Order by timestamp. Allowed: asc, desc. Default: asc.

Available options:
asc,
desc
​
aggregate
boolean

When true, TVL is summed across all chains for each vault and returned with chainId=0. Default: false.

Example:

false

​
filter
string

Filter string. Flags: chainId, vaultAddress. Optional.

Example:

"chainId=1 AND vaultAddress=0x1234567890abcdef1234567890abcdef12345678"

Response

List of vault TVL data points

​
vaultTvls
object[]
required

List of vault TVL data points

​
nextPageToken
string | null
required

Token for the next page. null when there are no more results. Always present.

Example:

"eyJvZmZzZXQiOjI1fQ=="

​
tokenMetadata
object
required

Address metadata map keyed by lowercase token/address. Missing metadata is represented as null.