Skip to main content

​
Overview

Bridge wallets are fully supported in sandbox, allowing you to test wallet creation, deposits, and balance queries without moving real funds.
Send all sandbox requests to https://api.sandbox.bridge.xyz

​
Integration

​
Create a wallet

Create a Bridge wallet for a customer using the standard wallet creation endpoint: 
curl --request POST \
     --url https://api.sandbox.bridge.xyz/v0/customers/{customerId}/wallets \
     --header 'Api-Key: <API Key>' \
     --header 'Idempotency-Key: <Unique Idempotency Key>' \
     --header 'Content-Type: application/json' \
     --data '{
       "chain": "solana"
     }'
Response
{
  "id": "uuid",
  "chain": "solana",
  "address": "the-blockchain-address",
  "created_at": "2024-09-01T02:03:04.567Z",
  "updated_at": "2024-09-01T02:03:04.567Z"
}
Sandbox creates a wallet with a fake address and bypasses external wallet provider calls.

​
Simulate a deposit

In production, you fund a wallet using Transfers, Liquidation Addresses, or Virtual Accounts. In sandbox, you can simulate a deposit directly to a wallet: 
curl -X POST 'https://api.sandbox.bridge.xyz/v0/customers/<CustomerId>/wallets/<WalletId>/simulate_deposit' \
 --header 'Content-Type: application/json' \
 --header 'Api-Key: <ApiKey>' \
 --header 'Idempotency-Key: <IdempotencyKey>' \
 -d '{
   "amount": "100.0",
   "currency": "usdc"
 }'
This simulates the full deposit flow, including:
  • Creating a token deposit event
  • Processing through the hot wallet pipeline
  • Updating the wallet balance
  • Transitioning the deposit to a terminal state

​
Query a wallet balance

Check the balance of a wallet after simulating a deposit: 
curl --request GET \
     --url https://api.sandbox.bridge.xyz/v0/customers/{customerId}/wallets/{walletId} \
     --header 'Api-Key: <API Key>'
Response
{
  "id": "uuid",
  "chain": "solana",
  "address": "the-blockchain-address",
  "created_at": "2024-09-01T02:03:04.567Z",
  "updated_at": "2024-09-01T02:03:04.567Z",
  "balances": [
    {
      "balance": "100.00",
      "currency": "usdc",
      "chain": "solana",
      "contract_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
    }
  ]
}

​
Other supported endpoints

All standard Bridge wallet endpoints work in sandbox:
  • GET /v0/customers/{customerId}/wallets - List all wallets for a customer
  • GET /v0/wallets - List all wallets
  • GET /v0/wallets/total_balances - Get aggregate balance across all wallets
  • GET /v0/customers/{customerId}/wallets/{walletId}/history - Get transaction history
See Move money to and from wallets for full endpoint documentation.