List Deposit Instructions
curl --request GET \
--url https://api.hopnow.io/v1/accounts/{account_id}/deposit-instructions \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hopnow.io/v1/accounts/{account_id}/deposit-instructions"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.hopnow.io/v1/accounts/{account_id}/deposit-instructions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.hopnow.io/v1/accounts/{account_id}/deposit-instructions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.hopnow.io/v1/accounts/{account_id}/deposit-instructions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.hopnow.io/v1/accounts/{account_id}/deposit-instructions")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hopnow.io/v1/accounts/{account_id}/deposit-instructions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "<string>",
"object": "<string>",
"account_id": "<string>",
"currency": "<string>",
"status": "<string>",
"beneficiary_name": "<string>",
"beneficiary_address": "<string>",
"bank_name": "<string>",
"bank_address": "<string>",
"account_name": "<string>",
"account_number": "<string>",
"iban": "<string>",
"swift_bic": "<string>",
"routing_number": "<string>",
"sort_code": "<string>",
"memo": "<string>",
"intermediary_bank_name": "<string>",
"intermediary_swift_bic": "<string>",
"supported_rails": [
{}
],
"created": "<string>",
"updated": "<string>"
}Deposit Instructions
List Deposit Instructions
Retrieve the bank details that fund the trading account
GET
/
v1
/
accounts
/
{account_id}
/
deposit-instructions
List Deposit Instructions
curl --request GET \
--url https://api.hopnow.io/v1/accounts/{account_id}/deposit-instructions \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hopnow.io/v1/accounts/{account_id}/deposit-instructions"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.hopnow.io/v1/accounts/{account_id}/deposit-instructions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.hopnow.io/v1/accounts/{account_id}/deposit-instructions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.hopnow.io/v1/accounts/{account_id}/deposit-instructions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.hopnow.io/v1/accounts/{account_id}/deposit-instructions")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hopnow.io/v1/accounts/{account_id}/deposit-instructions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "<string>",
"object": "<string>",
"account_id": "<string>",
"currency": "<string>",
"status": "<string>",
"beneficiary_name": "<string>",
"beneficiary_address": "<string>",
"bank_name": "<string>",
"bank_address": "<string>",
"account_name": "<string>",
"account_number": "<string>",
"iban": "<string>",
"swift_bic": "<string>",
"routing_number": "<string>",
"sort_code": "<string>",
"memo": "<string>",
"intermediary_bank_name": "<string>",
"intermediary_swift_bic": "<string>",
"supported_rails": [
{}
],
"created": "<string>",
"updated": "<string>"
}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
nullDedicated 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 andmemo 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
[
{
"id": "fi_2d8b4f6a0c3e791b5d2a8f4c",
"object": "deposit_instruction",
"account_id": "acct_9f2a7c1e6a2b4f3c9b8d2e5a",
"currency": "USD",
"status": "active",
"beneficiary_name": "Hop Innovations Inc",
"beneficiary_address": "123 Main St, New York, NY 10001",
"bank_name": "Partner Bank",
"bank_address": "456 Wall St, New York, NY 10005",
"account_name": "Hop Innovations Inc",
"account_number": "1234567890",
"iban": null,
"swift_bic": "CHASUS33",
"routing_number": "021000021",
"sort_code": null,
"memo": null,
"intermediary_bank_name": null,
"intermediary_swift_bic": null,
"supported_rails": ["ach", "fedwire"],
"created": "2026-01-01T00:00:00Z",
"updated": "2026-01-01T00:00:00Z"
},
{
"id": "di_6a0c3e7d91b5f2a8c4e0b7d3",
"object": "deposit_instruction",
"account_id": "acct_9f2a7c1e6a2b4f3c9b8d2e5a",
"currency": "EUR",
"status": "active",
"beneficiary_name": "Hop2SG Limited",
"beneficiary_address": "1 Raffles Place, Singapore 048616",
"bank_name": "European Partner Bank",
"bank_address": "1 Bank Platz, Frankfurt, Germany",
"account_name": "Hop2SG Limited",
"account_number": null,
"iban": "DE89370400440532013000",
"swift_bic": "DEUTDEFFXXX",
"routing_number": null,
"sort_code": null,
"memo": "HOP-4B1D8E3F",
"intermediary_bank_name": null,
"intermediary_swift_bic": null,
"supported_rails": ["sepa", "swift"],
"created": "2026-01-01T00:00:00Z",
"updated": "2026-01-01T00:00:00Z"
}
]