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://big.one/sapi/v1/convert/
Http Interface
| Interface Name | URI | method |
|---|---|---|
| ConvertAssets | /assets | GET |
| ConvertRange | /range | GET |
| ConvertQuote | /viewer/quote | GET |
| ConvertTradeCreate | /viewer/trade | POST |
| GetConvertTrades | /viewer/trades | GET |
| GetConvertTradeDetail | /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 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 limit per second.
Introduction
- First, call the ConvertAssets interface to retrieve all available convertible assets.
- Next, use the ConvertRange interface to get the minimum and maximum numbers of convertible assets from all available convert makers.
- Then, call the ConvertQuote interface to calculate the price by passing from_asset, to_asset, rfq_size_asset(same with from_asset or to_asset) and the quantity (rfq_size) of the rfq_size_asset.
- After obtaining the quote_id from step 3, use the ConvertTradeCreate interface to create a conversion trade.
- Additionally, you can view the trades created in step 4 by calling the GetConvertTrades and GetConvertTradeDetail interfaces.