Vaults

Fetch the APY of a vault

get

Returns the annual percentage yield (APY) for a given vault address over a specified lookback period.

Query parameters
token_addressstringRequired

The address of the vault.

Example: 0x19e099B7aEd41FA52718D780dDA74678113C0b32
block_numberintegerOptional

Block number to calculate the APY at. Optional. Defaults to the latest block.

lookback_daysintegerOptional

Number of days to look back for the APY calculation. Defaults to 7 if not provided.

Example: 7
Responses
200

Successful response with APY details

application/json
get
GET /v1/vaults/apy HTTP/1.1
Host: api.paxoslabs.com
Accept: */*

{
  "apy": 12.5,
  "error": null
}

Get a list of vault token transfers

get

Fetches a list of transfers including chain ID, vault, time, transaction hash, sender, receiver, and amount.

Query parameters
vault_addressstringRequired

The address of the vault. Optional.

Example: 0x9Ed15383940CC380fAEF0a75edacE507cC775f22
Responses
200

Successful response with transfers.

application/json
get
GET /v1/vaults/transfers HTTP/1.1
Host: api.paxoslabs.com
Accept: */*

[
  {
    "chain_id": 1,
    "vault": "0x19e099b7aed41fa52718d780dda74678113c0b32",
    "time": 1733053355,
    "tx_hash": "0x5e1c28334e39c5273966b0986e9c00bc88f8e1e4f4372aea78b48cab4abc2509",
    "from": "0x0000000000000000000000000000000000000000",
    "to": "0xfbe0c54d696fa6c93f35d4ca7d656561816c15f6",
    "amount": 32764931240122292
  }
]

Fetch deposit events

get

Returns a list of all deposit events, which can be filtered by user or vault.

Query parameters
vault_addressstringOptional

The address of the vault. Optional.

Example: 0x9Ed15383940CC380fAEF0a75edacE507cC775f22
userstringOptional

User's address. Optional.

Example: 0x04354e44ed31022716e77eC6320C04Eda153010c
Responses
200

Successful response with deposit events.

application/json
get
GET /v1/vaults/deposits HTTP/1.1
Host: api.paxoslabs.com
Accept: */*

[
  {
    "chain_id": 1,
    "vault": "text",
    "time": 1,
    "tx_hash": "text",
    "asset": "text",
    "asset_amount": 1,
    "share_amount": 1,
    "from": "text",
    "to": "text"
  }
]

Get a count of unique token holders over time

get

Fetches an object containing each vault's unique cumulative holders over time.

Query parameters
vault_addressstringOptional

The address of the vault. Optional.

Example: 0x9Ed15383940CC380fAEF0a75edacE507cC775f22
time_startintegerOptional

Return results starting from this timestamp. Optional.

Example: 1732679943
time_endintegerOptional

Return results before this timestamp. Optional.

Example: 173868000
latestbooleanOptional

Indicate if the results should show the most recent snapshot of holders count. Defaults to false. Optional.

Example: false
Responses
200

Successful response.

application/json
get
GET /v1/vaults/holders HTTP/1.1
Host: api.paxoslabs.com
Accept: */*

[
  {
    "id": 1,
    "vault": "0x19e099b7aed41fa52718d780dda74678113c0b32",
    "timestamp": 1733053355,
    "total_count": 888
  }
]

Fetch supported assets by vault and chain

get

Supported assets are assets that can be deposited into a vault. There can be different supported assets on each blockchain network the vault is deployed on. Returns the mapping of supported assets for the specified vaaults on each chain.

Query parameters
vault_addressstringOptional

The address of the vault. Optional.

Example: 0x9Ed15383940CC380fAEF0a75edacE507cC775f22
Responses
200

Successful response with supported vault addresses.

application/json
get
GET /v1/vaults/assets HTTP/1.1
Host: api.paxoslabs.com
Accept: */*

{
  "1329": {
    "0xa8a3a5013104e093245164ea56588dbe10a3eb48": [
      "0x215dc1cc32d9d08a0081e55e55895c8cf006839a"
    ]
  },
  "42161": {
    "0xa8a3a5013104e093245164ea56588dbe10a3eb48": [
      "0x215dc1cc32d9d08a0081e55e55895c8cf006839a"
    ]
  }
}

Fetch the underlying backing assets for a vault

get

Returns the internal asset composition of the vault.

Query parameters
vault_addressstringRequired

The address of the vault.

Example: 0xA8A3A5013104e093245164eA56588DBE10a3Eb48
Responses
200

Successful response with token balances categorized by chain ID and token label.

application/json
get
GET /v1/vaults/underlying_strategies HTTP/1.1
Host: api.paxoslabs.com
Accept: */*

{
  "1": {
    "apxETH": {
      "valueInBase": 1.023232424,
      "pendingDeposits": 0,
      "pendingWithdrawals": 0,
      "tokenAddress": "0xTokenA",
      "decimals": 18,
      "allocationPercentage": 50
    },
    "ezETH": {
      "valueInBase": "3000232.1230\"",
      "pendingDeposits": 123.2,
      "pendingWithdrawals": 123.2,
      "tokenAddress": "0xTokenB",
      "decimals": 18,
      "allocationPercentage": 20
    }
  },
  "1923": {
    "weETH": {
      "valueInBase": 1.023232424,
      "pendingDeposits": 0,
      "pendingWithdrawals": 0,
      "tokenAddress": "0xTokenC",
      "decimals": 18,
      "allocationPercentage": 30
    }
  }
}

Fetch historic APY data for a vault

get

Returns APY data for a given vault address over a specified period.

Query parameters
vault_addressstringRequired

The address of the vault.

Example: 0x19e099B7aEd41FA52718D780dDA74678113C0b32
start_timestampintegerOptional

Start timestamp for the period.

Example: 1732679943
end_timestampintegerOptional

End timestamp for the period.

Example: 173868000
intervalsintegerOptional

Intervals for the period.

Example: 86400
lookback_daysintegerOptional

Number of days to look back for APY calculation. Defaults to 14 if not provided.

Example: 14
Responses
200

Successful response with historic APY data.

application/json
get
GET /v1/vaults/historical-apy HTTP/1.1
Host: api.paxoslabs.com
Accept: */*
200

Successful response with historic APY data.

{
  "interval": 86400,
  "data": [
    {
      "timeStamp": 1,
      "apy": 1.23
    }
  ]
}

Fetch historic TVL data for a vault

get

Returns TVL (Total Value Locked) data for a given vault address over a specified time period.

Query parameters
vault_addressstringRequired

The address of the vault.

Example: 0x19e099B7aEd41FA52718D780dDA74678113C0b32
start_timestampintegerOptional

Start timestamp for the data range (in seconds). Defaults to 60 days ago if not provided.

Example: 1732679943
end_timestampintegerOptional

End timestamp for the data range (in seconds). Defaults to current time if not provided.

Example: 173868000
intervalsintegerOptional

Time interval between data points in seconds. Defaults to 86400 (1 day) if not provided.

Example: 86400
Responses
200

Successful response with historic TVL data.

application/json
get
GET /v1/vaults/historical-tvl HTTP/1.1
Host: api.paxoslabs.com
Accept: */*

{
  "interval": 86400,
  "base_asset": 1.0970776880180083e+48,
  "base_asset_name": "WETH",
  "data": [
    {
      "time_stamp": 1732679943,
      "tvl": 1500000.5
    }
  ]
}
PreviousAnalytics APINextModels