Vaults

Tokenized Vault API Endpoints

This documentation covers the tokenized vault endpoints for retrieving vault information.

Base URL

https://api.upshift.finance/v1/

---

Get All Tokenized Vaults

GET /tokenized_vaults

Retrieve a list of all tokenized vaults with optional status filtering.

Query Parameters:

• status (optional): Filter by vault status (active or closed)

Get Tokenized Vaults

get

Query parameters

statusany ofOptional

Filter vaults by status (e.g. active, closed)

string · enumOptionalPossible values:

or

nullOptional

Responses

200

Successful Response

application/json

addressstringRequired

yield_distributorany ofOptional

stringOptional

or

nullOptional

chainany ofRequired

integerOptional

or

nullOptional

descriptionany ofOptional

stringOptional

or

nullOptional

internal_typeany ofOptional

stringOptional

or

nullOptional

public_typeany ofOptional

stringOptional

or

nullOptional

is_featuredany ofOptionalDefault: false

booleanOptional

or

nullOptional

is_visibleany ofOptionalDefault: true

booleanOptional

or

nullOptional

weekly_performance_fee_bpsany ofOptional

numberOptional

or

nullOptional

platform_fee_overrideobject · PlatformFeeOverrideOptionalDefault: {}

start_datetimeany ofOptional

string · date-timeOptional

or

nullOptional

vault_nameany ofOptional

stringOptional

or

nullOptional

reserve_targetany ofOptionalDefault: 0.05

number · max: 1Optional

or

nullOptional

reserve_toleranceany ofOptionalDefault: 0.01

number · max: 1Optional

or

nullOptional

statusany ofOptionalDefault: active

stringOptional

or

nullOptional

is_charge_fees_manualany ofOptionalDefault: false

booleanOptional

or

nullOptional

receipt_token_symbolany ofOptional

stringOptional

or

nullOptional

enable_external_assets_updateany ofOptionalDefault: false

booleanOptional

or

nullOptional

vault_logo_urlany ofOptional

stringOptional

or

nullOptional

riskany ofOptional

stringOptional

or

nullOptional

max_daily_drawdownany ofOptional

numberOptional

or

nullOptional

chain_typeany ofOptionalDefault: evm

stringOptional

or

nullOptional

enabled_historical_price_horizonsany ofOptional

integer[]Optional

or

nullOptional

idstring · uuidRequired

reported_apyany ofOptional

or

nullOptional

422

Validation Error

application/json

get

/tokenized_vaults

HTTPcURLJavaScriptPython

GET /v1/tokenized_vaults HTTP/1.1
Accept: */*

[
  {
    "address": "text",
    "yield_distributor": "text",
    "chain": 1,
    "description": "text",
    "internal_type": "text",
    "public_type": "text",
    "is_featured": false,
    "is_visible": true,
    "weekly_performance_fee_bps": 1,
    "platform_fee_override": {},
    "start_datetime": "2026-03-04T04:20:49.961Z",
    "vault_name": "text",
    "reserve_target": 0.05,
    "reserve_tolerance": 0.01,
    "status": "active",
    "is_charge_fees_manual": false,
    "receipt_token_symbol": "text",
    "enable_external_assets_update": false,
    "vault_logo_url": "text",
    "risk": "text",
    "max_daily_drawdown": 1,
    "chain_type": "evm",
    "enabled_historical_price_horizons": [
      1
    ],
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "rewards": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "updated_at": "2026-03-04T04:20:49.961Z",
        "created_at": "2026-03-04T04:20:49.961Z",
        "tokenizedvault_id": "123e4567-e89b-12d3-a456-426614174000",
        "text": "text",
        "img_url": "text",
        "multiplier": 1,
        "start_datetime": "2026-03-04T04:20:49.961Z"
      }
    ],
    "subaccounts": [
      {
        "address": "text",
        "strategist": {
          "strategist_name": "text",
          "strategist_logo": "text",
          "id": "123e4567-e89b-12d3-a456-426614174000"
        }
      }
    ],
    "reported_apy": {
      "apy": 1,
      "underlying_apy": 1,
      "liquid_apy": 1,
      "rewards_compounded": 1,
      "rewards_claimable": 1,
      "explainer": "text",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "updated_at": "2026-03-04T04:20:49.961Z",
      "created_at": "2026-03-04T04:20:49.961Z",
      "tokenized_vault_id": "123e4567-e89b-12d3-a456-426614174000"
    },
    "receipt_token_integrations": [
      {
        "address": "text",
        "chain": 1,
        "token_class": "text",
        "shorthand": "text",
        "symbol": "text",
        "tiingo_ticker": "text",
        "img_url": "text",
        "is_transferable": true,
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "updated_at": "2026-03-04T04:20:49.961Z",
        "created_at": "2026-03-04T04:20:49.961Z",
        "position_id": "123e4567-e89b-12d3-a456-426614174000",
        "stable_token_pair_id": "123e4567-e89b-12d3-a456-426614174000"
      }
    ],
    "hardcoded_strategists": [
      {
        "strategist_name": "text",
        "strategist_logo": "text",
        "id": "123e4567-e89b-12d3-a456-426614174000"
      }
    ]
  }
]

---

Get Specific Tokenized Vault

GET /tokenized_vaults/{vault_address}

Get detailed information for a specific tokenized vault by its contract address.

Path Parameters:

• vault_address (required): The vault contract address

Get Tokenized Vault

get

Path parameters

vault_addressstringRequired

Responses

200

Successful Response

application/json

addressstringRequired

yield_distributorany ofOptional

stringOptional

or

nullOptional

chainany ofRequired

integerOptional

or

nullOptional

descriptionany ofOptional

stringOptional

or

nullOptional

internal_typeany ofOptional

stringOptional

or

nullOptional

public_typeany ofOptional

stringOptional

or

nullOptional

is_featuredany ofOptionalDefault: false

booleanOptional

or

nullOptional

is_visibleany ofOptionalDefault: true

booleanOptional

or

nullOptional

weekly_performance_fee_bpsany ofOptional

numberOptional

or

nullOptional

platform_fee_overrideobject · PlatformFeeOverrideOptionalDefault: {}

start_datetimeany ofOptional

string · date-timeOptional

or

nullOptional

vault_nameany ofOptional

stringOptional

or

nullOptional

reserve_targetany ofOptionalDefault: 0.05

number · max: 1Optional

or

nullOptional

reserve_toleranceany ofOptionalDefault: 0.01

number · max: 1Optional

or

nullOptional

statusany ofOptionalDefault: active

stringOptional

or

nullOptional

is_charge_fees_manualany ofOptionalDefault: false

booleanOptional

or

nullOptional

receipt_token_symbolany ofOptional

stringOptional

or

nullOptional

enable_external_assets_updateany ofOptionalDefault: false

booleanOptional

or

nullOptional

vault_logo_urlany ofOptional

stringOptional

or

nullOptional

riskany ofOptional

stringOptional

or

nullOptional

max_daily_drawdownany ofOptional

numberOptional

or

nullOptional

chain_typeany ofOptionalDefault: evm

stringOptional

or

nullOptional

enabled_historical_price_horizonsany ofOptional

integer[]Optional

or

nullOptional

idstring · uuidRequired

reported_apyany ofOptional

or

nullOptional

422

Validation Error

application/json

get

/tokenized_vaults/{vault_address}

HTTPcURLJavaScriptPython

GET /v1/tokenized_vaults/{vault_address} HTTP/1.1
Accept: */*

{
  "address": "text",
  "yield_distributor": "text",
  "chain": 1,
  "description": "text",
  "internal_type": "text",
  "public_type": "text",
  "is_featured": false,
  "is_visible": true,
  "weekly_performance_fee_bps": 1,
  "platform_fee_override": {},
  "start_datetime": "2026-03-04T04:20:49.961Z",
  "vault_name": "text",
  "reserve_target": 0.05,
  "reserve_tolerance": 0.01,
  "status": "active",
  "is_charge_fees_manual": false,
  "receipt_token_symbol": "text",
  "enable_external_assets_update": false,
  "vault_logo_url": "text",
  "risk": "text",
  "max_daily_drawdown": 1,
  "chain_type": "evm",
  "enabled_historical_price_horizons": [
    1
  ],
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "rewards": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "updated_at": "2026-03-04T04:20:49.961Z",
      "created_at": "2026-03-04T04:20:49.961Z",
      "tokenizedvault_id": "123e4567-e89b-12d3-a456-426614174000",
      "text": "text",
      "img_url": "text",
      "multiplier": 1,
      "start_datetime": "2026-03-04T04:20:49.961Z"
    }
  ],
  "subaccounts": [
    {
      "address": "text",
      "strategist": {
        "strategist_name": "text",
        "strategist_logo": "text",
        "id": "123e4567-e89b-12d3-a456-426614174000"
      }
    }
  ],
  "reported_apy": {
    "apy": 1,
    "underlying_apy": 1,
    "liquid_apy": 1,
    "rewards_compounded": 1,
    "rewards_claimable": 1,
    "explainer": "text",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "updated_at": "2026-03-04T04:20:49.961Z",
    "created_at": "2026-03-04T04:20:49.961Z",
    "tokenized_vault_id": "123e4567-e89b-12d3-a456-426614174000"
  },
  "receipt_token_integrations": [
    {
      "address": "text",
      "chain": 1,
      "token_class": "text",
      "shorthand": "text",
      "symbol": "text",
      "tiingo_ticker": "text",
      "img_url": "text",
      "is_transferable": true,
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "updated_at": "2026-03-04T04:20:49.961Z",
      "created_at": "2026-03-04T04:20:49.961Z",
      "position_id": "123e4567-e89b-12d3-a456-426614174000",
      "stable_token_pair_id": "123e4567-e89b-12d3-a456-426614174000"
    }
  ],
  "hardcoded_strategists": [
    {
      "strategist_name": "text",
      "strategist_logo": "text",
      "id": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}

---

Get Specific Tokenized Vault APY

GET /tokenized_vaults/{vault_address}/annualized_apy

Get APY information for a specific tokenized vault by its contract address.

Path Parameters:

• vault_address (required): The vault contract address

Get annualized APY

get

Calculate annualized APY for a specific vault.

    ⚠️ Deprecation Notice: 
    - The `hgETH30dLiquidAPY` and `hgETH7dLiquidAPY` fields are deprecated
    - These fields will be removed on 2026-01-01
    - Use `liquidAPY30Day` and `liquidAPY7Day` fields instead
    
    Supported Vaults: cUSDO, tETH, wstETH, rsETH

Path parameters

vault_addressstringRequired

Responses

200

APY data

application/json

anyOptional

422

Validation Error

application/json

get

/tokenized_vaults/{vault_address}/annualized_apy

HTTPcURLJavaScriptPython

GET /v1/tokenized_vaults/{vault_address}/annualized_apy HTTP/1.1
Accept: */*

No content

---

Key Response Fields

Important fields in the responses:

• address: Vault contract address

• vault_name: Human-readable vault name

• status: Current status (active or closed)

• chain: Blockchain network ID

• reported_apy: APY information including breakdown

• rewards: Available reward multipliers

• subaccounts: Associated strategist subaccounts

• is_featured: Whether vault is prominently displayed

• receipt_token_symbol: Symbol for vault receipt tokens

---

Status Values

• active: Vault is operational and accepting deposits

• closed: Vault is closed to new deposits

---

Usage Examples

Get all active vaults:

curl "https://api.augustdigital.io/api/v1/tokenized_vaults?status=active"

Get specific vault details:

curl "https://api.augustdigital.io/api/v1/tokenized_vaults/0x123..."