Навчальний посібник з використання кінцевих точок класу Б в API від проєкту Ковалент
В даній статті я розповім про кінцеві точки класу Б в 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