API Reference

The stats section of the Blockpour API provides information on networks, pools, exchanges, and tokens. We do not use third-party data, and we do not fetch data through decentralized exchange APIs. The data is directly aggregated from our swaps dataset.

📘

Aggregated data such as trade count, total trade volume etc is derived from swaps on the exchanges and pools indexed in our system.

We track all major tokens and pools on supported blockchains but we currently only index swaps on uniswap-V2 and uniswap-V3 like exchanges. For example Curve volume is currently not included in our dataset.

Methodology

Data received through the stats endpoints is aggregated from all swaps on a given entity for a certain timeperiod.

For example in the following record from the stats/network endpoint:
{
"date": "2022-12-07T00:00:00.000Z",
"network": 1,
"volume_usd": 81145088.85325041,
"average_trade_size": 4561.0189901214335,
"trade_count": 18177,
"unique_trader_count": 6185,
"unique_pools_traded_count": 1914
}

volume_usd corresponds to the sum of USD volume for all swaps on the ethereum network on'2022-12-07' (from '2022-12-07T00:00:00 UTC to '2022-12-08T00:00:00 UTC)

In general trade counts are computed directly from swaps and include only the entities that we track. For example unique_pools_traded_count only includes the pools and exchanges that we support and unique_trader_count only counts the addresses that have performed a swap on pools/exchanges that we support. That being said, we support most large exchange on each network so these numbers should be representative of network activity . You can refer to the Exchanges section for more details on our current coverage.

Network Stats

Each response object contains the aggregated measures such as volume and trade counts for a given network on a certain data (from midnight UTC to midnight UTC)

FieldDataDescription
datestringStart date for the given period
networknumberNetwork ID
volume_usdnumberTotal USD trade volume for that period
average_trade_sizenumberAverage size of trades in USD for that period
trade_countnumberTotal number of trades for that period . This number is based on the number of swaps on pools that are indexed.
unique_trader_countnumberTotal number of unique traders. This number is calculated on the number of swaps on pools that are indexed.
unique_pools_traded_countnumberTotal number of pools that had at least swap on that period

Pool Stats

Each response object contains the aggregated measures such as volume and trade counts for a given pool on a certain data (from midnight UTC to midnight UTC)

FieldDataDescription
datestringStart date for the given period
pairstringPool address
networknumberNetwork ID
average_trade_sizenumberAverage trade size (in USD) for that period
volume_usdnumberTotal USD volume for that period
average_price0numberAverage price of the pool's token0 during the period
average_price1numberAverage price the pool's token1 during the period
volume_token1numberTotal volume of token1 traded during the period
volume_token0numberTotal volume of token0 traded during the period
trade_countnumberTotal number of trades for that period
unique_trader_countnumberTotal number of unique traders for that period

Exchange Stats

Each response object contains the aggregated measures such as volume and trade counts for a given exchange on a certain date (from midnight UTC to midnight UTC)

FieldDataDescription
datestringStart date for the given period
networknumberNetwork ID
exchange_namestringName of the exchange
exchange_factorystringAddress of the exchange factory contract
volumestringTotal volume of trades for that period
sell_volumestringTotal USD volume of sell trades for that period
buy_volumestringTotal USD volume of buy trades for that period
largest_trade_sizestringLargest trade size (in USD) for that period
average_trade_sizestringAverage trade size (in USD) for that period
average_pricestringAverage trade price (in USD) for that period
trade_countnumberTotal number of trades for that period

Token By Exchange Stats

Each response object contains the aggregated measures such as volume and trade counts for a given token on an exchange on a certain date (from midnight UTC to midnight UTC)

FieldDataDescription
datestringStart date for the given period
networknumberNetwork ID
symbolnumberToken Symbol
addressstringToken Address
exchange_namestringExchange Name
exchange_factorystringAddress of the exchange factory contract
trade_countnumberTotal number of trades for that period
volumenumberTotal USD volume of trades for that period
buy_volumenumberTotal USD volume of buy trades for that period
sell_volumenumberTotal USD volume of sell trades for that period
largest_trade_sizenumberLargest trade size (in USD) for that period
average_trade_sizenumberAverage trade size (in USD) for that period