Custody REST overview

The current API is the v0 surface under /v0/insto/custody/. It replaces the earlier POST /0/private/GetCustody* and POST /0/private/ListCustody* methods. Authenticate as described in Custody REST authentication.

Endpoint index

Every published operation, grouped as it appears in the sidebar. Paths link to the full operation reference.

Assets

Method	Path	Purpose
`GET`	`/v0/insto/custody/assets`	Assets available in custody, with metadata.

Organizations

Method	Path	Purpose
`GET`	`/v0/insto/custody/organizations`	Organizations the caller belongs to.
`GET`	`/v0/insto/custody/organizations/{org_iiban}/balances`	Organization-level balances.

Vaults

Method	Path	Purpose
`GET`	`/v0/insto/custody/vaults`	Vaults the caller can access, each with an aggregate `quote_value`.
`GET`	`/v0/insto/custody/vaults/{vault_id}`	Metadata for one vault.
`GET`	`/v0/insto/custody/vaults/{vault_id}/balances`	Aggregate vault valuation in a quote currency.
`GET`	`/v0/insto/custody/vaults/{vault_id}/assets/balances`	Per-asset quantities: spot, hold, available, staked, pledged.
`GET`	`/v0/insto/custody/vaults/{vault_id}/policies`	Approval policies configured on the vault.

Deposits

Method	Path	Purpose
`GET`	`/v0/insto/custody/vaults/{vault_id}/deposit-methods`	Deposit methods enabled for the vault.
`GET`	`/v0/insto/custody/vaults/{vault_id}/deposit-methods/{method_id}/addresses`	Existing deposit addresses for a method.
`POST`	`/v0/insto/custody/vaults/{vault_id}/deposit-methods/{method_id}/addresses`	Create a deposit address.
`GET`	`/v0/insto/custody/vaults/{vault_id}/deposits/info`	Deposit limits and constraints.

Withdrawals

Method	Path	Purpose
`GET`	`/v0/insto/custody/vaults/{vault_id}/whitelist/addresses`	Whitelisted withdrawal addresses.
`GET`	`/v0/insto/custody/vaults/{vault_id}/withdrawal-methods`	Withdrawal methods enabled for the vault.
`GET`	`/v0/insto/custody/vaults/{vault_id}/withdrawals/info`	Withdrawal limits and constraints.
`POST`	`/v0/insto/custody/vaults/{vault_id}/withdrawals/fee-quotes`	Quote withdrawal fees before raising a task.

Tasks

Method	Path	Purpose
`GET`	`/v0/insto/custody/tasks`	List tasks. Filter by `id`, the task’s approval UUID.
`POST`	`/v0/insto/custody/tasks`	Create a task from one or more instructions.
`GET`	`/v0/insto/custody/tasks/{task_id}`	Full task detail: instructions, initiator, reviewers, activities.
`POST`	`/v0/insto/custody/tasks/{task_id}/review`	Approve or deny a task.
`GET`	`/v0/insto/custody/tasks/activities`	List task activities. Filter by `task_id`.
`GET`	`/v0/insto/custody/tasks/activities/{activity_id}`	One activity by its `A`-prefixed activity id.

Transactions

Method	Path	Purpose
`GET`	`/v0/insto/custody/vaults/{vault_id}/transactions`	Vault transaction history. Filter by `task_id`.
`GET`	`/v0/insto/custody/vaults/{vault_id}/transactions/{transaction_id}`	One transaction.

Moving from the legacy methods

Legacy method	Replacement
`POST /0/private/ListCustodyVaults`	`GET /v0/insto/custody/vaults`
`POST /0/private/GetCustodyVault`	`GET /v0/insto/custody/vaults/{vault_id}`
`POST /0/private/GetCustodyBalance`	`GET /v0/insto/custody/vaults/{vault_id}/balances` for the aggregate, `GET /v0/insto/custody/vaults/{vault_id}/assets/balances` for per-asset quantities.
`POST /0/private/DepositMethods`	`GET /v0/insto/custody/vaults/{vault_id}/deposit-methods`
`POST /0/private/DepositAddresses`	`GET` and `POST` `/v0/insto/custody/vaults/{vault_id}/deposit-methods/{method_id}/addresses`.
`POST /0/private/WithdrawMethods`	`GET /v0/insto/custody/vaults/{vault_id}/withdrawal-methods`
`POST /0/private/WithdrawAddresses`	`GET /v0/insto/custody/vaults/{vault_id}/whitelist/addresses`
`POST /0/private/ListCustodyTransactions`	`GET /v0/insto/custody/vaults/{vault_id}/transactions`
`POST /0/private/GetCustodyTransaction`	`GET /v0/insto/custody/vaults/{vault_id}/transactions/{transaction_id}`
`POST /0/private/ListCustodyTasks`	`GET /v0/insto/custody/tasks`
`POST /0/private/GetCustodyTask`	`GET /v0/insto/custody/tasks/{task_id}`
`POST /0/private/ListCustodyActivities`	`GET /v0/insto/custody/tasks/activities`
`POST /0/private/GetCustodyActivity`	`GET /v0/insto/custody/tasks/activities/{activity_id}`
`POST /0/private/RequestCustodyTransferToSpot`	`POST /v0/insto/custody/tasks` with a `request_transfer_to_spot` instruction.

Gaps without a direct successor

Earn. There is no Custody v0 equivalent of the legacy Earn APIs. Staking positions surface indirectly through the staked component on GET /v0/insto/custody/vaults/{vault_id}/assets/balances and through the custody_staking* transaction types.
OTC quote and accept. There are no dedicated OTC quote or acceptance endpoints on Custody v0. Settled OTC activity appears as otc_buy and otc_sell transaction types. Use the OTC REST API to trade.

Assets (v0)

Organizations (v0)

Vaults (v0)

Deposits (v0)

Withdrawals (v0)

Tasks (v0)

Transactions (v0)

Endpoint index

Assets

Organizations

Vaults

Deposits

Withdrawals

Tasks

Transactions

Moving from the legacy methods

Gaps without a direct successor

​Endpoint index

​Assets

​Organizations

​Vaults

​Deposits

​Withdrawals

​Tasks

​Transactions

​Moving from the legacy methods

​Gaps without a direct successor

Endpoint index

Assets

Organizations

Vaults

Deposits

Withdrawals

Tasks

Transactions

Moving from the legacy methods

Gaps without a direct successor