UpshiftDocs
REST APIInstitutional API

Vault History

Deposit, withdrawal, and archive history for a vault.

Get Archived Vaults

List vault addresses that have a history snapshot in this collection.

This is the source of truth for "which vaults are served from the snapshot": a vault appears here only once its history has been backfilled, so a client can route to this API without ever rerouting a vault to empty data ahead of its backfill. Read-only.

Returns: Distinct vault addresses (lowercased) present in upshift.vault_history.

GET
/upshift/vault_history/archived

Response Body

curl -X GET "https://api.upshift.finance/api/v1/upshift/vault_history/archived"
[
  "string"
]

Get Vault User History

Deposit/withdraw history for a vault, served from the Mongo snapshot.

Backs the SDK/app vault history for archived vaults whose subgraph is being retired, so user history keeps working once the subgraph is gone. Read-only. Populated by scripts/upshift/vault_history_backfill.py.

Args: vault_address: Vault contract address (the pool). db: MongoDB session dependency. wallet: Optional user address to filter to. chain_id: Optional chain id to filter to. type: Optional deposit/withdraw filter. limit: Max records, newest first.

GET
/upshift/vault_history/{vault_address}

Path Parameters

vault_addressVault Address

Query Parameters

wallet?Wallet

Filter to a single user (depositor or receiver).

chain_id?Chain Id

Filter to a single chain id.

type?Type

Filter to only deposits or only withdraws.

limit?Limit
Default5000
Range1 <= value <= 5000

Response Body

curl -X GET "https://api.upshift.finance/api/v1/upshift/vault_history/string?wallet=string&chain_id=0&type=deposit&limit=5000"
[
  {
    "timestamp": "2019-08-24T14:15:22Z",
    "type": "deposit",
    "wallet": "string",
    "pool": "string",
    "chain_id": 0,
    "amount_raw": "string",
    "transaction_hash": "string",
    "block_number": 0,
    "asset_address": "string"
  }
]
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}