Historical vault holders and exposure

cURL

curl 'https://api.exponent.finance/holders/historical/vault/Cmry6B5824MGAKrtL2u7YG9PiLZLoTBWs8hVaCJeUFaH?startDate=2026-10-13T00:00:00Z&endDate=2026-10-14T00:00:00Z&limit=2'

import requests

response = requests.get("https://api.exponent.finance/holders/historical/vault/Cmry6B5824MGAKrtL2u7YG9PiLZLoTBWs8hVaCJeUFaH?startDate=2026-10-13T00:00:00Z&endDate=2026-10-14T00:00:00Z&limit=2", timeout=30)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.exponent.finance/holders/historical/vault/Cmry6B5824MGAKrtL2u7YG9PiLZLoTBWs8hVaCJeUFaH?startDate=2026-10-13T00:00:00Z&endDate=2026-10-14T00:00:00Z&limit=2");
if (!response.ok) {
  throw new Error(`Request failed: ${response.status}`);
}
const data = await response.json();
console.log(data);

{
  "pagination": {
    "page": 1,
    "limit": 2,
    "total_count": 15,
    "total_pages": 8,
    "has_next": true,
    "has_prev": false
  },
  "data": {
    "vaultAddress": "Cmry6B5824MGAKrtL2u7YG9PiLZLoTBWs8hVaCJeUFaH",
    "startDate": "2026-10-13T00:00:00.000Z",
    "endDate": "2026-10-14T00:00:00.000Z",
    "syExchangeRate": 1.1184787225252104,
    "count": 3,
    "holders": [
      {
        "userAddress": "2kyoEvCVfCoGmWGZG4MCzbv9xDgV7NCNDujFr776YzDQ",
        "venue": "vaults",
        "cumulativeDepositSeconds": 86400,
        "balanceSecondsBase": 562178.6208,
        "timeWeightedAverageBalanceBase": 6.506697
      },
      {
        "userAddress": "8Y7ApemW5UHzczZNYHW3tU4yZZjML8ho87i1dnf7kvw7",
        "venue": "vaults",
        "cumulativeDepositSeconds": 86400,
        "balanceSecondsBase": 99913.4784,
        "timeWeightedAverageBalanceBase": 1.156406
      }
    ]
  }
}

GET

holders

historical

vault

{vaultAddress}

cURL

curl 'https://api.exponent.finance/holders/historical/vault/Cmry6B5824MGAKrtL2u7YG9PiLZLoTBWs8hVaCJeUFaH?startDate=2026-10-13T00:00:00Z&endDate=2026-10-14T00:00:00Z&limit=2'

import requests

response = requests.get("https://api.exponent.finance/holders/historical/vault/Cmry6B5824MGAKrtL2u7YG9PiLZLoTBWs8hVaCJeUFaH?startDate=2026-10-13T00:00:00Z&endDate=2026-10-14T00:00:00Z&limit=2", timeout=30)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.exponent.finance/holders/historical/vault/Cmry6B5824MGAKrtL2u7YG9PiLZLoTBWs8hVaCJeUFaH?startDate=2026-10-13T00:00:00Z&endDate=2026-10-14T00:00:00Z&limit=2");
if (!response.ok) {
  throw new Error(`Request failed: ${response.status}`);
}
const data = await response.json();
console.log(data);

{
  "pagination": {
    "page": 1,
    "limit": 2,
    "total_count": 15,
    "total_pages": 8,
    "has_next": true,
    "has_prev": false
  },
  "data": {
    "vaultAddress": "Cmry6B5824MGAKrtL2u7YG9PiLZLoTBWs8hVaCJeUFaH",
    "startDate": "2026-10-13T00:00:00.000Z",
    "endDate": "2026-10-14T00:00:00.000Z",
    "syExchangeRate": 1.1184787225252104,
    "count": 3,
    "holders": [
      {
        "userAddress": "2kyoEvCVfCoGmWGZG4MCzbv9xDgV7NCNDujFr776YzDQ",
        "venue": "vaults",
        "cumulativeDepositSeconds": 86400,
        "balanceSecondsBase": 562178.6208,
        "timeWeightedAverageBalanceBase": 6.506697
      },
      {
        "userAddress": "8Y7ApemW5UHzczZNYHW3tU4yZZjML8ho87i1dnf7kvw7",
        "venue": "vaults",
        "cumulativeDepositSeconds": 86400,
        "balanceSecondsBase": 99913.4784,
        "timeWeightedAverageBalanceBase": 1.156406
      }
    ]
  }
}

Path parameters

string

required

Vault address.

Query parameters

string

Filter to one wallet address.

string

ISO 8601 string or Unix timestamp in seconds. Defaults to vault start.

string

ISO 8601 string or Unix timestamp in seconds. Defaults to now.

integer

default:"1"

Positive integer. Pagination counts wallets before venue expansion.

integer

default:"1000"

Positive integer; capped at 1000 wallets per page.

number

default:"3600"

Cache staleness in seconds, capped at 86400. Invalid or negative values use 3600.

Default time window

If startDate is omitted, the endpoint uses the vault start timestamp. If endDate is omitted, the endpoint uses the current time, capped at vault maturity when the vault has a maturity timestamp. Explicit start dates are clamped to vault start, and explicit end dates are capped at maturity too. The effective start must be earlier than the effective end.

Example requests

All holders:

cURL

curl 'https://api.exponent.finance/holders/historical/vault/Cmry6B5824MGAKrtL2u7YG9PiLZLoTBWs8hVaCJeUFaH?startDate=2026-10-13T00:00:00Z&endDate=2026-10-14T00:00:00Z&limit=2'

import requests

response = requests.get("https://api.exponent.finance/holders/historical/vault/Cmry6B5824MGAKrtL2u7YG9PiLZLoTBWs8hVaCJeUFaH?startDate=2026-10-13T00:00:00Z&endDate=2026-10-14T00:00:00Z&limit=2", timeout=30)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.exponent.finance/holders/historical/vault/Cmry6B5824MGAKrtL2u7YG9PiLZLoTBWs8hVaCJeUFaH?startDate=2026-10-13T00:00:00Z&endDate=2026-10-14T00:00:00Z&limit=2");
if (!response.ok) {
  throw new Error(`Request failed: ${response.status}`);
}
const data = await response.json();
console.log(data);

Single user:

curl "https://api.exponent.finance/holders/historical/vault/78MLjMXyKyjwXtHXCuZHnBUH5wMh89KwBpvoFvcBzxN1?user=HmzCnQBzSFW4THri7t9f9tcVBHXT7fuw4iczfPKMwEL8"

Explicit time window:

curl "https://api.exponent.finance/holders/historical/vault/78MLjMXyKyjwXtHXCuZHnBUH5wMh89KwBpvoFvcBzxN1?startDate=2026-05-31T00:00:00Z&endDate=2026-06-06T00:00:00Z"

Paginated:

curl "https://api.exponent.finance/holders/historical/vault/78MLjMXyKyjwXtHXCuZHnBUH5wMh89KwBpvoFvcBzxN1?page=1&limit=1000"

Venue composition

Venue	Included exposure
`vaults`	Wallet/core YT plus open and filled orderbook YT attributed to the position owner
`orderbook`	Open and filled orderbook SY attributed to the position owner
`amm`	Legacy AMM LP; LP balances are converted using average SY per LP from legacy market history and the response window’s `syExchangeRate`
`clmm`	CLMM LP; recorded historical SY exposure is converted using the response window’s `syExchangeRate`

Example calculation

User holds 100 tokens for 10 days, then 200 tokens for 20 days. The user has no balance for the rest of the requested window.

Metric	Calculation	Value
`cumulativeDepositSeconds`	10 + 20 days	30 days (in seconds)
`balanceSecondsBase`	(100 × 10) + (200 × 20)	5000 base-days
`timeWeightedAverageBalanceBase`	5000 / 30	166.67 base

{
  "pagination": {
    "page": 1,
    "limit": 2,
    "total_count": 15,
    "total_pages": 8,
    "has_next": true,
    "has_prev": false
  },
  "data": {
    "vaultAddress": "Cmry6B5824MGAKrtL2u7YG9PiLZLoTBWs8hVaCJeUFaH",
    "startDate": "2026-10-13T00:00:00.000Z",
    "endDate": "2026-10-14T00:00:00.000Z",
    "syExchangeRate": 1.1184787225252104,
    "count": 3,
    "holders": [
      {
        "userAddress": "2kyoEvCVfCoGmWGZG4MCzbv9xDgV7NCNDujFr776YzDQ",
        "venue": "vaults",
        "cumulativeDepositSeconds": 86400,
        "balanceSecondsBase": 562178.6208,
        "timeWeightedAverageBalanceBase": 6.506697
      },
      {
        "userAddress": "8Y7ApemW5UHzczZNYHW3tU4yZZjML8ho87i1dnf7kvw7",
        "venue": "vaults",
        "cumulativeDepositSeconds": 86400,
        "balanceSecondsBase": 99913.4784,
        "timeWeightedAverageBalanceBase": 1.156406
      }
    ]
  }
}

Introduction

Core

Order Book

CLMM

Tranching

Strategy Vaults

Balances

Positions and activity

Points

Rewards

Tokens and prices

Historical vault holders and exposure

Path parameters

Query parameters

Default time window

Example requests

Venue composition

Example calculation

​Path parameters

​Query parameters

​Default time window

​Example requests

​Venue composition

​Example calculation

Path parameters

Query parameters

Default time window

Example requests

Venue composition

Example calculation