Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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
statusstring · enum · nullableOptional

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

Possible values:
Responses
200

Successful Response

application/json
addressstringRequired
yield_distributorstring · nullableOptional
chaininteger · nullableRequired
descriptionstring · nullableOptional
internal_typestring · nullableOptional
public_typestring · nullableOptional
is_featuredboolean · nullableOptionalDefault: false
is_visibleboolean · nullableOptionalDefault: true
weekly_performance_fee_bpsnumber · nullableOptional
platform_fee_overrideobject · Platform Fee OverrideOptionalDefault: {}
start_datetimestring · date-time · nullableOptional
vault_namestring · nullableOptional
reserve_targetnumber · max: 1 · nullableOptionalDefault: 0.05
reserve_tolerancenumber · max: 1 · nullableOptionalDefault: 0.01
statusstring · nullableOptionalDefault: active
is_charge_fees_manualboolean · nullableOptionalDefault: false
receipt_token_symbolstring · nullableOptional
enable_external_assets_updateboolean · nullableOptionalDefault: false
vault_logo_urlstring · nullableOptional
riskstring · nullableOptional
max_daily_drawdownnumber · nullableOptional
chain_typestring · nullableOptionalDefault: evm
enabled_historical_price_horizonsinteger[] · nullableOptional
idstring · uuidRequired
get/tokenized_vaults
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-01-01T00:00:00.000Z",
    "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-01-01T00:00:00.000Z",
        "created_at": "2026-01-01T00:00:00.000Z",
        "tokenizedvault_id": "123e4567-e89b-12d3-a456-426614174000",
        "text": "text",
        "img_url": "text",
        "multiplier": 1,
        "start_datetime": "2026-01-01T00:00:00.000Z"
      }
    ],
    "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-01-01T00:00:00.000Z",
      "created_at": "2026-01-01T00:00:00.000Z",
      "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-01-01T00:00:00.000Z",
        "created_at": "2026-01-01T00:00:00.000Z",
        "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_distributorstring · nullableOptional
chaininteger · nullableRequired
descriptionstring · nullableOptional
internal_typestring · nullableOptional
public_typestring · nullableOptional
is_featuredboolean · nullableOptionalDefault: false
is_visibleboolean · nullableOptionalDefault: true
weekly_performance_fee_bpsnumber · nullableOptional
platform_fee_overrideobject · Platform Fee OverrideOptionalDefault: {}
start_datetimestring · date-time · nullableOptional
vault_namestring · nullableOptional
reserve_targetnumber · max: 1 · nullableOptionalDefault: 0.05
reserve_tolerancenumber · max: 1 · nullableOptionalDefault: 0.01
statusstring · nullableOptionalDefault: active
is_charge_fees_manualboolean · nullableOptionalDefault: false
receipt_token_symbolstring · nullableOptional
enable_external_assets_updateboolean · nullableOptionalDefault: false
vault_logo_urlstring · nullableOptional
riskstring · nullableOptional
max_daily_drawdownnumber · nullableOptional
chain_typestring · nullableOptionalDefault: evm
enabled_historical_price_horizonsinteger[] · nullableOptional
idstring · uuidRequired
get/tokenized_vaults/{vault_address}
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-01-01T00:00:00.000Z",
  "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-01-01T00:00:00.000Z",
      "created_at": "2026-01-01T00:00:00.000Z",
      "tokenizedvault_id": "123e4567-e89b-12d3-a456-426614174000",
      "text": "text",
      "img_url": "text",
      "multiplier": 1,
      "start_datetime": "2026-01-01T00:00:00.000Z"
    }
  ],
  "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-01-01T00:00:00.000Z",
    "created_at": "2026-01-01T00:00:00.000Z",
    "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-01-01T00:00:00.000Z",
      "created_at": "2026-01-01T00:00:00.000Z",
      "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
get/tokenized_vaults/{vault_address}/annualized_apy
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:

Get specific vault details:

PreviousAPI Reference
NextPoints

Last updated