Public api

Оглавление

Данный API предоставляет возможность доступа к такой информации, как: тикеры пар, активные ордера пар, последние торги по паре и др.

Все запросы к API идут по следующему адресу:
https://api.terrachange.me/v1/api/<имя метода>


Пары перечисляются используя знак тире (-) для разделения, например:
https://api.terrachange.me/v1/api/ticker/LIVECOINUSD_QIWIRUB-EXMOUSD_QIWIRUB


Можно использовать любое количество пар в перечислении. Дубликаты не допускаются. Так же можно использовать только одну пару, например:
https://api.terrachange.me/v1/api/ticker/EXMOUSD_QIWIRUB
Множество пар работает со всеми методами представленными в паблик API, кроме info.


Вся информация кэшируется каждые 2 секунды, поэтому нет смысла делать запросы чаще.
Все ответы от API приходят в формате JSON.

Метод info

Данный метод предоставляет всю информацию о текущих активных парах, такую как: максимальное количество знаков после запятой при торгах, минимальную цену, максимальную цену, минимальное количество при покупке/продаже.

Пример запроса:   https://api.terrachange.me/v1/api/info


Пример ответа:

{
    "server_time": 1518686474,
    "pairs": {
        "WEXUSD": {
            "min_price": "0.1",
            "max_price": "100",
            "min_amount": "1",
            "max_amount": "200000"
        },
        ...
    }
}


min_price: минимальная цена разрешенная при торгах.

max_price: максимальная цена разрешенная при торгах.

min_amount: минимальное количество разрешенное для покупки/продажи.

max_amount: максимальное количество разрешенное для покупки/продажи.


Метод ticker

Данный метод предоставляет всю информацию о торгах по паре, такую как: максимальная цена, минимальная цена, средняя цена, объем торгов, объем торгов в валюте, последняя сделка, цена покупки и продажи.
Вся информация предоставлена за последние 24 часа.

Пример запроса:   https://api.terrachange.me/v1/api/ticker/EXMOUSD_QIWIRUB


Пример ответа:

{
	"EXMOUSD_QIWIRUB": {
		"high": "61",
		"low": "58",
		"avg": "59",
		"vol": "1789242.5624",
		"vol_cur": "30312.4742",
		"last": "58.30",
		"buy": "58.40",
		"sell": "59.20",
		"updated": 1518705965
	},
    ...
}


high: максимальная цена.

low: минимальная цена.

avg: средняя цена.

vol: объем торгов.

vol_cur: объем торгов в валюте.

last: цена последней сделки.

buy: цена покупки.

sell: цена продажи.

updated: последнее обновление кэша.

Метод depth

Данный метод предоставляет информацию о активных ордерах пары.
Дополнительно принимает необязательный GET-параметр limit, который указывает, сколько ордеров нужно вывести (по умолчанию 150).

Принимает значение не более 5000.

Пример запроса:   https://api.terrachange.me/v1/api/depth/EXMOUSD_QIWIRUB


Пример ответа:

{
    "EXMOUSD_QIWIRUB": {
        "asks": [
            ["59.55", "99.5"],
            ["60", "900.95"],
        ],
        "bids": [
            ["59", "150"],
            ["58", "1200"],
        ]
    },
    ...
}


asks: ордера на продажу.

bids: ордера на покупку.

Метод trades

Данный метод предоставляет информацию о последних сделках.
Дополнительно принимает необязательный GET-параметр limit, который указывает, сколько ордеров нужно вывести (по умолчанию 150).

Принимает значение не более 5000.

Пример запроса:   https://api.terrachange.me/v1/api/trades/EXMOUSD_QIWIRUB


Пример ответа:

{
    "EXMOUSD_QIWIRUB": [
        {
            "type": "asks",
            "price": "55",
            "amount": "10",
            "id": "18",
            "timestamp": 1518717160
        },
        ...
    ],
    ...
}


type: ask - продажа, bid - покупка.

price: цена покупки/продажи.

amount: количество купленного/проданного.

tid: идентификатор сделки.

timestamp: UNIX time сделки.