Trading API
Convert between currencies, manage trading venues, view rates, and access market data.
Conversion
List Conversions
GET /api/v1/conversion
List all conversions with optional filters.
| Query | Type | Description |
|---|---|---|
assetPoolId | UUID | Filter by asset pool |
status | string | PENDING, PROCESSING, COMPLETE, CANCELLED, FAILED |
fromDate | ISO 8601 | Start date |
toDate | ISO 8601 | End date |
offset | number | Pagination offset |
limit | number | Page size |
Create Conversion
POST /api/v1/conversion
Execute a currency conversion.
| Field | Type | Required | Description |
|---|---|---|---|
assetPoolId | UUID | Yes | Source asset pool |
fromCurrency | string | Yes | Source currency |
toCurrency | string | Yes | Destination currency |
amount | number | Yes | Amount to convert |
side | string | Yes | BUY or SELL |
Estimate Conversion
POST /api/v1/conversion/estimate
Get an indicative rate and estimated amount without executing.
| Field | Type | Required | Description |
|---|---|---|---|
fromCurrency | string | Yes | Source currency |
toCurrency | string | Yes | Destination currency |
amount | number | Yes | Amount |
Response:
{
"fromCurrency": "USDC",
"toCurrency": "EUR",
"amount": 10000.00,
"estimatedAmount": 9216.00,
"rate": 0.9216,
"validUntil": "2026-01-15T10:25:30Z"
}
Get Conversion
GET /api/v1/conversion/{uuid}
Cancel Conversion
DELETE /api/v1/conversion/{uuid}
Cancel a pending conversion.
List Possible Destination Assets
GET /api/v1/conversion/destination-assets
List all assets that a given source asset can be converted to.
| Query | Type | Description |
|---|---|---|
fromAsset | string | Source asset code |
Venues
List Venues
GET /api/v1/venue
List all connected trading venues.
Update Venue Settings
PATCH /api/v1/venue/{id}
Update settings for a specific trading venue.
Venue Withdrawal
List Venue Withdrawals
GET /api/v1/venue-withdrawal
Request Venue Withdrawal
POST /api/v1/venue-withdrawal
Withdraw funds from a trading venue to your asset pool.
| Field | Type | Required | Description |
|---|---|---|---|
venueId | UUID | Yes | Source venue |
asset | string | Yes | Asset to withdraw |
amount | number | Yes | Amount |
assetPoolId | UUID | Yes | Destination pool |
Get Venue Withdrawal
GET /api/v1/venue-withdrawal/{id}
Venue Deposit Address
List Venue Deposit Addresses
GET /api/v1/venue-deposit-address
Request New Venue Deposit Address
POST /api/v1/venue-deposit-address
Generate a new deposit address on a trading venue.
Venue Deposit
List Venue Deposits
GET /api/v1/venue-deposit
Get Venue Deposit
GET /api/v1/venue-deposit/{id}
Venue Balance
List Venue Balances
GET /api/v1/venue-balance
Get Venue Balance Summary
GET /api/v1/venue-balance/summary
Get aggregated balance across all venues, grouped by asset.
Export
List Trading Exports
GET /api/v1/trading/export
Create Conversion Export
POST /api/v1/trading/export
Create an export of conversion data.
| Field | Type | Required | Description |
|---|---|---|---|
fromDate | ISO 8601 | Yes | Start date |
toDate | ISO 8601 | Yes | End date |
format | string | No | CSV or JSON |
Get Trading Export
GET /api/v1/trading/export/{id}
Get export with download link.
Rates
Get Indicative Exchange Rate
GET /api/v1/rates
| Query | Type | Description |
|---|---|---|
base | string | Base currency (e.g., USDC) |
counter | string | Counter currency (e.g., EUR) |
Get All Indicative Exchange Rates
GET /api/v1/rates/all
Returns rates for all supported currency pairs.
Market Data
Get Tickers
GET /api/v1/market-data/tickers
| Query | Type | Description |
|---|---|---|
pair | string | Trading pair (e.g., BTC-USD) |
Get Order Books
GET /api/v1/market-data/order-book
Get Aggregated Order Book
GET /api/v1/market-data/order-book/aggregated
Combined order book across all connected liquidity venues for best pricing.