Skip to main content
GET
List Deposit Instructions
Returns every bank-transfer instruction that credits the trading account. Virtual accounts carry their own bank details on the virtual account object and are not listed here. This endpoint covers fiat deposits only. To receive crypto, create a wallet. See the Deposit Flows guide for the full picture. The response is a bare JSON array, not a paginated {items, page, size, total, pages} envelope. There are no page or size parameters. Every instruction is returned in one response. Requires an API key with read access on the accounts scope.

Path Parameters

string
required
The account’s external ID (starts with acct_)

Response

An array of deposit instruction objects: dedicated-account instructions first, then memo-routed instructions. An account can hold several instructions per currency.
string
Unique identifier for this deposit instruction. Dedicated-account instructions use fi_…; legacy records may use va_…. Shared-account instructions use di_…. Check memo to determine whether a payment reference is required.
string
Always returns "deposit_instruction"
string
The account these instructions belong to (starts with acct_)
string
Currency code from the accepted list the instruction accepts
string
Always returns "active". An instruction that has been withdrawn is not listed at all.
string
Name the payer should address the payment to. Nullable.
string
Address of the beneficiary. Nullable.
string
Name of the receiving bank. Nullable.
string
Address of the receiving bank. Nullable.
string
Name on the receiving bank account. Nullable.
string
Bank account number. Nullable.
string
International Bank Account Number. Nullable.
string
SWIFT/BIC code of the receiving bank. Nullable.
string
Routing number, for US rails. Nullable.
string
Sort code, for UK rails. Nullable.
string
Payment reference required for shared-account instructions. The payer must include the returned value exactly. null for dedicated-account instructions.
string
Name of the intermediary bank, when the partner requires one for correspondent routing. Nullable.
string
SWIFT/BIC of the intermediary bank. Nullable.
array
Payment rails this instruction accepts. Values: ach, fedwire, swift, sepa, spei, pix, faster_payments.
string
ISO 8601 timestamp when created
string
ISO 8601 timestamp when last updated, or null

Dedicated accounts and memo routing

A dedicated-account instruction gives the account its own account number or IBAN at the partner bank. No Hop payment reference is required and memo is null. A shared-account instruction points at a bank account Hop shares between several customers. The payer must include the exact returned memo as the payment reference so Hop can credit the correct trading account. Display it as a required field alongside the bank details. A missing or altered reference can delay crediting the deposit.

Response Example