All URIs are relative to https://api.gateio.ws/api/v4
Method | HTTP request | Description |
---|---|---|
ListCurrencies | GET /spot/currencies | List all currencies' details |
GetCurrency | GET /spot/currencies/{currency} | Get details of a specific currency |
ListCurrencyPairs | GET /spot/currency_pairs | List all currency pairs supported |
GetCurrencyPair | GET /spot/currency_pairs/{currency_pair} | Get details of a specifc currency pair |
ListTickers | GET /spot/tickers | Retrieve ticker information |
ListOrderBook | GET /spot/order_book | Retrieve order book |
ListTrades | GET /spot/trades | Retrieve market trades |
ListCandlesticks | GET /spot/candlesticks | Market candlesticks |
GetFee | GET /spot/fee | Query user trading fee rates |
GetBatchSpotFee | GET /spot/batch_fee | Query a batch of user trading fee rates |
ListSpotAccounts | GET /spot/accounts | List spot accounts |
ListSpotAccountBook | GET /spot/account_book | Query account book |
CreateBatchOrders | POST /spot/batch_orders | Create a batch of orders |
ListAllOpenOrders | GET /spot/open_orders | List all open orders |
CreateCrossLiquidateOrder | POST /spot/cross_liquidate_orders | close position when cross-currency is disabled |
ListOrders | GET /spot/orders | List orders |
CreateOrder | POST /spot/orders | Create an order |
CancelOrders | DELETE /spot/orders | Cancel all `open` orders in specified currency pair |
CancelBatchOrders | POST /spot/cancel_batch_orders | Cancel a batch of orders with an ID list |
GetOrder | GET /spot/orders/{order_id} | Get a single order |
CancelOrder | DELETE /spot/orders/{order_id} | Cancel a single order |
AmendOrder | PATCH /spot/orders/{order_id} | Amend an order |
ListMyTrades | GET /spot/my_trades | List personal trading history |
GetSystemTime | GET /spot/time | Get server current time |
CountdownCancelAllSpot | POST /spot/countdown_cancel_all | Countdown cancel orders |
AmendBatchOrders | POST /spot/amend_batch_orders | Batch modification of orders |
ListSpotPriceTriggeredOrders | GET /spot/price_orders | Retrieve running auto order list |
CreateSpotPriceTriggeredOrder | POST /spot/price_orders | Create a price-triggered order |
CancelSpotPriceTriggeredOrderList | DELETE /spot/price_orders | Cancel all open orders |
GetSpotPriceTriggeredOrder | GET /spot/price_orders/{order_id} | Get a price-triggered order |
CancelSpotPriceTriggeredOrder | DELETE /spot/price_orders/{order_id} | cancel a price-triggered order |
List<Currency> ListCurrencies ()
List all currencies' details
Currency has two forms: 1. Only currency name, e.g., BTC, USDT 2. <currency>_<chain>
, e.g., HT_ETH
The latter one occurs when one currency has multiple chains. Currency detail contains a chain
field whatever the form is. To retrieve all chains of one currency, you can use use all the details which has the name of the currency or name starting with <currency>_
.
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class ListCurrenciesExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
var apiInstance = new SpotApi(config);
try
{
// List all currencies' details
List<Currency> result = apiInstance.ListCurrencies();
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.ListCurrencies: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
This endpoint does not need any parameter.
No authorization required
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | List retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
Currency GetCurrency (string currency)
Get details of a specific currency
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class GetCurrencyExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
var apiInstance = new SpotApi(config);
var currency = "GT"; // string | Currency name
try
{
// Get details of a specific currency
Currency result = apiInstance.GetCurrency(currency);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.GetCurrency: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
currency | string | Currency name |
No authorization required
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successfully retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List<CurrencyPair> ListCurrencyPairs ()
List all currency pairs supported
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class ListCurrencyPairsExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
var apiInstance = new SpotApi(config);
try
{
// List all currency pairs supported
List<CurrencyPair> result = apiInstance.ListCurrencyPairs();
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.ListCurrencyPairs: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
This endpoint does not need any parameter.
No authorization required
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | All currency pairs retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
CurrencyPair GetCurrencyPair (string currencyPair)
Get details of a specifc currency pair
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class GetCurrencyPairExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
var apiInstance = new SpotApi(config);
var currencyPair = "ETH_BTC"; // string | Currency pair
try
{
// Get details of a specifc currency pair
CurrencyPair result = apiInstance.GetCurrencyPair(currencyPair);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.GetCurrencyPair: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
currencyPair | string | Currency pair |
No authorization required
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successfully retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List<Ticker> ListTickers (string currencyPair = null, string timezone = null)
Retrieve ticker information
Return only related data if currency_pair
is specified; otherwise return all of them
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class ListTickersExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
var apiInstance = new SpotApi(config);
var currencyPair = "BTC_USDT"; // string | Currency pair (optional)
var timezone = "utc0"; // string | Timezone (optional)
try
{
// Retrieve ticker information
List<Ticker> result = apiInstance.ListTickers(currencyPair, timezone);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.ListTickers: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
currencyPair | string | Currency pair | [optional] |
timezone | string | Timezone | [optional] |
No authorization required
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successfully retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
OrderBook ListOrderBook (string currencyPair, string interval = null, int? limit = null, bool? withId = null)
Retrieve order book
Order book will be sorted by price from high to low on bids; low to high on asks
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class ListOrderBookExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
var apiInstance = new SpotApi(config);
var currencyPair = "BTC_USDT"; // string | Currency pair
var interval = "\"0\""; // string | Order depth. 0 means no aggregation is applied. default to 0 (optional) (default to "0")
var limit = 10; // int? | Maximum number of order depth data in asks or bids (optional) (default to 10)
var withId = false; // bool? | Return order book ID (optional) (default to false)
try
{
// Retrieve order book
OrderBook result = apiInstance.ListOrderBook(currencyPair, interval, limit, withId);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.ListOrderBook: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
currencyPair | string | Currency pair | |
interval | string | Order depth. 0 means no aggregation is applied. default to 0 | [optional] [default to "0"] |
limit | int? | Maximum number of order depth data in asks or bids | [optional] [default to 10] |
withId | bool? | Return order book ID | [optional] [default to false] |
No authorization required
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successfully retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List<Trade> ListTrades (string currencyPair, int? limit = null, string lastId = null, bool? reverse = null, long? from = null, long? to = null, int? page = null)
Retrieve market trades
You can use from
and to
to query by time range, or use last_id
by scrolling page. The default behavior is by time range. Scrolling query using last_id
is not recommended any more. If last_id
is specified, time range query parameters will be ignored.
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class ListTradesExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
var apiInstance = new SpotApi(config);
var currencyPair = "BTC_USDT"; // string | Currency pair
var limit = 100; // int? | Maximum number of records to be returned in a single list. Default: 100, Minimum: 1, Maximum: 1000 (optional) (default to 100)
var lastId = "12345"; // string | Specify list staring point using the `id` of last record in previous list-query results (optional)
var reverse = false; // bool? | Whether the id of records to be retrieved should be less than the last_id specified. Default to false. When `last_id` is specified. Set `reverse` to `true` to trace back trading history; `false` to retrieve latest tradings. No effect if `last_id` is not specified. (optional) (default to false)
var from = 1627706330; // long? | Start timestamp of the query (optional)
var to = 1635329650; // long? | Time range ending, default to current time (optional)
var page = 1; // int? | Page number (optional) (default to 1)
try
{
// Retrieve market trades
List<Trade> result = apiInstance.ListTrades(currencyPair, limit, lastId, reverse, from, to, page);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.ListTrades: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
currencyPair | string | Currency pair | |
limit | int? | Maximum number of records to be returned in a single list. Default: 100, Minimum: 1, Maximum: 1000 | [optional] [default to 100] |
lastId | string | Specify list staring point using the `id` of last record in previous list-query results | [optional] |
reverse | bool? | Whether the id of records to be retrieved should be less than the last_id specified. Default to false. When `last_id` is specified. Set `reverse` to `true` to trace back trading history; `false` to retrieve latest tradings. No effect if `last_id` is not specified. | [optional] [default to false] |
from | long? | Start timestamp of the query | [optional] |
to | long? | Time range ending, default to current time | [optional] |
page | int? | Page number | [optional] [default to 1] |
No authorization required
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | List retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List<List<string>> ListCandlesticks (string currencyPair, int? limit = null, long? from = null, long? to = null, string interval = null)
Market candlesticks
Maximum of 1000 points can be returned in a query. Be sure not to exceed the limit when specifying from, to and interval
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class ListCandlesticksExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
var apiInstance = new SpotApi(config);
var currencyPair = "BTC_USDT"; // string | Currency pair
var limit = 100; // int? | Maximum recent data points to return. `limit` is conflicted with `from` and `to`. If either `from` or `to` is specified, request will be rejected. (optional) (default to 100)
var from = 1546905600; // long? | Start time of candlesticks, formatted in Unix timestamp in seconds. Default to`to - 100 * interval` if not specified (optional)
var to = 1546935600; // long? | End time of candlesticks, formatted in Unix timestamp in seconds. Default to current time (optional)
var interval = "30m"; // string | Interval time between data points. Note that `30d` means 1 natual month, not 30 days (optional) (default to 30m)
try
{
// Market candlesticks
List<List<string>> result = apiInstance.ListCandlesticks(currencyPair, limit, from, to, interval);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.ListCandlesticks: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
currencyPair | string | Currency pair | |
limit | int? | Maximum recent data points to return. `limit` is conflicted with `from` and `to`. If either `from` or `to` is specified, request will be rejected. | [optional] [default to 100] |
from | long? | Start time of candlesticks, formatted in Unix timestamp in seconds. Default to`to - 100 * interval` if not specified | [optional] |
to | long? | End time of candlesticks, formatted in Unix timestamp in seconds. Default to current time | [optional] |
interval | string | Interval time between data points. Note that `30d` means 1 natual month, not 30 days | [optional] [default to 30m] |
List<List>
No authorization required
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successfully retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
SpotFee GetFee (string currencyPair = null)
Query user trading fee rates
This API is deprecated in favour of new fee retrieving API /wallet/fee
.
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class GetFeeExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var currencyPair = "BTC_USDT"; // string | Specify a currency pair to retrieve precise fee rate This field is optional. In most cases, the fee rate is identical among all currency pairs (optional)
try
{
// Query user trading fee rates
SpotFee result = apiInstance.GetFee(currencyPair);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.GetFee: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
currencyPair | string | Specify a currency pair to retrieve precise fee rate This field is optional. In most cases, the fee rate is identical among all currency pairs | [optional] |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successfully retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
Dictionary<string, SpotFee> GetBatchSpotFee (string currencyPairs)
Query a batch of user trading fee rates
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class GetBatchSpotFeeExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var currencyPairs = "BTC_USDT,ETH_USDT"; // string | A request can only query up to 50 currency pairs
try
{
// Query a batch of user trading fee rates
Dictionary<string, SpotFee> result = apiInstance.GetBatchSpotFee(currencyPairs);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.GetBatchSpotFee: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
currencyPairs | string | A request can only query up to 50 currency pairs |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successfully retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List<SpotAccount> ListSpotAccounts (string currency = null)
List spot accounts
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class ListSpotAccountsExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var currency = "BTC"; // string | Retrieve data of the specified currency (optional)
try
{
// List spot accounts
List<SpotAccount> result = apiInstance.ListSpotAccounts(currency);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.ListSpotAccounts: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
currency | string | Retrieve data of the specified currency | [optional] |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | List retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List<SpotAccountBook> ListSpotAccountBook (string currency = null, long? from = null, long? to = null, int? page = null, int? limit = null, string type = null)
Query account book
Record time range cannot exceed 30 days
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class ListSpotAccountBookExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var currency = "BTC"; // string | Retrieve data of the specified currency (optional)
var from = 1627706330; // long? | Start timestamp of the query (optional)
var to = 1635329650; // long? | Time range ending, default to current time (optional)
var page = 1; // int? | Page number (optional) (default to 1)
var limit = 100; // int? | Maximum number of records to be returned in a single list (optional) (default to 100)
var type = "lend"; // string | Only retrieve changes of the specified type. All types will be returned if not specified. (optional)
try
{
// Query account book
List<SpotAccountBook> result = apiInstance.ListSpotAccountBook(currency, from, to, page, limit, type);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.ListSpotAccountBook: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
currency | string | Retrieve data of the specified currency | [optional] |
from | long? | Start timestamp of the query | [optional] |
to | long? | Time range ending, default to current time | [optional] |
page | int? | Page number | [optional] [default to 1] |
limit | int? | Maximum number of records to be returned in a single list | [optional] [default to 100] |
type | string | Only retrieve changes of the specified type. All types will be returned if not specified. | [optional] |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | List retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List<BatchOrder> CreateBatchOrders (List order)
Create a batch of orders
Batch orders requirements: 1. custom order field text
is required 2. At most 4 currency pairs, maximum 10 orders each, are allowed in one request 3. No mixture of spot orders and margin orders, i.e. account
must be identical for all orders
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class CreateBatchOrdersExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var order = new List<Order>(); // List<Order> |
try
{
// Create a batch of orders
List<BatchOrder> result = apiInstance.CreateBatchOrders(order);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.CreateBatchOrders: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
order | List<Order> |
- Content-Type: application/json
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Request is completed | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List<OpenOrders> ListAllOpenOrders (int? page = null, int? limit = null, string account = null)
List all open orders
List open orders in all currency pairs. Note that pagination parameters affect record number in each currency pair's open order list. No pagination is applied to the number of currency pairs returned. All currency pairs with open orders will be returned. Spot,portfolio and margin orders are returned by default. To list cross margin orders, account
must be set to cross_margin
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class ListAllOpenOrdersExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var page = 1; // int? | Page number (optional) (default to 1)
var limit = 100; // int? | Maximum number of records returned in one page in each currency pair (optional) (default to 100)
var account = "cross_margin"; // string | Specify operation account. Default to spot ,portfolio and margin account if not specified. Set to `cross_margin` to operate against margin account. Portfolio margin account must set to `cross_margin` only (optional)
try
{
// List all open orders
List<OpenOrders> result = apiInstance.ListAllOpenOrders(page, limit, account);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.ListAllOpenOrders: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
page | int? | Page number | [optional] [default to 1] |
limit | int? | Maximum number of records returned in one page in each currency pair | [optional] [default to 100] |
account | string | Specify operation account. Default to spot ,portfolio and margin account if not specified. Set to `cross_margin` to operate against margin account. Portfolio margin account must set to `cross_margin` only | [optional] |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | List retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
Order CreateCrossLiquidateOrder (LiquidateOrder liquidateOrder)
close position when cross-currency is disabled
Currently, only cross-margin accounts are supported to close position when cross currencies are disabled. Maximum buy quantity = (unpaid principal and interest - currency balance - the amount of the currency in the order book) / 0.998
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class CreateCrossLiquidateOrderExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var liquidateOrder = new LiquidateOrder(); // LiquidateOrder |
try
{
// close position when cross-currency is disabled
Order result = apiInstance.CreateCrossLiquidateOrder(liquidateOrder);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.CreateCrossLiquidateOrder: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
liquidateOrder | LiquidateOrder |
- Content-Type: application/json
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
201 | order created | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List<Order> ListOrders (string currencyPair, string status, int? page = null, int? limit = null, string account = null, long? from = null, long? to = null, string side = null)
List orders
Spot, portfolio and margin orders are returned by default. If cross margin orders are needed, account
must be set to cross_margin
When status
is open
, i.e., listing open orders, only pagination parameters page
and limit
are supported and limit
cannot be larger than 100. Query by side
and time range parameters from
and to
are not supported. When status
is finished
, i.e., listing finished orders, pagination parameters, time range parameters from
and to
, and side
parameters are all supported. Time range parameters are handled as order finish time.
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class ListOrdersExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var currencyPair = "BTC_USDT"; // string | Retrieve results with specified currency pair. It is required for open orders, but optional for finished ones.
var status = "open"; // string | List orders based on status `open` - order is waiting to be filled `finished` - order has been filled or cancelled
var page = 1; // int? | Page number (optional) (default to 1)
var limit = 100; // int? | Maximum number of records to be returned. If `status` is `open`, maximum of `limit` is 100 (optional) (default to 100)
var account = "cross_margin"; // string | Specify operation account. Default to spot ,portfolio and margin account if not specified. Set to `cross_margin` to operate against margin account. Portfolio margin account must set to `cross_margin` only (optional)
var from = 1627706330; // long? | Start timestamp of the query (optional)
var to = 1635329650; // long? | Time range ending, default to current time (optional)
var side = "sell"; // string | All bids or asks. Both included if not specified (optional)
try
{
// List orders
List<Order> result = apiInstance.ListOrders(currencyPair, status, page, limit, account, from, to, side);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.ListOrders: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
currencyPair | string | Retrieve results with specified currency pair. It is required for open orders, but optional for finished ones. | |
status | string | List orders based on status `open` - order is waiting to be filled `finished` - order has been filled or cancelled | |
page | int? | Page number | [optional] [default to 1] |
limit | int? | Maximum number of records to be returned. If `status` is `open`, maximum of `limit` is 100 | [optional] [default to 100] |
account | string | Specify operation account. Default to spot ,portfolio and margin account if not specified. Set to `cross_margin` to operate against margin account. Portfolio margin account must set to `cross_margin` only | [optional] |
from | long? | Start timestamp of the query | [optional] |
to | long? | Time range ending, default to current time | [optional] |
side | string | All bids or asks. Both included if not specified | [optional] |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | List retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
Order CreateOrder (Order order)
Create an order
You can place orders with spot, portfolio, margin or cross margin account through setting the account
field. It defaults to spot
, which means spot account is used to place orders. If the user is using unified account, it defaults to the unified account. When margin account is used, i.e., account
is margin
, auto_borrow
field can be set to true
to enable the server to borrow the amount lacked using POST /margin/loans
when your account's balance is not enough. Whether margin orders' fill will be used to repay margin loans automatically is determined by the auto repayment setting in your margin account, which can be updated or queried using /margin/auto_repay
API. When cross margin account is used, i.e., account
is cross_margin
, auto_borrow
can also be enabled to achieve borrowing the insufficient amount automatically if cross account's balance is not enough. But it differs from margin account that automatic repayment is determined by order's auto_repay
field and only current order's fill will be used to repay cross margin loans. Automatic repayment will be triggered when the order is finished, i.e., its status is either cancelled
or closed
. Order status An order waiting to be filled is open
, and it stays open
until it is filled totally. If fully filled, order is finished and its status turns to closed
.If the order is cancelled before it is totally filled, whether or not partially filled, its status is cancelled
. Iceberg order iceberg
field can be used to set the amount shown. Set to -1
to hide the order completely. Note that the hidden part's fee will be charged using taker's fee rate. Self Trade Prevention - Set stp_act
to decide the strategy of self-trade prevention. For detailed usage, refer to the stp_act
parameter in request body
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class CreateOrderExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var order = new Order(); // Order |
try
{
// Create an order
Order result = apiInstance.CreateOrder(order);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.CreateOrder: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
order | Order |
- Content-Type: application/json
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
201 | Order created. | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List<Order> CancelOrders (string currencyPair, string side = null, string account = null, string actionMode = null)
Cancel all open
orders in specified currency pair
If account
is not set, all open orders, including spot, portfolio, margin and cross margin ones, will be cancelled. You can set account
to cancel only orders within the specified account
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class CancelOrdersExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var currencyPair = "BTC_USDT"; // string | Currency pair
var side = "sell"; // string | All bids or asks. Both included if not specified (optional)
var account = "spot"; // string | Specify account type - classic account:Default to all account types being included - portfolio margin account:`cross_margin` only (optional)
var actionMode = "ACK"; // string | Processing Mode When placing an order, different fields are returned based on the action_mode - ACK: Asynchronous mode, returns only key order fields - RESULT: No clearing information - FULL: Full mode (default) (optional)
try
{
// Cancel all `open` orders in specified currency pair
List<Order> result = apiInstance.CancelOrders(currencyPair, side, account, actionMode);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.CancelOrders: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
currencyPair | string | Currency pair | |
side | string | All bids or asks. Both included if not specified | [optional] |
account | string | Specify account type - classic account:Default to all account types being included - portfolio margin account:`cross_margin` only | [optional] |
actionMode | string | Processing Mode When placing an order, different fields are returned based on the action_mode - ACK: Asynchronous mode, returns only key order fields - RESULT: No clearing information - FULL: Full mode (default) | [optional] |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Batch cancellation request accepted. Query order status by listing orders | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List<CancelOrderResult> CancelBatchOrders (List cancelBatchOrder)
Cancel a batch of orders with an ID list
Multiple currency pairs can be specified, but maximum 20 orders are allowed per request
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class CancelBatchOrdersExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var cancelBatchOrder = new List<CancelBatchOrder>(); // List<CancelBatchOrder> |
try
{
// Cancel a batch of orders with an ID list
List<CancelOrderResult> result = apiInstance.CancelBatchOrders(cancelBatchOrder);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.CancelBatchOrders: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
cancelBatchOrder | List<CancelBatchOrder> |
- Content-Type: application/json
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Batch cancellation completed | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
Order GetOrder (string orderId, string currencyPair, string account = null)
Get a single order
Spot, portfolio and margin orders are queried by default. If cross margin orders are needed or portfolio margin account are used, account must be set to cross_margin.
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class GetOrderExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var orderId = "12345"; // string | Order ID returned, or user custom ID(i.e., `text` field). Operations based on custom ID can only be checked when the order is in orderbook. When the order is finished, it can be checked within 1 hour after the end of the order. After that, only order ID is accepted.
var currencyPair = "BTC_USDT"; // string | Currency pair
var account = "cross_margin"; // string | Specify operation account. Default to spot ,portfolio and margin account if not specified. Set to `cross_margin` to operate against margin account. Portfolio margin account must set to `cross_margin` only (optional)
try
{
// Get a single order
Order result = apiInstance.GetOrder(orderId, currencyPair, account);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.GetOrder: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
orderId | string | Order ID returned, or user custom ID(i.e., `text` field). Operations based on custom ID can only be checked when the order is in orderbook. When the order is finished, it can be checked within 1 hour after the end of the order. After that, only order ID is accepted. | |
currencyPair | string | Currency pair | |
account | string | Specify operation account. Default to spot ,portfolio and margin account if not specified. Set to `cross_margin` to operate against margin account. Portfolio margin account must set to `cross_margin` only | [optional] |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Detail retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
Order CancelOrder (string orderId, string currencyPair, string account = null, string actionMode = null)
Cancel a single order
Spot,portfolio and margin orders are cancelled by default. If trying to cancel cross margin orders or portfolio margin account are used, account must be set to cross_margin
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class CancelOrderExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var orderId = "12345"; // string | Order ID returned, or user custom ID(i.e., `text` field). Operations based on custom ID can only be checked when the order is in orderbook. When the order is finished, it can be checked within 1 hour after the end of the order. After that, only order ID is accepted.
var currencyPair = "BTC_USDT"; // string | Currency pair
var account = "cross_margin"; // string | Specify operation account. Default to spot ,portfolio and margin account if not specified. Set to `cross_margin` to operate against margin account. Portfolio margin account must set to `cross_margin` only (optional)
var actionMode = "ACK"; // string | Processing Mode When placing an order, different fields are returned based on the action_mode - ACK: Asynchronous mode, returns only key order fields - RESULT: No clearing information - FULL: Full mode (default) (optional)
try
{
// Cancel a single order
Order result = apiInstance.CancelOrder(orderId, currencyPair, account, actionMode);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.CancelOrder: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
orderId | string | Order ID returned, or user custom ID(i.e., `text` field). Operations based on custom ID can only be checked when the order is in orderbook. When the order is finished, it can be checked within 1 hour after the end of the order. After that, only order ID is accepted. | |
currencyPair | string | Currency pair | |
account | string | Specify operation account. Default to spot ,portfolio and margin account if not specified. Set to `cross_margin` to operate against margin account. Portfolio margin account must set to `cross_margin` only | [optional] |
actionMode | string | Processing Mode When placing an order, different fields are returned based on the action_mode - ACK: Asynchronous mode, returns only key order fields - RESULT: No clearing information - FULL: Full mode (default) | [optional] |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Order cancelled | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
Order AmendOrder (string orderId, string currencyPair, OrderPatch orderPatch, string account = null)
Amend an order
By default, the orders of spot, portfolio and margin account are updated. If you need to modify orders of the cross-margin
account, you must specify account as cross_margin
. For portfolio margin account, only cross_margin
account is supported. Currently, only supports modification of price
or amount
fields. Regarding rate limiting: modify order and create order sharing rate limiting rules. Regarding matching priority: Only reducing the quantity without modifying the priority of matching, altering the price or increasing the quantity will adjust the priority to the new price at the end Note: If the modified amount is less than the fill amount, the order will be cancelled.
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class AmendOrderExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var orderId = "12345"; // string | Order ID returned, or user custom ID(i.e., `text` field). Operations based on custom ID can only be checked when the order is in orderbook. When the order is finished, it can be checked within 1 hour after the end of the order. After that, only order ID is accepted.
var currencyPair = "BTC_USDT"; // string | Currency pair
var orderPatch = new OrderPatch(); // OrderPatch |
var account = "cross_margin"; // string | Specify operation account. Default to spot ,portfolio and margin account if not specified. Set to `cross_margin` to operate against margin account. Portfolio margin account must set to `cross_margin` only (optional)
try
{
// Amend an order
Order result = apiInstance.AmendOrder(orderId, currencyPair, orderPatch, account);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.AmendOrder: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
orderId | string | Order ID returned, or user custom ID(i.e., `text` field). Operations based on custom ID can only be checked when the order is in orderbook. When the order is finished, it can be checked within 1 hour after the end of the order. After that, only order ID is accepted. | |
currencyPair | string | Currency pair | |
orderPatch | OrderPatch | ||
account | string | Specify operation account. Default to spot ,portfolio and margin account if not specified. Set to `cross_margin` to operate against margin account. Portfolio margin account must set to `cross_margin` only | [optional] |
- Content-Type: application/json
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Updated | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List<Trade> ListMyTrades (string currencyPair = null, int? limit = null, int? page = null, string orderId = null, string account = null, long? from = null, long? to = null)
List personal trading history
Spot,portfolio and margin trades are queried by default. If cross margin trades are needed, account
must be set to cross_margin
You can also set from
and(or) to
to query by time range. If you don't specify from
and/or to
parameters, only the last 7 days of data will be retured. The range of from
and to
is not alloed to exceed 30 days. Time range parameters are handled as order finish time.
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class ListMyTradesExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var currencyPair = "BTC_USDT"; // string | Retrieve results with specified currency pair (optional)
var limit = 100; // int? | Maximum number of records to be returned in a single list (optional) (default to 100)
var page = 1; // int? | Page number (optional) (default to 1)
var orderId = "12345"; // string | Filter trades with specified order ID. `currency_pair` is also required if this field is present (optional)
var account = "cross_margin"; // string | Specify operation account. Default to spot ,portfolio and margin account if not specified. Set to `cross_margin` to operate against margin account. Portfolio margin account must set to `cross_margin` only (optional)
var from = 1627706330; // long? | Start timestamp of the query (optional)
var to = 1635329650; // long? | Time range ending, default to current time (optional)
try
{
// List personal trading history
List<Trade> result = apiInstance.ListMyTrades(currencyPair, limit, page, orderId, account, from, to);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.ListMyTrades: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
currencyPair | string | Retrieve results with specified currency pair | [optional] |
limit | int? | Maximum number of records to be returned in a single list | [optional] [default to 100] |
page | int? | Page number | [optional] [default to 1] |
orderId | string | Filter trades with specified order ID. `currency_pair` is also required if this field is present | [optional] |
account | string | Specify operation account. Default to spot ,portfolio and margin account if not specified. Set to `cross_margin` to operate against margin account. Portfolio margin account must set to `cross_margin` only | [optional] |
from | long? | Start timestamp of the query | [optional] |
to | long? | Time range ending, default to current time | [optional] |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | List retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
SystemTime GetSystemTime ()
Get server current time
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class GetSystemTimeExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
var apiInstance = new SpotApi(config);
try
{
// Get server current time
SystemTime result = apiInstance.GetSystemTime();
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.GetSystemTime: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
This endpoint does not need any parameter.
No authorization required
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successfully retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
TriggerTime CountdownCancelAllSpot (CountdownCancelAllSpotTask countdownCancelAllSpotTask)
Countdown cancel orders
When the timeout set by the user is reached, if there is no cancel or set a new countdown, the related pending orders will be automatically cancelled. This endpoint can be called repeatedly to set a new countdown or cancel the countdown. For example, call this endpoint at 30s intervals, each countdowntimeout
is set to 30s. If this endpoint is not called again within 30 seconds, all pending orders on the specified market
will be automatically cancelled, if no market
is specified, all market pending orders will be cancelled. If the timeout
is set to 0 within 30 seconds, the countdown timer will expire and the cacnel function will be cancelled.
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class CountdownCancelAllSpotExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var countdownCancelAllSpotTask = new CountdownCancelAllSpotTask(); // CountdownCancelAllSpotTask |
try
{
// Countdown cancel orders
TriggerTime result = apiInstance.CountdownCancelAllSpot(countdownCancelAllSpotTask);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.CountdownCancelAllSpot: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
countdownCancelAllSpotTask | CountdownCancelAllSpotTask |
- Content-Type: application/json
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Set countdown successfully | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List<BatchOrder> AmendBatchOrders (List batchAmendItem)
Batch modification of orders
Default modification of orders for spot, portfolio, and margin accounts. To modify orders for a cross margin account, the account
parameter must be specified as cross_margin
. For portfolio margin accounts, the account
parameter can only be specified as cross_margin
. Currently, only modifications to price or quantity (choose one) are supported. When modifying unfinished orders, a maximum of 5 orders can be batch-modified in one request. The request parameters should be passed in an array format. During batch modification, if one order modification fails, the modification process will continue with the next order. After execution, the response will include corresponding failure information for the failed orders. The sequence of calling for batch order modification should be consistent with the order in the order list. The response content order for batch order modification will also be consistent with the order in the order list.
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class AmendBatchOrdersExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var batchAmendItem = new List<BatchAmendItem>(); // List<BatchAmendItem> |
try
{
// Batch modification of orders
List<BatchOrder> result = apiInstance.AmendBatchOrders(batchAmendItem);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.AmendBatchOrders: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
batchAmendItem | List<BatchAmendItem> |
- Content-Type: application/json
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Order modification executed successfully | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List<SpotPriceTriggeredOrder> ListSpotPriceTriggeredOrders (string status, string market = null, string account = null, int? limit = null, int? offset = null)
Retrieve running auto order list
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class ListSpotPriceTriggeredOrdersExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var status = "status_example"; // string | Only list the orders with this status
var market = "BTC_USDT"; // string | Currency pair (optional)
var account = "account_example"; // string | Trading account type. Portfolio margin account must set to `cross_margin` (optional)
var limit = 100; // int? | Maximum number of records to be returned in a single list (optional) (default to 100)
var offset = 0; // int? | List offset, starting from 0 (optional) (default to 0)
try
{
// Retrieve running auto order list
List<SpotPriceTriggeredOrder> result = apiInstance.ListSpotPriceTriggeredOrders(status, market, account, limit, offset);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.ListSpotPriceTriggeredOrders: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
status | string | Only list the orders with this status | |
market | string | Currency pair | [optional] |
account | string | Trading account type. Portfolio margin account must set to `cross_margin` | [optional] |
limit | int? | Maximum number of records to be returned in a single list | [optional] [default to 100] |
offset | int? | List offset, starting from 0 | [optional] [default to 0] |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | List retrieved | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
TriggerOrderResponse CreateSpotPriceTriggeredOrder (SpotPriceTriggeredOrder spotPriceTriggeredOrder)
Create a price-triggered order
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class CreateSpotPriceTriggeredOrderExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var spotPriceTriggeredOrder = new SpotPriceTriggeredOrder(); // SpotPriceTriggeredOrder |
try
{
// Create a price-triggered order
TriggerOrderResponse result = apiInstance.CreateSpotPriceTriggeredOrder(spotPriceTriggeredOrder);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.CreateSpotPriceTriggeredOrder: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
spotPriceTriggeredOrder | SpotPriceTriggeredOrder |
- Content-Type: application/json
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
201 | Order created | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List<SpotPriceTriggeredOrder> CancelSpotPriceTriggeredOrderList (string market = null, string account = null)
Cancel all open orders
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class CancelSpotPriceTriggeredOrderListExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var market = "BTC_USDT"; // string | Currency pair (optional)
var account = "account_example"; // string | Trading account type. Portfolio margin account must set to `cross_margin` (optional)
try
{
// Cancel all open orders
List<SpotPriceTriggeredOrder> result = apiInstance.CancelSpotPriceTriggeredOrderList(market, account);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.CancelSpotPriceTriggeredOrderList: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
market | string | Currency pair | [optional] |
account | string | Trading account type. Portfolio margin account must set to `cross_margin` | [optional] |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Batch cancellation request accepted. Query order status by listing orders | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
SpotPriceTriggeredOrder GetSpotPriceTriggeredOrder (string orderId)
Get a price-triggered order
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class GetSpotPriceTriggeredOrderExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var orderId = "orderId_example"; // string | Retrieve the data of the order with the specified ID
try
{
// Get a price-triggered order
SpotPriceTriggeredOrder result = apiInstance.GetSpotPriceTriggeredOrder(orderId);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.GetSpotPriceTriggeredOrder: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
orderId | string | Retrieve the data of the order with the specified ID |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Auto order detail | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
SpotPriceTriggeredOrder CancelSpotPriceTriggeredOrder (string orderId)
cancel a price-triggered order
using System.Collections.Generic;
using System.Diagnostics;
using Io.Gate.GateApi.Api;
using Io.Gate.GateApi.Client;
using Io.Gate.GateApi.Model;
namespace Example
{
public class CancelSpotPriceTriggeredOrderExample
{
public static void Main()
{
Configuration config = new Configuration();
config.BasePath = "https://api.gateio.ws/api/v4";
config.SetGateApiV4KeyPair("YOUR_API_KEY", "YOUR_API_SECRET");
var apiInstance = new SpotApi(config);
var orderId = "orderId_example"; // string | Retrieve the data of the order with the specified ID
try
{
// cancel a price-triggered order
SpotPriceTriggeredOrder result = apiInstance.CancelSpotPriceTriggeredOrder(orderId);
Debug.WriteLine(result);
}
catch (GateApiException e)
{
Debug.Print("Exception when calling SpotApi.CancelSpotPriceTriggeredOrder: " + e.Message);
Debug.Print("Exception label: {0}, message: {1}", e.ErrorLabel, e.ErrorMessage);
Debug.Print("Status Code: "+ e.ErrorCode);
Debug.Print(e.StackTrace);
}
}
}
}
Name | Type | Description | Notes |
---|---|---|---|
orderId | string | Retrieve the data of the order with the specified ID |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Auto order detail | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]