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.

Orchestration

Wallets

Issuance

Cards

Customers

Logistics

Additional information

Sandbox integration

Overview

Integration

Create a wallet

Simulate a deposit

Query a wallet balance

Other supported endpoints

​Overview

​Integration

​Create a wallet

​Simulate a deposit

​Query a wallet balance

​Other supported endpoints

Overview

Integration

Create a wallet

Simulate a deposit

Query a wallet balance

Other supported endpoints