Retrieve the full configuration of a single Offloader Wallet by its ID. The response includes the on-chain address to share with the customer, the linked bank account destination, the blockchain network, and the current fee structure. Use this endpoint to verify a wallet’s setup or to look up an address before directing a customer to deposit funds.
Endpoint GET https://api.spherepay.co/v2/offloader-wallet/{id}
Authentication All requests must include a Bearer token in the Authorization header.
Authorization: Bearer < toke n>
Path parameters The ID of the offloader wallet to retrieve.
-H "Authorization: Bearer <token>"
Response fields Unique identifier for the offloader wallet.
The ID of the customer who owns this wallet.
The on-chain wallet address where the customer sends stablecoins.
The stablecoin this wallet accepts (e.g., "usdc").
The blockchain network this wallet is deployed on (e.g., "ethereum").
The bank account destination configuration. The ID of the linked bank account.
The fiat currency funds are converted into (e.g., "usd").
The banking rail used for payouts (e.g., "ach", "wire", "sepa").
ACH reference string, if applicable.
Your integrator fee, including bpsRate and currency.
SpherePay’s platform fee, including bpsRate and currency.
The on-chain address funds are returned to on failed transactions.
ISO 8601 timestamp of when the wallet was created.
ISO 8601 timestamp of the last update to the wallet.
{ "id" : "wallet_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6" , "customerId" : "customer_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6" , "address" : "0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97" , "currency" : "usdc" , "network" : "ethereum" , "destination" : { "bankAccountId" : "bankAccount_6221e8d4299f4a889bd882255e92f581" , "currency" : "usd" , "network" : "ach" , "achReference" : "REF123" }, "fees" : { "integratorFee" : { "bpsRate" : "100" , "currency" : "usdc" }, "platformFee" : { "bpsRate" : "30" , "currency" : "usdc" } }, "returnAddress" : "0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97" , "created" : "2024-06-15T10:30:00.000Z" , "updated" : "2024-06-15T12:00:00.000Z" }
