API reference

USDF and reserve

The token, its reserve and the sUSDF vault.

On this page

GET/v1/reserve

The token and reserve, with contract addresses.

Auth: None

No parameters.

GET /v1/reserve

curl
curl https://api.usdf.fi/v1/reserve

GET/v1/reserve/history

The reserve over time.

Auth: None

No parameters.

GET /v1/reserve/history

curl
curl https://api.usdf.fi/v1/reserve/history

GET/v1/reserve/attestations/latest

The most recent reserve attestation.

Auth: None

No parameters.

GET /v1/reserve/attestations/latest

curl
curl https://api.usdf.fi/v1/reserve/attestations/latest

GET/v1/settlements

Settlement batches onchain.

Auth: None

No parameters.

GET /v1/settlements

curl
curl https://api.usdf.fi/v1/settlements

GET/v1/susdf

The vault's address, TVL, share price, yield and revenue deposits.

Auth: None

No parameters.

GET /v1/susdf

curl
curl https://api.usdf.fi/v1/susdf

GET/v1/holders/rewards

Each week's pool, holders and what was paid, credited and carried, with its transactions, and this week's estimate.

Auth: None

No parameters.

GET /v1/holders/rewards

curl
curl https://api.usdf.fi/v1/holders/rewards

GET/v1/holders/rewards/{address}

Whether it earns, last week's amount and transaction, next week's estimate, what it carries and its lifetime total.

Auth: None

NameTypeRequiredDescription
addressstringYesPath. A 0x address.

GET /v1/holders/rewards/{address}

curl
curl https://api.usdf.fi/v1/holders/rewards/{address}

GET/v1/holders/rewards/me

The account's own: last week's credit, next week's estimate, what is pending and its lifetime total, and its linked wallet's.

Auth: API key: Authorization: Bearer sk_…

No parameters.

GET /v1/holders/rewards/me

curl
curl https://api.usdf.fi/v1/holders/rewards/me \
  -H "Authorization: Bearer $USDF_API_KEY"