OptionsApi.md

gate_api.OptionsApi

All URIs are relative to https://api.gateio.ws/api/v4

Method	HTTP request	Description
list_options_underlyings	GET /options/underlyings	List all underlying assets
list_options_expirations	GET /options/expirations	List all expiration dates
list_options_contracts	GET /options/contracts	List all contracts for specified underlying and expiration date
get_options_contract	GET /options/contracts/{contract}	Query specified contract details
list_options_settlements	GET /options/settlements	List settlement history
get_options_settlement	GET /options/settlements/{contract}	Get specified contract settlement information
list_my_options_settlements	GET /options/my_settlements	Query personal settlement records
list_options_order_book	GET /options/order_book	Query options contract order book
list_options_tickers	GET /options/tickers	Query options market ticker information
list_options_underlying_tickers	GET /options/underlying/tickers/{underlying}	Query underlying ticker information
list_options_candlesticks	GET /options/candlesticks	Options contract market candlestick chart
list_options_underlying_candlesticks	GET /options/underlying/candlesticks	Underlying index price candlestick chart
list_options_trades	GET /options/trades	Market trade records
list_options_account	GET /options/accounts	Query account information
list_options_account_book	GET /options/account_book	Query account change history
list_options_positions	GET /options/positions	List user's positions of specified underlying
get_options_position	GET /options/positions/{contract}	Get specified contract position
list_options_position_close	GET /options/position_close	List user's liquidation history of specified underlying
list_options_orders	GET /options/orders	List options orders
create_options_order	POST /options/orders	Create an options order
cancel_options_orders	DELETE /options/orders	Cancel all orders with 'open' status
get_options_order	GET /options/orders/{order_id}	Query single order details
amend_options_order	PUT /options/orders/{order_id}	Option Order Modification
cancel_options_order	DELETE /options/orders/{order_id}	Cancel single order
countdown_cancel_all_options	POST /options/countdown_cancel_all	Countdown cancel orders
list_my_options_trades	GET /options/my_trades	Query personal trading records
get_options_mmp	GET /options/mmp	MMP Query.
set_options_mmp	POST /options/mmp	MMP Settings
reset_options_mmp	POST /options/mmp/reset	MMP Reset

list_options_underlyings

list[OptionsUnderlying] list_options_underlyings()

List all underlying assets

Example

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.configuration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
try:
# List all underlying assetsapi_response=api_instance.list_options_underlyings()
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->list_options_underlyings: %s\n"%e)

Parameters

This endpoint does not need any parameter.

Return type

list[OptionsUnderlying]

Authorization

No authorization required

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	List retrieved successfully	-

[Back to top][Back to API list][Back to Model list][Back to README]

list_options_expirations

list[int] list_options_expirations(underlying)

List all expiration dates

Example

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.configuration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
underlying='BTC_USDT'# str | Underlying (Obtained by listing underlying endpoint)try:
# List all expiration datesapi_response=api_instance.list_options_expirations(underlying)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->list_options_expirations: %s\n"%e)

Parameters

Name	Type	Description	Notes
underlying	str	Underlying (Obtained by listing underlying endpoint)

Return type

list[int]

Authorization

No authorization required

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	List expiration dates for specified underlying	-

[Back to top][Back to API list][Back to Model list][Back to README]

list_options_contracts

list[OptionsContract] list_options_contracts(underlying, expiration=expiration)

List all contracts for specified underlying and expiration date

Example

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.configuration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
underlying='BTC_USDT'# str | Underlying (Obtained by listing underlying endpoint)expiration=1636588800# int | Unix timestamp of expiration date (optional)try:
# List all contracts for specified underlying and expiration dateapi_response=api_instance.list_options_contracts(underlying, expiration=expiration)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->list_options_contracts: %s\n"%e)

Parameters

Name	Type	Description	Notes
underlying	str	Underlying (Obtained by listing underlying endpoint)
expiration	int	Unix timestamp of expiration date	[optional]

Return type

list[OptionsContract]

Authorization

No authorization required

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	List retrieved successfully	-

[Back to top][Back to API list][Back to Model list][Back to README]

get_options_contract

OptionsContract get_options_contract(contract)

Query specified contract details

Example

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.configuration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
contract='BTC_USDT-20211130-65000-C'# str | try:
# Query specified contract detailsapi_response=api_instance.get_options_contract(contract)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->get_options_contract: %s\n"%e)

Parameters

Name	Type	Description	Notes
contract	str

Return type

OptionsContract

Authorization

No authorization required

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Query successful	-

[Back to top][Back to API list][Back to Model list][Back to README]

list_options_settlements

list[OptionsSettlement] list_options_settlements(underlying, limit=limit, offset=offset, _from=_from, to=to)

List settlement history

Example

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.configuration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
underlying='BTC_USDT'# str | Underlying (Obtained by listing underlying endpoint)limit=100# int | Maximum number of records returned in a single list (optional) (default to 100)offset=0# int | List offset, starting from 0 (optional) (default to 0)_from=1547706332# int | Start timestamp Specify start time, time format is Unix timestamp. If not specified, it defaults to (the data start time of the time range actually returned by to and limit) (optional)to=1547706332# int | Termination Timestamp Specify the end time. If not specified, it defaults to the current time, and the time format is a Unix timestamp (optional)try:
# List settlement historyapi_response=api_instance.list_options_settlements(underlying, limit=limit, offset=offset, _from=_from, to=to)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->list_options_settlements: %s\n"%e)

Parameters

Name	Type	Description	Notes
underlying	str	Underlying (Obtained by listing underlying endpoint)
limit	int	Maximum number of records returned in a single list	[optional] [default to 100]
offset	int	List offset, starting from 0	[optional] [default to 0]
_from	int	Start timestamp Specify start time, time format is Unix timestamp. If not specified, it defaults to (the data start time of the time range actually returned by to and limit)	[optional]
to	int	Termination Timestamp Specify the end time. If not specified, it defaults to the current time, and the time format is a Unix timestamp	[optional]

Return type

list[OptionsSettlement]

Authorization

No authorization required

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	List retrieved successfully	-

[Back to top][Back to API list][Back to Model list][Back to README]

get_options_settlement

OptionsSettlement get_options_settlement(contract, underlying, at)

Get specified contract settlement information

Example

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.configuration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
contract='BTC_USDT-20211130-65000-C'# str | underlying='BTC_USDT'# str | Underlying (Obtained by listing underlying endpoint)at=56# int | try:
# Get specified contract settlement informationapi_response=api_instance.get_options_settlement(contract, underlying, at)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->get_options_settlement: %s\n"%e)

Parameters

Name	Type	Description	Notes
contract	str
underlying	str	Underlying (Obtained by listing underlying endpoint)
at	int

Return type

OptionsSettlement

Authorization

No authorization required

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Query successful	-

[Back to top][Back to API list][Back to Model list][Back to README]

list_my_options_settlements

list[OptionsMySettlements] list_my_options_settlements(underlying, contract=contract, limit=limit, offset=offset, _from=_from, to=to)

Query personal settlement records

Example

• Api Key Authentication (apiv4):

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.# The client must configure the authentication and authorization parameters# in accordance with the API server security policy.# Examples for each auth method are provided below, use the example that# satisfies your auth use case.# Configure APIv4 key authorizationconfiguration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4",
key="YOU_API_KEY",
secret="YOUR_API_SECRET"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
underlying='BTC_USDT'# str | Underlying (Obtained by listing underlying endpoint)contract='BTC_USDT-20210916-5000-C'# str | Options contract name (optional)limit=100# int | Maximum number of records returned in a single list (optional) (default to 100)offset=0# int | List offset, starting from 0 (optional) (default to 0)_from=1547706332# int | Start timestamp Specify start time, time format is Unix timestamp. If not specified, it defaults to (the data start time of the time range actually returned by to and limit) (optional)to=1547706332# int | Termination Timestamp Specify the end time. If not specified, it defaults to the current time, and the time format is a Unix timestamp (optional)try:
# Query personal settlement recordsapi_response=api_instance.list_my_options_settlements(underlying, contract=contract, limit=limit, offset=offset, _from=_from, to=to)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->list_my_options_settlements: %s\n"%e)

Parameters

Name	Type	Description	Notes
underlying	str	Underlying (Obtained by listing underlying endpoint)
contract	str	Options contract name	[optional]
limit	int	Maximum number of records returned in a single list	[optional] [default to 100]
offset	int	List offset, starting from 0	[optional] [default to 0]
_from	int	Start timestamp Specify start time, time format is Unix timestamp. If not specified, it defaults to (the data start time of the time range actually returned by to and limit)	[optional]
to	int	Termination Timestamp Specify the end time. If not specified, it defaults to the current time, and the time format is a Unix timestamp	[optional]

Return type

list[OptionsMySettlements]

Authorization

apiv4

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	List retrieved successfully	-

[Back to top][Back to API list][Back to Model list][Back to README]

list_options_order_book

OptionsOrderBook list_options_order_book(contract, interval=interval, limit=limit, with_id=with_id)

Query options contract order book

Bids will be sorted by price from high to low, while asks sorted reversely

Example

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.configuration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
contract='BTC_USDT-20210916-5000-C'# str | Options contract nameinterval='0'# str | Price precision for merged depth. 0 means no merging. If not specified, defaults to 0 (optional) (default to '0')limit=10# int | Number of depth levels (optional) (default to 10)with_id=False# bool | Whether to return depth update ID. This ID increments by 1 each time the depth changes (optional) (default to False)try:
# Query options contract order bookapi_response=api_instance.list_options_order_book(contract, interval=interval, limit=limit, with_id=with_id)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->list_options_order_book: %s\n"%e)

Parameters

Name	Type	Description	Notes
contract	str	Options contract name
interval	str	Price precision for merged depth. 0 means no merging. If not specified, defaults to 0	[optional] [default to '0']
limit	int	Number of depth levels	[optional] [default to 10]
with_id	bool	Whether to return depth update ID. This ID increments by 1 each time the depth changes	[optional] [default to False]

Return type

OptionsOrderBook

Authorization

No authorization required

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Depth query successful	-

[Back to top][Back to API list][Back to Model list][Back to README]

list_options_tickers

list[OptionsTicker] list_options_tickers(underlying)

Query options market ticker information

Example

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.configuration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
underlying='BTC_USDT'# str | Underlying (Obtained by listing underlying endpoint)try:
# Query options market ticker informationapi_response=api_instance.list_options_tickers(underlying)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->list_options_tickers: %s\n"%e)

Parameters

Name	Type	Description	Notes
underlying	str	Underlying (Obtained by listing underlying endpoint)

Return type

list[OptionsTicker]

Authorization

No authorization required

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Query successful	-

[Back to top][Back to API list][Back to Model list][Back to README]

list_options_underlying_tickers

OptionsUnderlyingTicker list_options_underlying_tickers(underlying)

Query underlying ticker information

Example

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.configuration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
underlying='BTC_USDT'# str | Underlyingtry:
# Query underlying ticker informationapi_response=api_instance.list_options_underlying_tickers(underlying)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->list_options_underlying_tickers: %s\n"%e)

Parameters

Name	Type	Description	Notes
underlying	str	Underlying

Return type

OptionsUnderlyingTicker

Authorization

No authorization required

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Query successful	-

[Back to top][Back to API list][Back to Model list][Back to README]

list_options_candlesticks

list[OptionsCandlestick] list_options_candlesticks(contract, limit=limit, _from=_from, to=to, interval=interval)

Options contract market candlestick chart

Example

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.configuration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
contract='BTC_USDT-20210916-5000-C'# str | Options contract namelimit=100# int | Maximum number of records returned in a single list (optional) (default to 100)_from=1547706332# int | Start timestamp Specify start time, time format is Unix timestamp. If not specified, it defaults to (the data start time of the time range actually returned by to and limit) (optional)to=1547706332# int | Termination Timestamp Specify the end time. If not specified, it defaults to the current time, and the time format is a Unix timestamp (optional)interval='5m'# str | Time interval between data points (optional) (default to '5m')try:
# Options contract market candlestick chartapi_response=api_instance.list_options_candlesticks(contract, limit=limit, _from=_from, to=to, interval=interval)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->list_options_candlesticks: %s\n"%e)

Parameters

Name	Type	Description	Notes
contract	str	Options contract name
limit	int	Maximum number of records returned in a single list	[optional] [default to 100]
_from	int	Start timestamp Specify start time, time format is Unix timestamp. If not specified, it defaults to (the data start time of the time range actually returned by to and limit)	[optional]
to	int	Termination Timestamp Specify the end time. If not specified, it defaults to the current time, and the time format is a Unix timestamp	[optional]
interval	str	Time interval between data points	[optional] [default to '5m']

Return type

list[OptionsCandlestick]

Authorization

No authorization required

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Query successful	-

[Back to top][Back to API list][Back to Model list][Back to README]

list_options_underlying_candlesticks

list[OptionsCandlestick] list_options_underlying_candlesticks(underlying, limit=limit, _from=_from, to=to, interval=interval)

Underlying index price candlestick chart

Example

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.configuration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
underlying='BTC_USDT'# str | Underlying (Obtained by listing underlying endpoint)limit=100# int | Maximum number of records returned in a single list (optional) (default to 100)_from=1547706332# int | Start timestamp Specify start time, time format is Unix timestamp. If not specified, it defaults to (the data start time of the time range actually returned by to and limit) (optional)to=1547706332# int | Termination Timestamp Specify the end time. If not specified, it defaults to the current time, and the time format is a Unix timestamp (optional)interval='5m'# str | Time interval between data points (optional) (default to '5m')try:
# Underlying index price candlestick chartapi_response=api_instance.list_options_underlying_candlesticks(underlying, limit=limit, _from=_from, to=to, interval=interval)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->list_options_underlying_candlesticks: %s\n"%e)

Parameters

Name	Type	Description	Notes
underlying	str	Underlying (Obtained by listing underlying endpoint)
limit	int	Maximum number of records returned in a single list	[optional] [default to 100]
_from	int	Start timestamp Specify start time, time format is Unix timestamp. If not specified, it defaults to (the data start time of the time range actually returned by to and limit)	[optional]
to	int	Termination Timestamp Specify the end time. If not specified, it defaults to the current time, and the time format is a Unix timestamp	[optional]
interval	str	Time interval between data points	[optional] [default to '5m']

Return type

list[OptionsCandlestick]

Authorization

No authorization required

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Query successful	-

[Back to top][Back to API list][Back to Model list][Back to README]

list_options_trades

list[OptionsTrade] list_options_trades(contract=contract, type=type, limit=limit, offset=offset, _from=_from, to=to)

Market trade records

Example

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.configuration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
contract='BTC_USDT-20210916-5000-C'# str | Options contract name (optional)type='1546935600'# str | `C` for call, `P` for put (optional)limit=100# int | Maximum number of records returned in a single list (optional) (default to 100)offset=0# int | List offset, starting from 0 (optional) (default to 0)_from=1547706332# int | Start timestamp Specify start time, time format is Unix timestamp. If not specified, it defaults to (the data start time of the time range actually returned by to and limit) (optional)to=1547706332# int | Termination Timestamp Specify the end time. If not specified, it defaults to the current time, and the time format is a Unix timestamp (optional)try:
# Market trade recordsapi_response=api_instance.list_options_trades(contract=contract, type=type, limit=limit, offset=offset, _from=_from, to=to)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->list_options_trades: %s\n"%e)

Parameters

Name	Type	Description	Notes
contract	str	Options contract name	[optional]
type	str	`C` for call, `P` for put	[optional]
limit	int	Maximum number of records returned in a single list	[optional] [default to 100]
offset	int	List offset, starting from 0	[optional] [default to 0]
_from	int	Start timestamp Specify start time, time format is Unix timestamp. If not specified, it defaults to (the data start time of the time range actually returned by to and limit)	[optional]
to	int	Termination Timestamp Specify the end time. If not specified, it defaults to the current time, and the time format is a Unix timestamp	[optional]

Return type

list[OptionsTrade]

Authorization

No authorization required

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	List retrieved successfully	-

[Back to top][Back to API list][Back to Model list][Back to README]

list_options_account

OptionsAccount list_options_account()

Query account information

Query account information for classic option account and unified account

Example

• Api Key Authentication (apiv4):

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.# The client must configure the authentication and authorization parameters# in accordance with the API server security policy.# Examples for each auth method are provided below, use the example that# satisfies your auth use case.# Configure APIv4 key authorizationconfiguration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4",
key="YOU_API_KEY",
secret="YOUR_API_SECRET"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
try:
# Query account informationapi_response=api_instance.list_options_account()
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->list_options_account: %s\n"%e)

Parameters

This endpoint does not need any parameter.

Return type

OptionsAccount

Authorization

apiv4

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Query successful	-

[Back to top][Back to API list][Back to Model list][Back to README]

list_options_account_book

list[OptionsAccountBook] list_options_account_book(limit=limit, offset=offset, _from=_from, to=to, type=type)

Query account change history

Example

• Api Key Authentication (apiv4):

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.# The client must configure the authentication and authorization parameters# in accordance with the API server security policy.# Examples for each auth method are provided below, use the example that# satisfies your auth use case.# Configure APIv4 key authorizationconfiguration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4",
key="YOU_API_KEY",
secret="YOUR_API_SECRET"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
limit=100# int | Maximum number of records returned in a single list (optional) (default to 100)offset=0# int | List offset, starting from 0 (optional) (default to 0)_from=1547706332# int | Start timestamp Specify start time, time format is Unix timestamp. If not specified, it defaults to (the data start time of the time range actually returned by to and limit) (optional)to=1547706332# int | Termination Timestamp Specify the end time. If not specified, it defaults to the current time, and the time format is a Unix timestamp (optional)type='dnw'# str | Change types: - dnw: Deposit & Withdrawal - prem: Trading premium - fee: Trading fee - refr: Referrer rebate - set: Settlement P&L (optional)try:
# Query account change historyapi_response=api_instance.list_options_account_book(limit=limit, offset=offset, _from=_from, to=to, type=type)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->list_options_account_book: %s\n"%e)

Parameters

Name	Type	Description	Notes
limit	int	Maximum number of records returned in a single list	[optional] [default to 100]
offset	int	List offset, starting from 0	[optional] [default to 0]
_from	int	Start timestamp Specify start time, time format is Unix timestamp. If not specified, it defaults to (the data start time of the time range actually returned by to and limit)	[optional]
to	int	Termination Timestamp Specify the end time. If not specified, it defaults to the current time, and the time format is a Unix timestamp	[optional]
type	str	Change types: - dnw: Deposit & Withdrawal - prem: Trading premium - fee: Trading fee - refr: Referrer rebate - set: Settlement P&L	[optional]

Return type

list[OptionsAccountBook]

Authorization

apiv4

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	List retrieved successfully	-

[Back to top][Back to API list][Back to Model list][Back to README]

list_options_positions

list[OptionsPosition] list_options_positions(underlying=underlying)

List user's positions of specified underlying

Example

• Api Key Authentication (apiv4):

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.# The client must configure the authentication and authorization parameters# in accordance with the API server security policy.# Examples for each auth method are provided below, use the example that# satisfies your auth use case.# Configure APIv4 key authorizationconfiguration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4",
key="YOU_API_KEY",
secret="YOUR_API_SECRET"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
underlying='BTC_USDT'# str | Underlying (optional)try:
# List user's positions of specified underlyingapi_response=api_instance.list_options_positions(underlying=underlying)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->list_options_positions: %s\n"%e)

Parameters

Name	Type	Description	Notes
underlying	str	Underlying	[optional]

Return type

list[OptionsPosition]

Authorization

apiv4

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	List retrieved successfully	-

[Back to top][Back to API list][Back to Model list][Back to README]

get_options_position

OptionsPosition get_options_position(contract)

Get specified contract position

Example

• Api Key Authentication (apiv4):

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.# The client must configure the authentication and authorization parameters# in accordance with the API server security policy.# Examples for each auth method are provided below, use the example that# satisfies your auth use case.# Configure APIv4 key authorizationconfiguration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4",
key="YOU_API_KEY",
secret="YOUR_API_SECRET"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
contract='BTC_USDT-20211130-65000-C'# str | try:
# Get specified contract positionapi_response=api_instance.get_options_position(contract)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->get_options_position: %s\n"%e)

Parameters

Name	Type	Description	Notes
contract	str

Return type

OptionsPosition

Authorization

apiv4

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Query successful	-

[Back to top][Back to API list][Back to Model list][Back to README]

list_options_position_close

list[OptionsPositionClose] list_options_position_close(underlying, contract=contract)

List user's liquidation history of specified underlying

Example

• Api Key Authentication (apiv4):

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.# The client must configure the authentication and authorization parameters# in accordance with the API server security policy.# Examples for each auth method are provided below, use the example that# satisfies your auth use case.# Configure APIv4 key authorizationconfiguration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4",
key="YOU_API_KEY",
secret="YOUR_API_SECRET"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
underlying='BTC_USDT'# str | Underlying (Obtained by listing underlying endpoint)contract='BTC_USDT-20210916-5000-C'# str | Options contract name (optional)try:
# List user's liquidation history of specified underlyingapi_response=api_instance.list_options_position_close(underlying, contract=contract)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->list_options_position_close: %s\n"%e)

Parameters

Name	Type	Description	Notes
underlying	str	Underlying (Obtained by listing underlying endpoint)
contract	str	Options contract name	[optional]

Return type

list[OptionsPositionClose]

Authorization

apiv4

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	List retrieved successfully	-

[Back to top][Back to API list][Back to Model list][Back to README]

list_options_orders

list[OptionsOrder] list_options_orders(status, contract=contract, underlying=underlying, limit=limit, offset=offset, _from=_from, to=to)

List options orders

Example

• Api Key Authentication (apiv4):

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.# The client must configure the authentication and authorization parameters# in accordance with the API server security policy.# Examples for each auth method are provided below, use the example that# satisfies your auth use case.# Configure APIv4 key authorizationconfiguration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4",
key="YOU_API_KEY",
secret="YOUR_API_SECRET"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
status='open'# str | Query order list based on statuscontract='BTC_USDT-20210916-5000-C'# str | Options contract name (optional)underlying='BTC_USDT'# str | Underlying (optional)limit=100# int | Maximum number of records returned in a single list (optional) (default to 100)offset=0# int | List offset, starting from 0 (optional) (default to 0)_from=1547706332# int | Start timestamp Specify start time, time format is Unix timestamp. If not specified, it defaults to (the data start time of the time range actually returned by to and limit) (optional)to=1547706332# int | Termination Timestamp Specify the end time. If not specified, it defaults to the current time, and the time format is a Unix timestamp (optional)try:
# List options ordersapi_response=api_instance.list_options_orders(status, contract=contract, underlying=underlying, limit=limit, offset=offset, _from=_from, to=to)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->list_options_orders: %s\n"%e)

Parameters

Name	Type	Description	Notes
status	str	Query order list based on status
contract	str	Options contract name	[optional]
underlying	str	Underlying	[optional]
limit	int	Maximum number of records returned in a single list	[optional] [default to 100]
offset	int	List offset, starting from 0	[optional] [default to 0]
_from	int	Start timestamp Specify start time, time format is Unix timestamp. If not specified, it defaults to (the data start time of the time range actually returned by to and limit)	[optional]
to	int	Termination Timestamp Specify the end time. If not specified, it defaults to the current time, and the time format is a Unix timestamp	[optional]

Return type

list[OptionsOrder]

Authorization

apiv4

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	List retrieved successfully	-

[Back to top][Back to API list][Back to Model list][Back to README]

create_options_order

OptionsOrder create_options_order(options_order)

Create an options order

Example

• Api Key Authentication (apiv4):

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.# The client must configure the authentication and authorization parameters# in accordance with the API server security policy.# Examples for each auth method are provided below, use the example that# satisfies your auth use case.# Configure APIv4 key authorizationconfiguration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4",
key="YOU_API_KEY",
secret="YOUR_API_SECRET"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
options_order=gate_api.OptionsOrder() # OptionsOrder | try:
# Create an options orderapi_response=api_instance.create_options_order(options_order)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->create_options_order: %s\n"%e)

Parameters

Name	Type	Description	Notes
options_order	OptionsOrder

Return type

OptionsOrder

Authorization

apiv4

HTTP request headers

• Content-Type: application/json
• Accept: application/json

HTTP response details

Status code	Description	Response headers
201	Order detail	-

[Back to top][Back to API list][Back to Model list][Back to README]

cancel_options_orders

list[OptionsOrder] cancel_options_orders(contract=contract, underlying=underlying, side=side)

Cancel all orders with 'open' status

Example

• Api Key Authentication (apiv4):

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.# The client must configure the authentication and authorization parameters# in accordance with the API server security policy.# Examples for each auth method are provided below, use the example that# satisfies your auth use case.# Configure APIv4 key authorizationconfiguration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4",
key="YOU_API_KEY",
secret="YOUR_API_SECRET"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
contract='BTC_USDT-20210916-5000-C'# str | Options contract name (optional)underlying='BTC_USDT'# str | Underlying (optional)side='ask'# str | Specify all bids or all asks, both included if not specified (optional)try:
# Cancel all orders with 'open' statusapi_response=api_instance.cancel_options_orders(contract=contract, underlying=underlying, side=side)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->cancel_options_orders: %s\n"%e)

Parameters

Name	Type	Description	Notes
contract	str	Options contract name	[optional]
underlying	str	Underlying	[optional]
side	str	Specify all bids or all asks, both included if not specified	[optional]

Return type

list[OptionsOrder]

Authorization

apiv4

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Batch cancellation successful	-

[Back to top][Back to API list][Back to Model list][Back to README]

get_options_order

OptionsOrder get_options_order(order_id)

Query single order details

Example

• Api Key Authentication (apiv4):

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.# The client must configure the authentication and authorization parameters# in accordance with the API server security policy.# Examples for each auth method are provided below, use the example that# satisfies your auth use case.# Configure APIv4 key authorizationconfiguration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4",
key="YOU_API_KEY",
secret="YOUR_API_SECRET"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
order_id=12345# int | Order ID returned when order is successfully createdtry:
# Query single order detailsapi_response=api_instance.get_options_order(order_id)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->get_options_order: %s\n"%e)

Parameters

Name	Type	Description	Notes
order_id	int	Order ID returned when order is successfully created

Return type

OptionsOrder

Authorization

apiv4

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Order detail	-

[Back to top][Back to API list][Back to Model list][Back to README]

amend_options_order

OptionsOrder amend_options_order(order_id, amend_options_order_request)

Option Order Modification

Modify the order price and/or quantity of a specified order; only orders with status 'open' are supported

Example

• Api Key Authentication (apiv4):

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.# The client must configure the authentication and authorization parameters# in accordance with the API server security policy.# Examples for each auth method are provided below, use the example that# satisfies your auth use case.# Configure APIv4 key authorizationconfiguration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4",
key="YOU_API_KEY",
secret="YOUR_API_SECRET"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
order_id=12345# int | Order ID returned when order is successfully createdamend_options_order_request=gate_api.AmendOptionsOrderRequest() # AmendOptionsOrderRequest | try:
# Option Order Modificationapi_response=api_instance.amend_options_order(order_id, amend_options_order_request)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->amend_options_order: %s\n"%e)

Parameters

Name	Type	Description	Notes
order_id	int	Order ID returned when order is successfully created
amend_options_order_request	AmendOptionsOrderRequest

Return type

OptionsOrder

Authorization

apiv4

HTTP request headers

• Content-Type: application/json
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Order detail	-

[Back to top][Back to API list][Back to Model list][Back to README]

cancel_options_order

OptionsOrder cancel_options_order(order_id)

Cancel single order

Example

• Api Key Authentication (apiv4):

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.# The client must configure the authentication and authorization parameters# in accordance with the API server security policy.# Examples for each auth method are provided below, use the example that# satisfies your auth use case.# Configure APIv4 key authorizationconfiguration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4",
key="YOU_API_KEY",
secret="YOUR_API_SECRET"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
order_id=12345# int | Order ID returned when order is successfully createdtry:
# Cancel single orderapi_response=api_instance.cancel_options_order(order_id)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->cancel_options_order: %s\n"%e)

Parameters

Name	Type	Description	Notes
order_id	int	Order ID returned when order is successfully created

Return type

OptionsOrder

Authorization

apiv4

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Order detail	-

[Back to top][Back to API list][Back to Model list][Back to README]

countdown_cancel_all_options

TriggerTime countdown_cancel_all_options(countdown_cancel_all_options_task)

Countdown cancel orders

Option order heartbeat detection, when the timeout time set by the user is reached, if the existing countdown is not canceled or a new countdown is set, the related option pending order will be automatically canceled. This interface can be called repeatedly to set a new countdown or cancel the countdown. Usage example: Repeat this interface at intervals of 30 seconds, with each countdown timeout set to 30 (seconds). If this interface is not called again within 30 seconds, all pending orders on the underlyingcontract you specified will be automatically cancelled. If underlyingcontract is not specified, user will be automatically cancelled If timeout is set to 0 within 30 seconds, the countdown timer will expire and the automatic order cancellation function will be cancelled.

Example

• Api Key Authentication (apiv4):

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.# The client must configure the authentication and authorization parameters# in accordance with the API server security policy.# Examples for each auth method are provided below, use the example that# satisfies your auth use case.# Configure APIv4 key authorizationconfiguration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4",
key="YOU_API_KEY",
secret="YOUR_API_SECRET"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
countdown_cancel_all_options_task=gate_api.CountdownCancelAllOptionsTask() # CountdownCancelAllOptionsTask | try:
# Countdown cancel ordersapi_response=api_instance.countdown_cancel_all_options(countdown_cancel_all_options_task)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->countdown_cancel_all_options: %s\n"%e)

Parameters

Name	Type	Description	Notes
countdown_cancel_all_options_task	CountdownCancelAllOptionsTask

Return type

TriggerTime

Authorization

apiv4

HTTP request headers

• Content-Type: application/json
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Countdown set successfully	-

[Back to top][Back to API list][Back to Model list][Back to README]

list_my_options_trades

list[OptionsMyTrade] list_my_options_trades(underlying, contract=contract, limit=limit, offset=offset, _from=_from, to=to)

Query personal trading records

Example

• Api Key Authentication (apiv4):

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.# The client must configure the authentication and authorization parameters# in accordance with the API server security policy.# Examples for each auth method are provided below, use the example that# satisfies your auth use case.# Configure APIv4 key authorizationconfiguration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4",
key="YOU_API_KEY",
secret="YOUR_API_SECRET"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
underlying='BTC_USDT'# str | Underlying (Obtained by listing underlying endpoint)contract='BTC_USDT-20210916-5000-C'# str | Options contract name (optional)limit=100# int | Maximum number of records returned in a single list (optional) (default to 100)offset=0# int | List offset, starting from 0 (optional) (default to 0)_from=1547706332# int | Start timestamp Specify start time, time format is Unix timestamp. If not specified, it defaults to (the data start time of the time range actually returned by to and limit) (optional)to=1547706332# int | Termination Timestamp Specify the end time. If not specified, it defaults to the current time, and the time format is a Unix timestamp (optional)try:
# Query personal trading recordsapi_response=api_instance.list_my_options_trades(underlying, contract=contract, limit=limit, offset=offset, _from=_from, to=to)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->list_my_options_trades: %s\n"%e)

Parameters

Name	Type	Description	Notes
underlying	str	Underlying (Obtained by listing underlying endpoint)
contract	str	Options contract name	[optional]
limit	int	Maximum number of records returned in a single list	[optional] [default to 100]
offset	int	List offset, starting from 0	[optional] [default to 0]
_from	int	Start timestamp Specify start time, time format is Unix timestamp. If not specified, it defaults to (the data start time of the time range actually returned by to and limit)	[optional]
to	int	Termination Timestamp Specify the end time. If not specified, it defaults to the current time, and the time format is a Unix timestamp	[optional]

Return type

list[OptionsMyTrade]

Authorization

apiv4

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	List retrieved successfully	-

[Back to top][Back to API list][Back to Model list][Back to README]

get_options_mmp

list[OptionsMMP] get_options_mmp(underlying=underlying)

MMP Query.

Example

• Api Key Authentication (apiv4):

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.# The client must configure the authentication and authorization parameters# in accordance with the API server security policy.# Examples for each auth method are provided below, use the example that# satisfies your auth use case.# Configure APIv4 key authorizationconfiguration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4",
key="YOU_API_KEY",
secret="YOUR_API_SECRET"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
underlying='BTC_USDT'# str | Underlying (optional)try:
# MMP Query.api_response=api_instance.get_options_mmp(underlying=underlying)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->get_options_mmp: %s\n"%e)

Parameters

Name	Type	Description	Notes
underlying	str	Underlying	[optional]

Return type

list[OptionsMMP]

Authorization

apiv4

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Query successful	-

[Back to top][Back to API list][Back to Model list][Back to README]

set_options_mmp

OptionsMMP set_options_mmp(options_mmp)

MMP Settings

Example

• Api Key Authentication (apiv4):

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.# The client must configure the authentication and authorization parameters# in accordance with the API server security policy.# Examples for each auth method are provided below, use the example that# satisfies your auth use case.# Configure APIv4 key authorizationconfiguration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4",
key="YOU_API_KEY",
secret="YOUR_API_SECRET"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
options_mmp=gate_api.OptionsMMP() # OptionsMMP | try:
# MMP Settingsapi_response=api_instance.set_options_mmp(options_mmp)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->set_options_mmp: %s\n"%e)

Parameters

Name	Type	Description	Notes
options_mmp	OptionsMMP

Return type

OptionsMMP

Authorization

apiv4

HTTP request headers

• Content-Type: application/json
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	MMP Information	-

[Back to top][Back to API list][Back to Model list][Back to README]

reset_options_mmp

OptionsMMP reset_options_mmp(options_mmp_reset)

MMP Reset

Example

• Api Key Authentication (apiv4):

from __future__ importprint_functionimportgate_apifromgate_api.exceptionsimportApiException, GateApiException# Defining the host is optional and defaults to https://api.gateio.ws/api/v4# See configuration.py for a list of all supported configuration parameters.# The client must configure the authentication and authorization parameters# in accordance with the API server security policy.# Examples for each auth method are provided below, use the example that# satisfies your auth use case.# Configure APIv4 key authorizationconfiguration=gate_api.Configuration(
host="https://api.gateio.ws/api/v4",
key="YOU_API_KEY",
secret="YOUR_API_SECRET"
)
api_client=gate_api.ApiClient(configuration)
# Create an instance of the API classapi_instance=gate_api.OptionsApi(api_client)
options_mmp_reset=gate_api.OptionsMMPReset() # OptionsMMPReset | try:
# MMP Resetapi_response=api_instance.reset_options_mmp(options_mmp_reset)
print(api_response)
exceptGateApiExceptionasex:
print("Gate api exception, label: %s, message: %s\n"% (ex.label, ex.message))
exceptApiExceptionase:
print("Exception when calling OptionsApi->reset_options_mmp: %s\n"%e)

Parameters

Name	Type	Description	Notes
options_mmp_reset	OptionsMMPReset

Return type

OptionsMMP

Authorization

apiv4

HTTP request headers

• Content-Type: application/json
• Accept: application/json

HTTP response details

Status code	Description	Response headers
200	MMP Information	-

[Back to top][Back to API list][Back to Model list][Back to README]