Convert Guides
Description
Convert is a fast and convenient method for exchanging digital assets. Without placing any orders, users simply select the assets they want to buy and sell, and the system instantly matches and executes the trade at the best available market price. Compared to traditional spot trading, convert is ideal for users who want to complete conversions quickly and are less sensitive to price fluctuations. It is widely used in scenarios such as asset conversion and fund allocation, significantly improving trading efficiency and user experience.
Base Endpoint
API: https://api.big.one/sapi/v1/convert/
Http Interface
| Interface Name | URI | Method |
|---|---|---|
| Convert Assets | /assets | GET |
| Convert Range | /range | GET |
| Convert Quote | /viewer/quote | GET |
| Create Convert Trade | /viewer/trade | POST |
| Get Convert Trades | /viewer/trades | GET |
| Get Convert Trade Detail | /viewer/trade | GET |
Rate Limits
General Info on Limits
- Responses contain the following current limit-related headers:
X-RateLimit-Limit: Maximum number of requests.X-RateLimit-Remaining: The remaining number of available requests.X-RateLimit-Reset: The time for the current limit reset (the time when the period ends).
- A 429 status code will be returned when the request rate limit is violated.
Account Limits
- Closed by default.
- If the default limit is frequently violated, it will be enabled.
IP Limits
- Closed by default.
- If the default limit is frequently violated, it will be enabled.
Default Limits
- 50 requests per second.
Typical Workflow
- First, call the Convert Assets interface to retrieve all available convertible assets.
- Next, use the Convert Range interface to get the minimum and maximum amounts for convertible assets.
- Then, call the Convert Quote interface to calculate the price by passing
from_asset,to_asset,rfq_size(quantity), andrfq_size_asset. - After obtaining the
quote_id, use the Create Convert Trade interface to execute the trade. - Finally, you can verify the status by calling Get Convert Trades or Get Convert Trade Detail.
tip
Ensure you have sufficient balance in your Funding or Spot account before placing a trade.