Networks

Unless otherwise specified, a network can be provided either as a network name (ethereum) or a network id (42161 for Arbitrum for example).

https://services.blockpour.com/api/prices/average/token/DAI?interval=1h&network=ethereum
https://services.blockpour.com/api/prices/average/token/DAI?interval=1h&network=1

Some endpoints accept a list of networks. In this case, unless otherwise specified, the endpoint will return data corresponding to all endpoints if no network is provided. Here again, networks can be either network names or network ids.

https://services.blockpour.com/api/swaps/recent
https://services.blockpour.com/api/swaps/recent?network=ethereum,optimism
https://services.blockpour.com/api/swaps/recent?network=1,10

Exchanges

Exchanges can be referred to by their factory address or by the exchange name (in lowercase and without spaces). In general, all major exchanges can be queried using their name. If the exchange name is not tagged within our system or if you prefer to do so, you can also query by using the exchange factory address:

https://services.blockpour.com/api/swaps/exchange/uniswapv2?network=ethereum
https://services.blockpour.com/api/swaps/exchange/0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f?network=ethereum

Please note that there may be some variations in the naming conventions of different exchanges, so it is best to check the documentation or use the exchange's address if necessary.

Tokens

Many of Blockpour's API endpoints accept a token parameter. Unless otherwise specified the token parameter can be either a token address or a token symbol.

For example pool snapshots for the YFI token on Ethereum can be queried as follows:

https://services.blockpour.com/api/pools/snapshots/reserves/token/YFI?network=ethereum
https://services.blockpour.com/api/pools/snapshots/reserves/token/0x0bc529c00c6401aef6d220be8c6ea1667f6ad93e?network=ethereum

🚧

Note that the ERC20 tokens of each project can have several representations on the same chain. For example a token can be bridged through multiple bridges (for example Celer and Wormhole).

When querying by symbol, the data corresponding to the most traded token on a given network will be returned. In some cases, several tokens might be traded equally so we recommend using the token's address for production applications or use the token endpoint to verify that you are querying the correct token.

For example to make sure you have the correct DAI address on Optimism:

https://services.blockpour.com/api/tokens/DAI?network=optimism