UpshiftDocs
REST APIInstitutional API

Tokenized Vault

Vault listings, summaries, annualized APY, historical timeseries, DeBank exposure, and reward configuration.

Get Tokenized Vaults

GET
/tokenized_vault

Query Parameters

status?Status

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

load_subaccounts?Load SubaccountsDeprecated

Load subaccounts and EOA operators for vault. (May affect performance)

Defaulttrue
load_snapshots?Load SnapshotsDeprecated

Load historical snapshots for vault. (Will significantly affect performance). Use /{vault_address}/historical-timeseries instead

Defaulttrue

Response Body

curl -X GET "https://api.upshift.finance/api/v1/tokenized_vault?status=active&load_subaccounts=true&load_snapshots=true"
[
  {
    "address": "string",
    "yield_distributor": "string",
    "chain": 0,
    "description": "string",
    "internal_type": "string",
    "public_type": "string",
    "is_featured": false,
    "is_visible": true,
    "weekly_performance_fee_bps": 0,
    "platform_fee_override": {},
    "start_datetime": "2019-08-24T14:15:22Z",
    "vault_name": "string",
    "reserve_target": 0.05,
    "reserve_tolerance": 0.01,
    "withdrawal_alert_threshold": 1,
    "withdrawal_alert_channels": "string",
    "status": "active",
    "is_charge_fees_manual": false,
    "receipt_token_symbol": "string",
    "enable_external_assets_update": false,
    "is_distributor_fee_wrapper": false,
    "vault_logo_url": "string",
    "risk": "string",
    "max_daily_drawdown": 0,
    "chain_type": "evm",
    "enabled_historical_price_horizons": [
      0
    ],
    "is_spotlighted": false,
    "show_cap_filled": false,
    "withdrawal_only": false,
    "historical_apy": {
      "property1": 0,
      "property2": 0
    },
    "default_apy_horizon": 0,
    "iat_traders": [
      "string"
    ],
    "withdrawal_margin_seconds": 0,
    "management_fee_waived_until_date": "2019-08-24T14:15:22Z",
    "management_fee_waived_until_tvl": 0,
    "performance_fee_waived_until_date": "2019-08-24T14:15:22Z",
    "performance_fee_waived_until_tvl": 0,
    "nav_base_asset_token_id": "cfe7a987-9cb7-4be1-b8f8-cc3b2da619d9",
    "nav_pricing_overrides": {},
    "apy_override": {},
    "max_drawdown": false,
    "latest_reported_tvl": false,
    "campaign_apy": 0,
    "metrics_last_updated": "2019-08-24T14:15:22Z",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "solana_vault_metadata": {
      "vault_state_pda": "string",
      "share_mint": "string",
      "deposit_mint": "string",
      "deposit_token_symbol": "string",
      "deposit_token_decimals": 0,
      "program_id": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "tokenized_vault_id": "45b03069-214b-488d-940c-77c108680385"
    },
    "stellar_vault_metadata": {
      "deposit_token_address": "string",
      "deposit_token_symbol": "string",
      "deposit_token_decimals": 0,
      "network_name": "mainnet",
      "utila_vault_id": "string",
      "utila_wallet_id": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "tokenized_vault_id": "45b03069-214b-488d-940c-77c108680385"
    },
    "instant_redeem_config": {
      "subaccount_address": "string",
      "output_asset_symbol": "string",
      "is_paused": false,
      "available_liquidity": 0,
      "redeemable_assets": [
        null
      ],
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "tokenized_vault_id": "45b03069-214b-488d-940c-77c108680385"
    },
    "view_type": "all",
    "rewards": [],
    "reported_apy": {
      "apy": 0,
      "underlying_apy": 0,
      "liquid_apy": 0,
      "rewards_compounded": 0,
      "rewards_claimable": 0,
      "explainer": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "updated_at": "2019-08-24T14:15:22Z",
      "created_at": "2019-08-24T14:15:22Z",
      "tokenized_vault_id": "45b03069-214b-488d-940c-77c108680385"
    },
    "receipt_token_integrations": [
      {
        "address": "string",
        "chain": 0,
        "token_class": "string",
        "shorthand": "string",
        "symbol": "string",
        "tiingo_ticker": "string",
        "coingecko_id": "string",
        "img_url": "string",
        "is_transferable": true,
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "updated_at": "2019-08-24T14:15:22Z",
        "created_at": "2019-08-24T14:15:22Z",
        "position_id": "a92aa83d-7963-4315-8d81-5d1c5b730d9d",
        "stable_token_pair_id": "0d2a4cbf-4f0a-4210-bf42-d452cb10ed5f"
      }
    ],
    "hardcoded_strategists": [
      {
        "strategist_name": "string",
        "strategist_logo": "string",
        "website_url": "string",
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      }
    ],
    "composability_integrations": [],
    "cached_at": "2019-08-24T14:15:22Z",
    "freshness": {
      "apy_computed_at": "2019-08-24T14:15:22Z",
      "share_ratio_snapshot_at": "2019-08-24T14:15:22Z",
      "cached_at": "2019-08-24T14:15:22Z"
    },
    "historical_snapshots": [],
    "subaccounts": [],
    "eoa_operators": [],
    "historical_compound_apy": {
      "property1": 0,
      "property2": 0
    },
    "tvl": 0,
    "pnl_per_share": {
      "property1": 0,
      "property2": 0
    },
    "daily_pnl_per_share": {
      "property1": 0,
      "property2": 0
    },
    "operators": [
      {
        "address": "string",
        "operator_type": "subaccount"
      }
    ]
  }
]
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Tokenized Vault

GET
/tokenized_vault/{vault_address}

Path Parameters

vault_addressVault Address

Query Parameters

load_subaccounts?Load Subaccounts

Load subaccounts and EOA operators for vault. (May affect performance)

Defaulttrue
load_snapshots?Load SnapshotsDeprecated

Load historical snapshots for vault. (Will significantly affect performance). Use /{vault_address}/historical-timeseries instead

Defaulttrue

Response Body

curl -X GET "https://api.upshift.finance/api/v1/tokenized_vault/string?load_subaccounts=true&load_snapshots=true"
{
  "address": "string",
  "yield_distributor": "string",
  "chain": 0,
  "description": "string",
  "internal_type": "string",
  "public_type": "string",
  "is_featured": false,
  "is_visible": true,
  "weekly_performance_fee_bps": 0,
  "platform_fee_override": {},
  "start_datetime": "2019-08-24T14:15:22Z",
  "vault_name": "string",
  "reserve_target": 0.05,
  "reserve_tolerance": 0.01,
  "withdrawal_alert_threshold": 1,
  "withdrawal_alert_channels": "string",
  "status": "active",
  "is_charge_fees_manual": false,
  "receipt_token_symbol": "string",
  "enable_external_assets_update": false,
  "is_distributor_fee_wrapper": false,
  "vault_logo_url": "string",
  "risk": "string",
  "max_daily_drawdown": 0,
  "chain_type": "evm",
  "enabled_historical_price_horizons": [
    0
  ],
  "is_spotlighted": false,
  "show_cap_filled": false,
  "withdrawal_only": false,
  "historical_apy": {
    "property1": 0,
    "property2": 0
  },
  "default_apy_horizon": 0,
  "iat_traders": [
    "string"
  ],
  "withdrawal_margin_seconds": 0,
  "management_fee_waived_until_date": "2019-08-24T14:15:22Z",
  "management_fee_waived_until_tvl": 0,
  "performance_fee_waived_until_date": "2019-08-24T14:15:22Z",
  "performance_fee_waived_until_tvl": 0,
  "nav_base_asset_token_id": "cfe7a987-9cb7-4be1-b8f8-cc3b2da619d9",
  "nav_pricing_overrides": {},
  "apy_override": {},
  "max_drawdown": false,
  "latest_reported_tvl": false,
  "campaign_apy": 0,
  "metrics_last_updated": "2019-08-24T14:15:22Z",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "solana_vault_metadata": {
    "vault_state_pda": "string",
    "share_mint": "string",
    "deposit_mint": "string",
    "deposit_token_symbol": "string",
    "deposit_token_decimals": 0,
    "program_id": "string",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "tokenized_vault_id": "45b03069-214b-488d-940c-77c108680385"
  },
  "stellar_vault_metadata": {
    "deposit_token_address": "string",
    "deposit_token_symbol": "string",
    "deposit_token_decimals": 0,
    "network_name": "mainnet",
    "utila_vault_id": "string",
    "utila_wallet_id": "string",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "tokenized_vault_id": "45b03069-214b-488d-940c-77c108680385"
  },
  "instant_redeem_config": {
    "subaccount_address": "string",
    "output_asset_symbol": "string",
    "is_paused": false,
    "available_liquidity": 0,
    "redeemable_assets": [
      null
    ],
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "tokenized_vault_id": "45b03069-214b-488d-940c-77c108680385"
  },
  "view_type": "all",
  "rewards": [],
  "reported_apy": {
    "apy": 0,
    "underlying_apy": 0,
    "liquid_apy": 0,
    "rewards_compounded": 0,
    "rewards_claimable": 0,
    "explainer": "string",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "updated_at": "2019-08-24T14:15:22Z",
    "created_at": "2019-08-24T14:15:22Z",
    "tokenized_vault_id": "45b03069-214b-488d-940c-77c108680385"
  },
  "receipt_token_integrations": [
    {
      "address": "string",
      "chain": 0,
      "token_class": "string",
      "shorthand": "string",
      "symbol": "string",
      "tiingo_ticker": "string",
      "coingecko_id": "string",
      "img_url": "string",
      "is_transferable": true,
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "updated_at": "2019-08-24T14:15:22Z",
      "created_at": "2019-08-24T14:15:22Z",
      "position_id": "a92aa83d-7963-4315-8d81-5d1c5b730d9d",
      "stable_token_pair_id": "0d2a4cbf-4f0a-4210-bf42-d452cb10ed5f"
    }
  ],
  "hardcoded_strategists": [
    {
      "strategist_name": "string",
      "strategist_logo": "string",
      "website_url": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    }
  ],
  "composability_integrations": [],
  "cached_at": "2019-08-24T14:15:22Z",
  "freshness": {
    "apy_computed_at": "2019-08-24T14:15:22Z",
    "share_ratio_snapshot_at": "2019-08-24T14:15:22Z",
    "cached_at": "2019-08-24T14:15:22Z"
  },
  "historical_snapshots": [],
  "subaccounts": [],
  "eoa_operators": [],
  "historical_compound_apy": {
    "property1": 0,
    "property2": 0
  },
  "tvl": 0,
  "pnl_per_share": {
    "property1": 0,
    "property2": 0
  },
  "daily_pnl_per_share": {
    "property1": 0,
    "property2": 0
  },
  "operators": [
    {
      "address": "string",
      "operator_type": "subaccount"
    }
  ]
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get annualized APY

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
GET
/tokenized_vault/annualized_apy/{vault_address}

Path Parameters

vault_addressVault Address

Response Body

curl -X GET "https://api.upshift.finance/api/v1/tokenized_vault/annualized_apy/string"
null
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Vault Summary

Get the summary of a specific vault by its address. Returns name, type, chain, latest snapshot and 1D/7D/30D returns for a vault.

GET
/tokenized_vault/vault_summary/{vault_address}

Path Parameters

vault_addressVault Address

Response Body

curl -X GET "https://api.upshift.finance/api/v1/tokenized_vault/vault_summary/string"
null
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Historical Timeseries

GET
/tokenized_vault/{vault_address}/historical-timeseries

Path Parameters

vault_addressVault Address

Query Parameters

n_days?N Days
Default30
Range1 <= value

Response Body

curl -X GET "https://api.upshift.finance/api/v1/tokenized_vault/string/historical-timeseries?n_days=30"
{
  "data": {
    "property1": {
      "tvl": 0,
      "daily_apy": 0,
      "daily_pnl": 0,
      "share_price": 0,
      "total_assets": 0,
      "total_shares": 0,
      "asset_share_ratio": 0,
      "missing": true
    },
    "property2": {
      "tvl": 0,
      "daily_apy": 0,
      "daily_pnl": 0,
      "share_price": 0,
      "total_assets": 0,
      "total_shares": 0,
      "asset_share_ratio": 0,
      "missing": true
    }
  },
  "trailing_apy": {
    "property1": 0,
    "property2": 0
  }
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Debank Data

Retrieve cached debank data for vault as a dict with Subaccount addresses as keys and Debank data as values

GET
/tokenized_vault/{vault_address}/debank

Path Parameters

vault_addressVault Address

Response Body

curl -X GET "https://api.upshift.finance/api/v1/tokenized_vault/string/debank"
{
  "property1": {
    "positions": [
      {
        "id": "string",
        "chain": "string",
        "name": "string",
        "logo_url": "string",
        "site_url": "string",
        "has_supported_portfolio": true,
        "portfolio_item_list": [
          {
            "stats": {
              "asset_usd_value": 0,
              "debt_usd_value": 0,
              "net_usd_value": 0
            },
            "update_at": 0,
            "name": "Yield",
            "detail_types": [
              "string"
            ],
            "detail": {
              "supply_token_list": [],
              "reward_token_list": [],
              "borrow_token_list": [],
              "health_rate": 0
            },
            "proxy_detail": {
              "project": {
                "id": "string",
                "name": "string",
                "site_url": "string",
                "logo_url": "string"
              },
              "proxy_contract_id": "string"
            },
            "position_index": "string",
            "pool": {
              "controller": "string",
              "id": "string",
              "chain": "string",
              "project_id": "string",
              "adapter_id": "string",
              "time_at": 0
            }
          }
        ]
      }
    ],
    "app_positions": [],
    "tokens": [
      {
        "id": "string",
        "chain": "string",
        "name": "string",
        "symbol": "string",
        "display_symbol": null,
        "optimized_symbol": "string",
        "decimals": 0,
        "protocol_id": "string",
        "is_core": true,
        "price": 0,
        "time_at": 0,
        "logo_url": "string",
        "price_24h_change": 0,
        "credit_score": 0,
        "is_verified": true,
        "is_scam": true,
        "is_suspicious": true,
        "is_wallet": true,
        "amount": 0,
        "raw_amount": 0
      }
    ]
  },
  "property2": {
    "positions": [
      {
        "id": "string",
        "chain": "string",
        "name": "string",
        "logo_url": "string",
        "site_url": "string",
        "has_supported_portfolio": true,
        "portfolio_item_list": [
          {
            "stats": {
              "asset_usd_value": 0,
              "debt_usd_value": 0,
              "net_usd_value": 0
            },
            "update_at": 0,
            "name": "Yield",
            "detail_types": [
              "string"
            ],
            "detail": {
              "supply_token_list": [],
              "reward_token_list": [],
              "borrow_token_list": [],
              "health_rate": 0
            },
            "proxy_detail": {
              "project": {
                "id": "string",
                "name": "string",
                "site_url": "string",
                "logo_url": "string"
              },
              "proxy_contract_id": "string"
            },
            "position_index": "string",
            "pool": {
              "controller": "string",
              "id": "string",
              "chain": "string",
              "project_id": "string",
              "adapter_id": "string",
              "time_at": 0
            }
          }
        ]
      }
    ],
    "app_positions": [],
    "tokens": [
      {
        "id": "string",
        "chain": "string",
        "name": "string",
        "symbol": "string",
        "display_symbol": null,
        "optimized_symbol": "string",
        "decimals": 0,
        "protocol_id": "string",
        "is_core": true,
        "price": 0,
        "time_at": 0,
        "logo_url": "string",
        "price_24h_change": 0,
        "credit_score": 0,
        "is_verified": true,
        "is_scam": true,
        "is_suspicious": true,
        "is_wallet": true,
        "amount": 0,
        "raw_amount": 0
      }
    ]
  }
}
Empty
Empty
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Update Tokenized Vault Reward

POST
/tokenized_vault/rewards

Authorization

Request Body

reward_id?Reward Id
vault_addressVault Address
textText
multiplierMultiplier
img_url?Img Url

Response Body

curl -X POST "https://api.upshift.finance/api/v1/tokenized_vault/rewards" \  -H "Content-Type: application/json" \  -d '{    "vault_address": "string",    "text": "string",    "multiplier": 0  }'
null
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Delete Tokenized Vault Reward

DELETE
/tokenized_vault/rewards

Authorization

Request Body

reward_idReward Id
Formatuuid

Response Body

curl -X DELETE "https://api.upshift.finance/api/v1/tokenized_vault/rewards" \  -H "Content-Type: application/json" \  -d '{    "reward_id": "f33ec279-3963-4ecc-ad39-b13e48b86554"  }'
null
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Overview

API-key endpoints for vault analytics, governance, points, and redemptions.

Upshift

Historical APY charts and per-vault strategy APY.