👀Product Overview

Brief description of all APIs

APIs Overview

The API services provided by Blockin.ai are divided into 7 categories. A brief description is as follows:

Chain

Mainly query the chain covered by Blockin.ai.

1. Query available chain list (Query available chain list supported by Blockin.ai)

---

Protocol

Mainly query the protocols supported by Blockin.ai, the basic information of the protocols, etc.

1. Query available protocol (Query available protocol supported by Blockin.ai)

2. Query available protocol list (Query available protocol list supported by Blockin.ai)

3. Query all available protocol list (Query available protocol list supported on all chains by Blockin.ai)

4. Query available tagInfo list (Query available tagInfo list supported by Blockin.ai, such as DEX, AMM, Lending, etc.)

5. Query available protocol detail (Query available protocol supported by Blockin.ai)

6. Query available protocol detail list (Query available protocol list of tagged protocols supported by Blockin.ai)

7. Query all available protocol detail list (Query all available protocol list on all chains supported by Blockin.ai)

8. Query liquidity change list by chain name and pool address (Query the adding and removing liquidity list of a pool)

9. Query swap list by chain name and pool address (Query the swap list of a pool)

---

User

Mainly query the user's investment portfolios including DeFi protocols , NFT , token and transaction records.

1. Query used chain by user address (Query user used chain)
2. Query chain balance by chain name and user address (Query chain balance of user)
3. Query protocol portfolio list by chain name and user address (Query protocol portfolio of user)
4. Query protocol portfolios on all chains by user address (Query protocol portfolios on all chains of user)
5. Query protocol portfolio by chain name, protocol name and user address
6. Query protocol portfolios on all chains by protocol name and user address
7. Query protocol top holders by chain name and protocol name (Query the list of top holders of a protocol)
8. Query simple protocol list by chain name and user address (Query assets usd value for each protocol, net asset, total asset and debt)
9. Query simple protocol list on all chains by user address (Query assets usd value for each protocol, net asset, total asset and debt)
10. Query token list by chain name and user address
11. Query token list on all chains by user address
12. Query token top holders by chain name and token address (Query the list of top holders of a token)
13. Query collections by chain name and user address
14. Query collections on all chains by user address
15. Query collections on Bitcoin by user address
16. Query items by chain name, collection address and user address
17. Query inscriptions on Bitcoin by user address
18. Query items transfer list by chain name and user address
19. Query history list by chain name and user address (Query user history list)
20. Query all history list by user address (Query all transaction records of the chain supported by Blockin.ai through the user address)
21. Query User history - Advanced edition (Query user's history (Add address lable and transaction hash) )
22. Query total balance on all supported chains by user address
23. Query token authorized list by chain name and user address
24. Query nft authorized list by chain name and user address
25. Query 24-hour net assets curve by chain name and user address (Query user 24h net assets(wallet + protocols) curve on a single chain)
26. Query 24-hour net assets curve on all supported chains by user address (Query user 24h net assets(wallet + protocols) curve on multiple chains)
27. Query 24-hour protocol portfolios curve by chain name and user address (Query user 24h protocol portfolios curve on a single chain)
28. Query 24-hour protocol portfolios curve on all supported chains by user address (Query user 24h protocol portfolios curve on multiple chains)
29. Query 24-hour wallet curve by chain name and user address (Query user 24h wallet curve on a single chain)
30. Query 24-hour wallet curve on all supported chains by user address (Query user 24h wallet curve on multiple chains)

---

Token

Token price.

1. Query token info (Query token information, such as name, abbreviation, price, etc., by the chain name and token address)
2. Query token info list (Query token information, such as name, abbreviation, price, etc., by the chain name and token address list)
3. Query token market info list (Query currency prices)
4. Query token kline (Query token kline)

5. Subscribe to token kline data (Real-time push of the latest kline data)
6. Unsubscribe token kline (Unsubscribe kline)
7. Query pool list by chain name and token address (Query the relevant pool list based on the token, and the top 100 are queried by default)
8. Query liquidity change list by chain name and token address (Query the adding and removing liquidity list of a pool)
9. Query swap list by chain name and token address (Query the swap list of a pool)
10. Query real-time exchange rate (Query real-time exchange rate)
11. Query real-time token price (Query real-time token price)
12. Query LP_token info (Query LP's token info through token address on the chain and protocol supported by Blockin)
13. Query symbol's price from foreign exchange (Query price of symbols from foreign exchange according to symbol_list)

---

NFT

Mainly query collection metadata, statistical data and item data, etc.

1. Query collection metadata by chain name and collection address (Query the metadata information of collection)
2. Query collection trade list by chain name and collection address
3. Query item info list by chain name and collection address (Query item list of collection)
4. Query item metadata by chain name, collection address and item id (Query item details by collection address and item ID, such as attributes, holders, etc.)
5. Query inscriptions metadata on Bitcoin by inscriptions id (Query metadata for an NFT on the Bitcoin)
6. Refresh collection metadata (Refresh the metadata for an NFT)

---

Mirror

Mainly used to obtain on-chain asset data of a user at a point in time in the past based on timestamp or block number.

1. Query historical token list (Query historical token list by chain name, user address and mirror time or block number)
2. Query historical protocol portfolios (Query historical protocol portfolios by chain name, protocol name, user address and mirror time or block number)
3. Query historical assets (Query historical assets(including token list and protocol portfolios) on one chain by chain name, user address and mirror time or block number)
4. Query historical token list on all supported chains (Query historical token list on multiple chains by user address and mirror time(Block number is unsupported because of multiple chains). You can also specify chain names)
5. Query historical protocol portfolios on all supported chains (Query historical protocol portfolio on multiple chains by user address and mirror time(Block number is unsupported because of multiple chains). You can also specify chain names and protocol name)
6. Query historical assets on all supported chains (Query historical assets(including token list and protocol portfolios) on multiple chains by user address and mirror time(Block number is unsupported because of multiple chains). You can also specify chain names)

Subscription

It mainly provides two services: fixed time query API subscription and history subscription.

1. Create Fixed-time subscription, Update Fixed-time subscription, Delete Fixed-time subscription, Fixed-time subscription Query, Fixed time data query, please contact telegram: @lylynn0308
2. Create history subscription
3. Update history subscription
4. Delete history subscription
5. History subscription query
6. Socket Subscription Connection (Websocket connection)
7. Subscription notify (Please send a receipt to us after successfully receiving the push)
8. Subscription message receipt
9. Create history subscription V2
10. Update history subscription V2
11. Delete history subscription V2
12. Query history subscription wallet V2
13. Query history subscription detail V2
14. History subscription Message query V2
15. Socket Subscription Connection V2

Price

Type	API Name	API Path	Units Cost
Chain	Query available chain list	/v2/chain/chain_list	1
Protocol	Query available protocol list	/v2/protocol/protocol_list	1
Protocol	Query all available protocol list	/v2/protocol/all_protocol_list	2
Protocol	Query available tagInfo list	/v2/protocol/tag_list	1
Protocol	Query available protocol	/v2/protocol/protocol	1
Protocol	Query available protocol detail	/v2/protocol/support_protocol	1
Protocol	Query available protocol detail list	/v2/protocol/support_protocol_list	1
Protocol	Query all available protocol detail list	/v2/protocol/all_support_protocol_list	2
Protocol	Query liquidity change list by chain name and pool address	/v2/dexs/pool/liquidity_change_list	30
Protocol	Query swap list by chain name and pool address	/v2/dexs/pool/swap_list	15
User	Query used chain by user address	/v2/user/chain_list	2
User	Query chain balance by chain name and user address	/v2/user/chain_balance	10
User	Query protocol portfolio by chain name, protocol name and user address	/v2/user/protocol	4
User	Query protocol portfolios on all chains by protocol name and user address	/v2/user/all_protocol	12
User	Query protocol portfolio list by chain name and user address	/v2/user/protocol_list	10
User	Query protocol portfolios on all chains by user address	/v2/user/all_protocol_list	30
User	Query protocol top holders by chain name and protocol name	/v2/user/top_list	30
User	Query simple protocol list by chain name and user address	/v2/user/simple_protocol_list	4
User	Query simple protocol list on all chains by user address	/v2/user/all_simple_protocol_list	12
User	Query token list by chain name and user address	/v2/user/token_list	6
User	Query token list on all chains by user address	/v2/user/all_token_list	18
User	Query token top holders by chain name and token address	/v2/quot/token/holder	30
User	Query collections by chain name and user address	/v2/user/nft/wallet_collection_list	6
User	Query collections on all chains by user address	/v2/user/nft/wallet_all_collection_list	18
User	Query collections on Bitcoin by user address	/v2/user/nft/btc/wallet_collection_list	6
User	Query items by chain name, collection address and user address	/v2/user/nft/wallet_item_list	18
User	Query inscriptions on Bitcoin by user address	/v2/user/nft/btc/wallet_item_list	18
User	Query items transfer list by chain name and user address	/v2/user/nft/wallet_transfer_list	15
User	Query history list by chain name and user address	/v2/user/history_list	5
User	Query all history list by user address	/v2/user/all_history_list	15
User	Query User history - Advanced edition	/v2/user/history_list_pro	15
User	Query total balance on all supported chains by user address	/v2/user/total_balance	30
User	Query token authorized list by chain name and user address	/v2/user/token_authorized_list	10
User	Query nft authorized list by chain name and user address	/v2/user/nft_authorized_list	10
User	Query 24-hour net assets curve by chain name and user address	/v2/user/assets_curve_24h	30
User	Query 24-hour net assets curve on all supported chains by user address	/v2/user/all_assets_curve_24h	90
User	Query 24-hour protocol portfolios curve by chain name and user address	/v2/user/protocol_curve_24h	20
User	Query 24-hour protocol portfolios curve on all supported chains by user address	/v2/user/all_protocol_curve_24h	40
User	Query 24-hour wallet curve by chain name and user address	/v2/user/wallet_curve_24h	15
User	Query 24-hour wallet curve on all supported chains by user address	/v2/user/all_wallet_curve_24h	30
Token	Query token info	/v2/token/token_info	1
Token	Query token info list	/v2/token/token_info_list	10
Token	Query token market info list	/v2/token/market_info_list	10
Token	Query token kline	/v2/quot/market/kline	20
Token	Subscribe to token kline data	/ws/quot/subscribe/market	1 token/month/1000 units
Token	Query pool list by chain name and token address	/v2/dexs/token/pool_list	15
Token	Query liquidity change list by chain name and token address	/v2/dexs/token/liquidity_change_list	30
Token	Query swap list by chain name and token address	/v2/dexs/token/swap_list	15
Token	Query real-time exchange rate	/v2/quot/market/exchange_rate	5
Token	Query real-time token price	/v2/quot/token/price	5
Token	Query symbol's price from foreign exchange	/v2/quot/fx/price	5
Token	Query LP_token info	/v2/token/lp_token/info	10
NFT	Query item info list by chain name and collection address	/v2/nft/collection/item_list	18
NFT	Query collection metadata by chain name and collection address	/v2/nft/collection/metadata	6
NFT	Query collection trade list by chain name and collection address	/v2/nft/trade_list	15
NFT	Query item metadata by chain name, collection address and item id	/v2/nft/get_nft_metadata	8
NFT	Refresh collection metadata	/v2/nft/collection/refresh_metadata	5
NFT	Query inscriptions metadata on Bitcoin by inscriptions id	/v2/nft/btc/get_nft_metadata	8
Mirror	Query historical token list	/v2/mirror/user/token_list	30
Mirror	Query historical token list on all supported chains	/v2/mirror/user/all_token_list	90
Mirror	Query historical protocol portfolios	/v2/mirror/user/protocol	45
Mirror	Query historical protocol portfolios on all supported chains	/v2/mirror/user/all_protocol	90
Mirror	Query historical assets	/v2/mirror/user/chain_assets	75
Mirror	Query historical assets on all supported chains	/v2/mirror/user/all_assets	225
Subscription	History subscription	/ws/subscribe/ws/history	5
Subscription	Socket Subscription Connection V2	/ws/subscribe/ws/history	10

Supported chains and protocols

Total: 27 chains, 1855 protocols, update weekly !

Chains	Protocols
Ethereum	505
BSC	366
Polygon	221
Arbitrum	190
Avalanche	133
Fantom	123
Cronos	54
Optimism	52
Gnosis	30
Metis	24
Base	23
Aurora	21
Canto	11
Celo	10
Linea	10
HECO	9
Mantle	8
Aptos	8
Moonbeam	7
Tron	7
Sui	7
Klaytn	7
Moonriver	6
OKC	6
KCC	6
Conflux	6
Polygon zkEVM	5

Supported Pool Type

View Supported Pool Type