Skip to main content
GET
List the vaults behind the Dollar Rate

Authorizations

x-api-key
string
header
required

Query Parameters

date
string<date>

A published day (YYYY-MM-DD); omit for the newest day. Returns 404 when that day has not been published. The current UTC day is provisional: it can still change until the day ends, a response for it can be up to an hour old, and once a day has returned 404 it keeps returning 404 for up to 5 minutes after it is published.

asset
enum<string>

Only vaults of this asset: USDC or USDT, in uppercase. A vault whose deposit token could not be identified (asset null) never matches.

Available options:
USDC,
USDT
eligible
enum<string>

Only vaults that passed (true) or failed (false) the eligibility rules.

Available options:
true,
false

Response

The day's vaults. Example: ?asset=USDC&eligible=true, trimmed to two vaults.

A day's vaults. When nothing has been published yet, date, computed_at and methodology_version are null, vaults is empty and stale is true.

date
string<date> | null
required

The day (YYYY-MM-DD).

Example:

"2026-11-17"

computed_at
string<date-time> | null
required

When the day was computed.

Example:

"2026-11-17T18:06:10.203129+00:00"

methodology_version
string | null
required

Rate formula version.

Example:

"dollar-rate-v0.1.2"

vaults
object[]
required
total
integer
required

Vaults returned after the asset / eligible filters.

Example:

108

stale
boolean
required

True when the data is more than 48h old or was served from a fallback copy. Always false with date, including for the current UTC day, which can still change: see the date parameter.

Example:

false

field_notes
object
required

Plain-language definitions of the served fields, keyed by field name (for example rate, composite, spread, index, content_hash), for display next to the numbers (for example as tooltips). The same map is returned by all four endpoints. Informational text only, not part of the data contract: the wording can change and keys can be added or removed at any time, so do not parse it or depend on a key being present.

Example:
stats_version
string

Version of the statistics output.

Example:

"dollar-rate-stats-v0.4.0"

content_hash
string

sha256 over the day's rate-bearing fields (date, methodology version, and each vault's membership, exclusion reason, TVL, realized yield and weights; names and grades are display-only and left out). A past day changes only through a logged restatement, so the hash lets you verify it has not changed since publication. The current UTC day is recomputed several times a day until it ends, so its hash can still change. Absent on days published before hashing.

Example:

"sha256:ebac319ca887861c75720ca1c3c90852e0b134a9230a4fe42e2882e8c6e8bc83"

date_mismatch
boolean

Present and true when the newest vault list and the newest day are briefly on different days during a publish; the response is then also stale. Never set with date.

Example:

true