Crypto

Add wallet to address book

Add cryptocurrency wallets to your address book. Required before trading - only address book wallets can be used as destinations.

Address Book Concept

The address book serves as a security and management layer:

Required for Trading: Only address book wallets can be used in Execute crypto purchase
Security Monitoring: Added wallets are integrated into our monitoring system
Address Validation: Addresses are validated against the specified network
Audit Trail: All transactions to address book wallets are fully tracked

Prerequisites

Use List available crypto products to see supported networks for each crypto
Ensure wallet network matches the crypto you want to receive

Usage Flow

List available crypto products - Check supported networks
Add wallet using this endpoint with matching network
List address book wallets - Verify wallet was added successfully
Execute crypto purchase - Use wallet ID for crypto purchases

POST

crypto

wallets

Add wallet to address book

curl --request POST \
  --url http://api.obsidiam.com/crypto/wallets \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "symbol": "usdt",
  "network": "ethereum",
  "address": "<string>"
}
'

{
  "id": "<string>",
  "name": "<string>",
  "symbol": "usdt",
  "network": "ethereum",
  "address": "<string>"
}

Body

application/json

name

string

required

Friendly name for the wallet (e.g., "My USDT Wallet")

symbol

enum<string>

required

Cryptocurrency symbol this wallet will receive

Available options:

usdt,

usdc,

trx,

eth

network

enum<string>

required

Blockchain network for this wallet address

Available options:

ethereum,

tron,

polygon,

binance,

solana

address

string

required

Valid wallet address on the specified network

Response

default - application/json

string

required

Unique identifier for the created wallet

name

string

required

Friendly name of the wallet

symbol

enum<string>

required

Cryptocurrency symbol for this wallet

Available options:

usdt,

usdc,

trx,

eth

network

enum<string>

required

Blockchain network for this wallet

Available options:

ethereum,

tron,

polygon,

binance,

solana

address

string

required

Wallet address on the blockchain

Get crypto quote Get real-time pricing for cryptocurrency purchases. **Required before execution** - quotes provide the pricing and quote ID needed for purchases. #### Key Concepts - **Quote Validity**: Valid until `expireAtUnix` timestamp (typically 30 seconds) - **Refresh Strategy**: Request new quotes every 5 seconds to avoid expiration - **Quote ID**: Use returned `quoteId` in [Execute crypto purchase](/api-reference/crypto/execute-crypto-purchase) #### Prerequisites - [List available crypto products](/api-reference/crypto/list-available-crypto-products) - Verify symbol/settlement combinations are available - [Add wallet to address book](/api-reference/crypto/add-wallet-to-address-book) - Ensure destination wallet exists in address book #### Usage Flow 1. [List available crypto products](/api-reference/crypto/list-available-crypto-products) - Check available symbol/settlement options 2. **Request quote** using this endpoint 3. Present pricing to user (check expiration) 4. [Execute crypto purchase](/api-reference/crypto/execute-crypto-purchase) - Execute purchase with `quoteId` #### Next Steps - [Execute crypto purchase](/api-reference/crypto/execute-crypto-purchase) - Execute purchase using the `quoteId` - **Refresh quotes** every 5 seconds if user delays decision

⌘I

Add wallet to address book

curl --request POST \
  --url http://api.obsidiam.com/crypto/wallets \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "symbol": "usdt",
  "network": "ethereum",
  "address": "<string>"
}
'

{
  "id": "<string>",
  "name": "<string>",
  "symbol": "usdt",
  "network": "ethereum",
  "address": "<string>"
}

Endpoints

Body

Response