Навчальний посібник з використання кінцевих точок класу Б в API від проєкту Ковалент

fOrest
Covalent
Published in
4 min readMay 27, 2021

В даній статті я розповім про кінцеві точки класу Б в API від проєкту Ковалент. Але спочатку давайте більше дізнаємося про саме API.

Огляд API

API Ковалента є RESTful. Усі запити виконуються за допомогою метода cURL. Тобто посилаючи звичайні запити, навіть за допомогою звичайного браузера, Ви отримуєте інформація в JSON форматі. Для того, щоб можна було відправити запит, потрібно отримати ключ API. Цей ключ є безкоштовним і немає обмежень по кількості запитів.

По даному посиланню, Ви можете зареєструватися на сайті Ковалента і отримати ключ: https://www.covalenthq.com/platform/#/auth/register/

Отриманий ключ, Ви можете використати для надсилання запитів з написаної Вами програми або протестувати запити на сайті Ковалента за даним посиланням: https://www.covalenthq.com/docs/api/#overview

У верхній частині сторінки можете вставити свій ключ і нажати кнопку SET, для того, щоб була можливість відправляти запити через API.

Якщо у Вас немає cпеціальних знань та навичок для роботи з API, Вам потрібно уважно прочитати все інструкцію з самого початку та намагатися протестувати різні запити. Для цього потрібно у вільних полях ввести інформацію, яку запитують і нажати кнопку TRY.

А тепер я більш детально опишу технічні особливості запитів:

Для запиту використовується даний шаблон: https://api.covalenthq.com/v1/

Список підтримуваних мереж та коди даних мереж для запиту.

Основні мережі в форматі назва (код) :

Ethereum (1), Polygon/Matic (137), Avalanche C-Chain (43114), Binance Smart Chain (56), Fantom Opera (250).

Тестові мережі в форматі назва (код) :

Polygon/Matic Mumbai (80001), Fuji C-Chain (43113), Kovan (42).

Кінцеві точки Класу Б

Кінцеві точки Класу Б використовуються для отримання даних для конкретного протоколу на блокчейні.

Тепер я хочу більш детально розказати про всі можливі опції для Класу Б.

А також детально розпишу запити для таких платформ, як Sushiswap, Aave, Balancer, Compound, Curve, Augur, Uniswap та Pancakeswap.

Запити для Sushiswap

Отримати транзакції по ліквідності

GET /v1/{chain_id}/address/{address}/stacks/sushiswap/acts/

Ввівши номер блокчейна і адрес Sushiswap, можна отримати список операцій по ліквідності.

Отримати транзакції по балансу

GET /v1/{chain_id}/address/{address}/stacks/sushiswap/balances/

Можна отримати дані про баланс по заданому адресу Sushiswap.

Отримати дані про активи мережі

GET /v1/{chain_id}/networks/sushiswap/assets/

За даним запитом, можна отримати список пулів, які будуть відсортовані за об’ємом торгів.

Запити для Aave

Отримати баланси адресу Aave v2

GET /v1/1/address/{address}/stacks/aave_v2/balances/

Через цей запит, можна отримати дані про баланси заданого адресу Aave v2, а також про позиції пропозиції та позики.

Отримати баланси адресу Aave

GET /v1/1/address/{address}/stacks/aave/balances/

Можна отримати дані про баланси заданого адресу Aave.

Отримати дані про активи мережі Aave v2

GET /v1/1/networks/aave_v2/assets/

Запит потрібен для отримання даних про активи мережі Aave v2.

Отримати дані про активи мережі Aave

GET /v1/1/networks/aave/assets/

Запит потрібен для отримання даних про активи мережі Aave.

Запити для Balancer

Отримати баланси адресу обмінника Balancer

GET /v1/1/address/{address}/stacks/balancer/balances/

Вказавши адрес обмінника Balancer, можна отримати дані про баланси.

Запити для Compound

Отримати активність адресу Compound

GET /v1/1/address/{address}/stacks/compound/acts/

Через даний запит можна дізнатися про активність заданого адресу Compound.

Отримати баланси адресу Compound

GET /v1/1/address/{address}/stacks/compound/balances/

Можна дізнатися про баланси заданого адресу Compound.

Отримати активи мережі Compound

GET /v1/1/networks/compound/assets/

Зробивши цей запит, можна отримати дані про всі активи мережі Compound.

Запити для Curve

Отримати баланси адресу Curve

GET /v1/1/address/{address}/stacks/curve/balances/

Можна отримати баланси заданого адресу Curve.

Запити для отримання статистики фармінгу

Отримати статистику фармінгу

GET /v1/1/address/{address}/stacks/farming/positions/

Даним запитом можна отримати статистику фармінгу за адресою на платформах Uniswap, Sushiswap та Harvest.

Запити для Augur

Отримати розподілювачів плати за послуги партнерів Augur

GET /v1/1/networks/augur/affiliate_fee/

Можна отримати інформацію про розподілювачів плати за послуги партнерів Augur.

Запити для Uniswap

Отримати баланси адресу обмінника Uniswap v1

GET /v1/1/address/{address}/stacks/uniswap_v1/balances/

За допомогою цього запиту, можна отримати баланси заданого адресу Uniswap v1.

Отримати баланси адресу обмінника Uniswap v2

GET /v1/1/address/{address}/stacks/uniswap_v2/balances/

Можна отримати баланси заданого адресу Uniswap v2.

Отримати транзакції по ліквідності для Uniswap v2

GET /v1/1/address/{address}/stacks/uniswap_v2/acts/

Можна отримати список операцій по ліквідності на платформі Uniswap v2.

Отримати активи мережі Uniswap v2

GET /v1/1/networks/uniswap_v2/assets/

Даний запит повертає у відповідь перелік сторінок пулів Uniswap, відсортованих за обсягом обміну.

Запити для Pancakeswap

Отримати баланси адресу обмінника Pancakeswap

GET /v1/56/address/{address}/stacks/pancakeswap/balances/

За допомогою цього запиту, можна отримати баланси заданого адресу Pancakeswap.

Отримати баланси адресу обмінника Pancakeswap V2

GET /v1/56/address/{address}/stacks/pancakeswap_v2/balances/

Можна отримати баланси заданого адресу Pancakeswap V2.

Отримати транзакції по ліквідності для Pancakeswap

GET /v1/56/address/{address}/stacks/pancakeswap/acts/

Можна отримати список операцій по ліквідності на платформі Pancakeswap.

Отримати активи мережі Pancakeswap

GET /v1/56/networks/pancakeswap/assets/

Даний запит повертає у відповідь перелік сторінок пулів Pancakeswap, відсортованих за обсягом обміну. В даний список включені лише пули із наявними обмінами, за останні 24 години.

Отримати активи мережі Pancakeswap V2

GET /v1/56/networks/pancakeswap_v2/assets/

Даний запит повертає у відповідь перелік сторінок пулів Pancakeswap V2, відсортованих за обсягом обміну. В даний список включені лише пули із наявними обмінами, за останні 24 години.

Отримати активи мережі Pancakeswap V2 за адресою

GET /v1/56/networks/pancakeswap_v2/assets/

Даний запит повертає у відповідь детальну інформацію про пул для конкретної вказаної адреси такого пулу.

Більш детальну інформацію можете знайти в офіційному посібнику за даною адресою: https://www.covalenthq.com/docs/api/#tag--Class-B

Також рекомендую дізнатися більше інформації про Ковалент з наступних джерел:

Сайт: https://www.covalenthq.com
Дискорд: http://covalenthq.com/discord
Твіттер: https://twitter.com/Covalent_HQ
Телеграм: https://t.me/CovalentHQ
Блог (сайт): https://www.covalenthq.com/blog/
Блог (Медіум): https://medium.com/covalent-hq/
Ютуб канал: https://www.youtube.com/c/CovalentHQ/

Раджу переглянути спільноти Ковалент Україна:

Твіттер: https://twitter.com/CovalentUkraine
Телеграм: https://t.me/covalent_ukraine
Інстаграм: http://instagram.com/covalent_ukraine
Ютуб канал: http://youtube.com/channel/UCrmRKKv3iQiaK51B50BnUpw

--

--