Deposit Assets - Deposit Fiat
Get bank deposit details and memo ID for fiat currency deposits to a Go Account. See the Guide.
-
Get the BitGo bank account details and a memo ID for your fiat deposit. All wire transfers must include the memo ID — this links your deposit to your Go Account and prevents delays.
The response includes bank account information (routing number, account number, address) and any applicable fees. Use these details when initiating the transfer from your bank.
Prerequisites: You must have a Go Account. See Get Started.
-
Initiate a wire or ACH transfer from your bank account to the BitGo bank account returned in the previous step. Use your bank's app or API to complete this transfer — there is no BitGo API call for this step.
Ensure you include the
memoIdfrom the previous step in your wire transfer. ACH deposits are currently only available for clients with a Crypto-as-a-Service (CaaS) integration. Your bank may charge a wire-transfer fee.The balance of fiat currency in your Go Account updates with the deposited amount and is immediately available for trades. You can verify successful deposits with the Get Account Balance endpoint.
// 1. Get Deposit Details
export ACCESS_TOKEN="<YOUR_ACCESS_TOKEN>"
export GO_ACCOUNT_ID="GO_ACCOUNT_ID"
export CURRENCY="tfiatusd"
curl -X GET \
"https://app.bitgo-test.com/api/v2/bankaccounts/deposit/info?goAccountId=$GO_ACCOUNT_ID¤cy=$CURRENCY" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"
// 2. Deposit Fiat Currency
// Initiate a wire or ACH transfer from your bank — no API call required
// 1. Get Deposit Details
export type Fee {
amount: string
individualFees:
{
type: "static" | "variable",
amount: string
}[]
}
export type BankAccount {
id: string;
description?: string;
idHash: string;
currency: string;
accountNumber: string;
token: string;
name: string;
shortCountryCode: string;
enterpriseId: string;
trustOrg: string;
ownerName: string;
verificationState: string;
createdAt: string;
ownerAddressLine1: string;
ownerAddressLine2?: string;
ownerAddressCityLocality?: string;
ownerAddressStateProvince?: string;
ownerAddressPostalCode?: string;
ownerAddressCountryCode: string;
bankAddressLine1: string;
bankAddressLine2?: string;
bankAddressCityLocality?: string;
bankAddressStateProvince?: string;
bankAddressPostalCode?: string;
bankAddressCountryCode: string;
virtualDepositOnly: boolean;
type: string;
routingNumber?: string;
swiftCode?: string;
accountType: string;
fee: Fee
}
export type DepositInfo = {
memoId: string;
bankAccounts: BankAccount[];
};
// 2. Deposit Fiat Currency
// Initiate a wire or ACH transfer from your bank — no API call required
// 1. Get Deposit Details Response
{
"memoId": "JVAIBEMHXT",
"bankAccounts": [
{
"id": "64ae84bdb25d190007958872b5104a7f",
"idHash": "cd303c82c4c74abf",
"currency": "tfiatusd",
"accountNumber": "5766400",
"token": "tusd",
"name": "Customers Bank ",
"shortCountryCode": "US",
"enterpriseId": "5bd795f1bf7435a503a0a647ec5d3b3d",
"trustOrg": "BitGo Trust",
"ownerName": "BitGo Trust Company, Inc",
"verificationState": "approved",
"createdAt": "2024-03-07T17:10:57.146Z",
"ownerAddressLine1": "6216 S Pinnacle Pl Ste #101",
"ownerAddressCityLocality": "Sioux Falls",
"ownerAddressStateProvince": "SD",
"ownerAddressPostalCode": "57108",
"ownerAddressCountryCode": "US",
"bankAddressLine1": "40 General Blvd Suite #200",
"bankAddressCityLocality": "Malvern",
"bankAddressStateProvince": "PA",
"bankAddressPostalCode": "19355",
"bankAddressCountryCode": "US",
"virtualDepositOnly": false,
"type": "wire",
"routingNumber": "031302971",
"accountType": "unknown",
"fee": {
"amount": "1600",
"individualFees": [
{
"type": "static",
"amount": "1600"
}
]
}
}
]
}