Documentation

API Docs Technical Docs User Guides Changelogs

Versions

# Peatio User API v2

API for Peatio application.

#Version: 2.3.44

Contact information:
openware.com
https://www.openware.com
[email protected]

License: https://github.com/rubykube/peatio/blob/master/LICENSE.md

# Security

Bearer

apiKey	API Key
Name	JWT
In	header

# /public/trading_fees

#GET

#Description:

Returns trading_fees table as paginated collection

#Parameters

Name	Located in	Description	Required	Schema
group	query	Member group for define maker/taker fee.	No	string
market_id	query	Market id for define maker/taker fee.	No	string
limit	query	Limit the number of returned paginations. Defaults to 100.	No	integer
page	query	Specify the page of paginated results.	No	integer
ordering	query	If set, returned values will be sorted in specific order, defaults to 'asc'.	No	string
order_by	query	Name of the field, which result will be ordered by.	No	string

#Responses

Code	Description	Schema
200	Returns trading_fees table as paginated collection	[ TradingFee ]

# /public/health/ready

#GET

#Description:

Get application readiness status

#Responses

Code	Description
200	Get application readiness status

# /public/health/alive

#GET

#Description:

Get application liveness status

#Responses

Code	Description
200	Get application liveness status

# /public/version

#GET

#Description:

Get running Peatio version and build details.

#Responses

Code	Description
200	Get running Peatio version and build details.

# /public/timestamp

#GET

#Description:

Get server current time, in seconds since Unix epoch.

#Responses

Code	Description
200	Get server current time, in seconds since Unix epoch.

# /public/member-levels

#GET

#Description:

Returns hash of minimum levels and the privileges they provide.

#Responses

Code	Description
200	Returns hash of minimum levels and the privileges they provide.

# /public/markets/{market }/tickers

#GET

#Description:

Get ticker of specific market.

#Parameters

Name	Located in	Description	Required	Schema
market	path		Yes	string

#Responses

Code	Description	Schema
200	Get ticker of specific market.	Ticker

# /public/markets/tickers

#GET

#Description:

Get ticker of all markets (For response doc see /:market/tickers/ response).

#Responses

Code	Description	Schema
200	Get ticker of all markets (For response doc see /:market/tickers/ response).	Ticker

# /public/markets/{market }/k-line

#GET

#Description:

Get OHLC(k line) of specific market.

#Parameters

Name	Located in	Description	Required	Schema
market	path		Yes	string
period	query	Time period of K line, default to 1. You can choose between 1, 5, 15, 30, 60, 120, 240, 360, 720, 1440, 4320, 10080	No	integer
time_from	query	An integer represents the seconds elapsed since Unix epoch. If set, only k-line data after that time will be returned.	No	integer
time_to	query	An integer represents the seconds elapsed since Unix epoch. If set, only k-line data till that time will be returned.	No	integer
limit	query	Limit the number of returned data points default to 30. Ignored if time_from and time_to are given.	No	integer

#Responses

Code	Description
200	Get OHLC(k line) of specific market.

# /public/markets/{market }/depth

#GET

#Description:

Get depth or specified market. Both asks and bids are sorted from highest price to lowest.

#Parameters

Name	Located in	Description	Required	Schema
market	path		Yes	string
limit	query	Limit the number of returned price levels. Default to 300.	No	integer

#Responses

Code	Description
200	Get depth or specified market. Both asks and bids are sorted from highest price to lowest.

# /public/markets/{market }/trades

#GET

#Description:

Get recent trades on market, each trade is included only once. Trades are sorted in reverse creation order.

#Parameters

Name	Located in	Description	Required	Schema
market	path		Yes	string
limit	query	Limit the number of returned trades. Default to 100.	No	integer
page	query	Specify the page of paginated results.	No	integer
timestamp	query	An integer represents the seconds elapsed since Unix epoch.If set, only trades executed before the time will be returned.	No	integer
order_by	query	If set, returned trades will be sorted in specific order, default to 'desc'.	No	string

#Responses

Code	Description	Schema
200	Get recent trades on market, each trade is included only once. Trades are sorted in reverse creation order.	[ Trade ]

# /public/markets/{market }/order-book

#GET

#Description:

Get the order book of specified market.

#Parameters

Name	Located in	Description	Required	Schema
market	path		Yes	string
asks_limit	query	Limit the number of returned sell orders. Default to 20.	No	integer
bids_limit	query	Limit the number of returned buy orders. Default to 20.	No	integer

#Responses

Code	Description	Schema
200	Get the order book of specified market.	[ OrderBook ]

# /public/markets

#GET

#Description:

Get all available markets.

#Responses

Code	Description	Schema
200	Get all available markets.	[ Market ]

# /public/currencies

#GET

#Description:

Get list of currencies

#Parameters

Name	Located in	Description	Required	Schema
type	query	Currency type	No	string

#Responses

Code	Description	Schema
200	Get list of currencies	[ Currency ]

# /public/currencies/{id }

#GET

#Description:

Get a currency

#Parameters

Name	Located in	Description	Required	Schema
id	path	Currency code.	Yes	string

#Responses

Code	Description	Schema
200	Get a currency	Currency

# /account/withdraws

#POST

#Description:

Creates new withdrawal to active beneficiary.

#Parameters

Name	Located in	Description	Required	Schema
otp	formData	OTP to perform action	Yes	integer
beneficiary_id	formData	ID of Active Beneficiary belonging to user.	Yes	integer
currency	formData	The currency code.	Yes	string
amount	formData	The amount to withdraw.	Yes	double
note	formData	Optional metadata to be applied to the transaction. Used to tag transactions with memorable comments.	No	string

#Responses

Code	Description
201	Creates new withdrawal to active beneficiary.

#GET

#Description:

List your withdraws as paginated collection.

#Parameters

Name	Located in	Description	Required	Schema
currency	query	Currency code.	No	string
limit	query	Number of withdraws per page (defaults to 100, maximum is 100).	No	integer
page	query	Page number (defaults to 1).	No	integer

#Responses

Code	Description	Schema
200	List your withdraws as paginated collection.	[ Withdraw ]

# /account/beneficiaries/{id }

#DELETE

#Description:

Delete beneficiary

#Parameters

Name	Located in	Description	Required	Schema
id	path	Beneficiary Identifier in Database	Yes	integer

#Responses

Code	Description
204	Delete beneficiary

#GET

#Description:

Get beneficiary by ID

#Parameters

Name	Located in	Description	Required	Schema
id	path	Beneficiary Identifier in Database	Yes	integer

#Responses

Code	Description	Schema
200	Get beneficiary by ID	Beneficiary

# /account/beneficiaries/{id }/activate

#PATCH

#Description:

Activates beneficiary with pin

#Parameters

Name	Located in	Description	Required	Schema
id	path	Beneficiary Identifier in Database	Yes	integer
pin	formData	Pin code for beneficiary activation	Yes	integer

#Responses

Code	Description	Schema
200	Activates beneficiary with pin	Beneficiary

# /account/beneficiaries

#POST

#Description:

Create new beneficiary

#Parameters

Name	Located in	Description	Required	Schema
currency	formData	Beneficiary currency code.	Yes	string
name	formData	Human rememberable name which refer beneficiary.	Yes	string
description	formData	Human rememberable name which refer beneficiary.	No	string
data	formData	Beneficiary data in JSON format	Yes	json

#Responses

Code	Description	Schema
201	Create new beneficiary	Beneficiary

#GET

#Description:

Get list of user beneficiaries

#Parameters

Name	Located in	Description	Required	Schema
currency	query	Beneficiary currency code.	No	string
state	query	Defines either beneficiary active - user can use it to withdraw moneyor pending - requires beneficiary activation with pin.	No	string

#Responses

Code	Description	Schema
200	Get list of user beneficiaries	[ Beneficiary ]

# /account/deposit_address/{currency }

#GET

#Description:

Returns deposit address for account you want to deposit to by currency. The address may be blank because address generation process is still in progress. If this case you should try again later.

#Parameters

Name	Located in	Description	Required	Schema
currency	path	The account you want to deposit to.	Yes	string
address_format	query	Address format legacy/cash	No	string

#Responses

Code	Description	Schema
200	Returns deposit address for account you want to deposit to by currency. The address may be blank because address generation process is still in progress. If this case you should try again later.	Deposit

# /account/deposits/{txid }

#GET

#Description:

Get details of specific deposit.

#Parameters

Name	Located in	Description	Required	Schema
txid	path	Deposit transaction id	Yes	string

#Responses

Code	Description	Schema
200	Get details of specific deposit.	Deposit

# /account/deposits

#GET

#Description:

Get your deposits history.

#Parameters

Name	Located in	Description	Required	Schema
currency	query	Currency code	No	string
state	query		No	string
limit	query	Number of deposits per page (defaults to 100, maximum is 100).	No	integer
page	query	Page number (defaults to 1).	No	integer

#Responses

Code	Description	Schema
200	Get your deposits history.	[ Deposit ]

# /account/balances/{currency }

#GET

#Description:

Get user account by currency

#Parameters

Name	Located in	Description	Required	Schema
currency	path	The currency code.	Yes	string

#Responses

Code	Description	Schema
200	Get user account by currency	Account

# /account/balances

#GET

#Description:

Get list of user accounts

#Responses

Code	Description	Schema
200	Get list of user accounts	[ Account ]

# /market/trades

#GET

#Description:

Get your executed trades. Trades are sorted in reverse creation order.

#Parameters

Name	Located in	Description	Required	Schema
market	query		No	string
limit	query	Limit the number of returned trades. Default to 100.	No	integer
page	query	Specify the page of paginated results.	No	integer
time_from	query	An integer represents the seconds elapsed since Unix epoch.If set, only trades executed after the time will be returned.	No	integer
time_to	query	An integer represents the seconds elapsed since Unix epoch.If set, only trades executed before the time will be returned.	No	integer
order_by	query	If set, returned trades will be sorted in specific order, default to 'desc'.	No	string

#Responses

Code	Description	Schema
200	Get your executed trades. Trades are sorted in reverse creation order.	[ Trade ]

# /market/orders/cancel

#POST

#Description:

Cancel all my orders.

#Parameters

Name	Located in	Description	Required	Schema
market	formData		No	string
side	formData	If present, only sell orders (asks) or buy orders (bids) will be canncelled.	No	string

#Responses

Code	Description	Schema
201	Cancel all my orders.	Order

# /market/orders/{id }/cancel

#POST

#Description:

Cancel an order.

#Parameters

Name	Located in	Description	Required	Schema
id	path		Yes	integer

#Responses

Code	Description
201	Cancel an order.

# /market/orders

#POST

#Description:

Create a Sell/Buy order.

#Parameters

Name	Located in	Required	Schema
market	formData	Yes	string
side	formData	Yes	string
volume	formData	Yes	double
ord_type	formData	No	string
price	formData	Yes	double

#Responses

Code	Description	Schema
201	Create a Sell/Buy order.	Order

#GET

#Description:

Get your orders, result is paginated.

#Parameters

Name	Located in	Description	Required	Schema
market	query		No	string
state	query	Filter order by state.	No	string
limit	query	Limit the number of returned orders, default to 100.	No	integer
page	query	Specify the page of paginated results.	No	integer
order_by	query	If set, returned orders will be sorted in specific order, default to "desc".	No	string
ord_type	query	Filter order by ord_type.	No	string
type	query	Filter order by type.	No	string

#Responses

Code	Description	Schema
200	Get your orders, result is paginated.	[ Order ]

# /market/orders/{id }

#GET

#Description:

Get information of specified order.

#Parameters

Name	Located in	Description	Required	Schema
id	path		Yes	integer

#Responses

Code	Description	Schema
200	Get information of specified order.	Order

# Models

#TradingFee

Returns trading_fees table as paginated collection

Name	Type	Description	Required
id	integer	Unique trading fee table identifier in database.	No
group	string	Member group for define maker/taker fee.	No
market_id	string	Market id for define maker/taker fee.	No
maker	double	Market maker fee.	No
taker	double	Market taker fee.	No
created_at	string	Trading fee table created time in iso8601 format.	No
updated_at	string	Trading fee table updated time in iso8601 format.	No

#Ticker

Get ticker of all markets (For response doc see /:market/tickers/ response).

Name	Type	Description	Required
at	integer	Timestamp of ticker	No
ticker	TickerEntry	Ticker entry for specified time	No

#TickerEntry

Name	Type	Description	Required
buy	double	Best buy (highest) price in current orderbook (0.0 if there is no buy orders)	No
sell	double	Best sell (lowest) price in current orderbook (0.0 if there is no sell orders)	No
low	double	The lowest trade price during last 24 hours (0.0 if no trades executed during last 24 hours)	No
high	double	The highest trade price during last 24 hours (0.0 if no trades executed during last 24 hours)	No
open	double	Price of the first trade executed 24 hours ago or less	No
last	double	The last executed trade price	No
volume	double	Total amount of trades executed during last 24 hours (recalculated once in 15 minuets)	No
vol	double	Alias to volume	No
avg_price	double	Average price more precisely VWAP is calculated by adding up the total traded for every transaction(price multiplied by the number of shares traded) and then dividing by the total shares traded	No
price_change_percent	string	Price change in the next format +3.19%.Price change is calculated using next formula (last - open) / open * 100%	No

#Trade

Get your executed trades. Trades are sorted in reverse creation order.

Name	Type	Description	Required
id	string	Trade ID.	No
price	double	Trade price.	No
amount	double	Trade amount.	No
total	double	Trade total (Amount * Price).	No
fee_currency	double	Currency user's fees were charged in.	No
fee	double	Percentage of fee user was charged for performed trade.	No
fee_amount	double	Amount of fee user was charged for performed trade.	No
market	string	Trade market id.	No
created_at	string	Trade create time in iso8601 format.	No
taker_type	string	Trade taker order type (sell or buy).	No
side	string	Trade side.	No
order_id	integer	Order id.	No

#OrderBook

Get the order book of specified market.

Name	Type	Description	Required
asks	[ Order ]	Asks in orderbook	No
bids	[ Order ]	Bids in orderbook	No

#Order

Get your orders, result is paginated.

Name	Type	Description	Required
id	integer	Unique order id.	No
side	string	Either 'sell' or 'buy'.	No
ord_type	string	Type of order, either 'limit' or 'market'.	No
price	double	Price for each unit. e.g.If you want to sell/buy 1 btc at 3000 usd, the price is '3000.0'	No
avg_price	double	Average execution price, average of price in trades.	No
state	string	One of 'wait', 'done', or 'cancel'.An order in 'wait' is an active order, waiting fulfillment;a 'done' order is an order fulfilled;'cancel' means the order has been canceled.	No
market	string	The market in which the order is placed, e.g. 'btcusd'.All available markets can be found at /api/v2/markets.	No
created_at	string	Order create time in iso8601 format.	No
updated_at	string	Order updated time in iso8601 format.	No
origin_volume	double	The amount user want to sell/buy.An order could be partially executed,e.g. an order sell 5 btc can be matched with a buy 3 btc order,left 2 btc to be sold; in this case the order's volume would be '5.0',its remaining_volume would be '2.0', its executed volume is '3.0'.	No
remaining_volume	double	The remaining volume, see 'volume'.	No
executed_volume	double	The executed volume, see 'volume'.	No
trades_count	integer	Count of trades.	No
trades	[ Trade ]	Trades wiht this order.	No

#Market

Get all available markets.

Name	Type	Description	Required
id	string	Unique market id. It's always in the form of xxxyyy,where xxx is the base currency code, yyy is the quotecurrency code, e.g. 'btcusd'. All available markets canbe found at /api/v2/markets.	No
name	string	Market name.	No
base_unit	string	Market Base unit.	No
quote_unit	string	Market Quote unit.	No
min_price	double	Minimum order price.	No
max_price	double	Maximum order price.	No
min_amount	double	Minimum order amount.	No
amount_precision	double	Precision for order amount.	No
price_precision	double	Precision for order price.	No
state	string	Market state defines if user can see/trade on current market.	No

#Currency

Get a currency

Name	Type	Description	Required
id	string	Currency code.	No
name	string	Currency name	No
symbol	string	Currency symbol	No
explorer_transaction	string	Currency transaction exprorer url template	No
explorer_address	string	Currency address exprorer url template	No
type	string	Currency type	No
deposit_enabled	string	Currency deposit possibility status (true/false).	No
withdrawal_enabled	string	Currency withdrawal possibility status (true/false).	No
deposit_fee	string	Currency deposit fee	No
min_deposit_amount	string	Minimal deposit amount	No
withdraw_fee	string	Currency withdraw fee	No
min_withdraw_amount	string	Minimal withdraw amount	No
withdraw_limit_24h	string	Currency 24h withdraw limit	No
withdraw_limit_72h	string	Currency 72h withdraw limit	No
base_factor	string	Currency base factor	No
precision	string	Currency precision	No
icon_url	string	Currency icon	No
min_confirmations	string	Number of confirmations required for confirming deposit or withdrawal	No

#Withdraw

List your withdraws as paginated collection.

Name	Type	Description	Required
id	integer	The withdrawal id.	No
currency	string	The currency code.	No
type	string	The withdrawal type	No
amount	string	The withdrawal amount	No
fee	double	The exchange fee.	No
blockchain_txid	string	The withdrawal transaction id.	No
rid	string	The beneficiary ID or wallet address on the Blockchain.	No
state	string	The withdrawal state.	No
confirmations	integer	Number of confirmations.	No
note	string	Withdraw note.	No
created_at	string	The datetimes for the withdrawal.	No
updated_at	string	The datetimes for the withdrawal.	No
done_at	string	The datetime when withdraw was completed	No

#Beneficiary

Get list of user beneficiaries

Name	Type	Description	Required
id	integer	Beneficiary Identifier in Database	No
currency	string	Beneficiary currency code.	No
name	string	Human rememberable name which refer beneficiary.	No
description	string	Human rememberable description of beneficiary.	No
data	json	Bank Account details for fiat Beneficiary in JSON format.For crypto it's blockchain address.	No
state	string	Defines either beneficiary active - user can use it to withdraw moneyor pending - requires beneficiary activation with pin.	No

#Deposit

Get your deposits history.

Name	Type	Description	Required
id	integer	Unique deposit id.	No
currency	string	Deposit currency id.	No
amount	double	Deposit amount.	No
fee	double	Deposit fee.	No
txid	string	Deposit transaction id.	No
confirmations	integer	Number of deposit confirmations.	No
state	string	Deposit state.	No
created_at	string	The datetime when deposit was created.	No
completed_at	string	The datetime when deposit was completed..	No

#Account

Get list of user accounts

Name	Type	Description	Required
currency	string	Currency code.	No
balance	double	Account balance.	No
locked	double	Account locked funds.	No

#Member

Name	Type	Description	Required
uid	string	Member UID.	No
email	string	Member email.	No
accounts	[ Account ]	Member accounts.	No