Crypto
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
expireAtUnixtimestamp (typically 30 seconds) - Refresh Strategy: Request new quotes every 5 seconds to avoid expiration
- Quote ID: Use returned
quoteIdin Execute crypto purchase
Prerequisites
- List available crypto products - Verify symbol/settlement combinations are available
- Add wallet to address book - Ensure destination wallet exists in address book
Usage Flow
- List available crypto products - Check available symbol/settlement options
- Request quote using this endpoint
- Present pricing to user (check expiration)
- Execute crypto purchase - Execute purchase with
quoteId
Next Steps
-
Execute crypto purchase - Execute purchase using the
quoteId -
Refresh quotes every 5 seconds if user delays decision
Previous
Execute crypto purchase
Execute a cryptocurrency purchase using a valid quote. **Final step** in the trading flow - converts quote into actual transaction.
#### Prerequisites
- [Get crypto quote](/api-reference/crypto/get-crypto-quote) - Must have valid, unexpired `quoteId`
- [List address book wallets](/api-reference/crypto/list-address-book-wallets) - Must use wallet ID from address book
- **Account Balance** - Specified account must have sufficient funds
#### Key Concepts
- **Quote Expiration**: Ensure quote hasn't expired before execution
- **Address Book Only**: Can only send to wallets from [List address book wallets](/api-reference/crypto/list-address-book-wallets)
- **Immediate Processing**: Creates transaction immediately upon success
#### Usage Flow
1. [Get crypto quote](/api-reference/crypto/get-crypto-quote) - Get valid quote and `quoteId`
2. [List address book wallets](/api-reference/crypto/list-address-book-wallets) - Select destination wallet ID
3. **Execute purchase** using this endpoint
4. [Get transaction details](/api-reference/crypto/get-transaction-details) - Monitor transaction progress
#### After Execution
- [List crypto transactions](/api-reference/crypto/list-crypto-transactions) - View transaction in your history
- [Get transaction details](/api-reference/crypto/get-transaction-details) - Monitor detailed progress
- [Pay crypto transaction debt](/api-reference/crypto/pay-crypto-transaction-debt) - Make payments if needed
#### Error Scenarios
- Quote expired → Get new quote with [Get crypto quote](/api-reference/crypto/get-crypto-quote)
- Invalid wallet → Add wallet with [Add wallet to address book](/api-reference/crypto/add-wallet-to-address-book)
- Insufficient balance → Fund account or reduce purchase amount
Next