NAV Navbar
shell

Overview

Welcome to the Covalent API!

There are three main endpoints:

The most common query parameters:

Parameter Default Description
quote-currency optional One of usd, cad, inr, eth, eur. If not specified, use usd.
format optional One of csv, json. If not specified, use json
format-options optional noheader if you want to omit CSV headers

Introduction

The Covalent API is RESTful. The API is designed around the main resources that's available through the web interface. Sample API calls are provided next to each method using cURL.

URL Patterns

API Host

https://api.covalenthq.com/v1/

Some points to keep in mind:

Authentication

To access the Covalent API, you will need an API key. You can find your API key in the web interface. Various authentication mechanisms are available:

Query parameter

>>> curl -X GET https://api.covalenthq.com/v1/ENDPOINT/?key=API_KEY

Simply append key=API_KEY as a query parameter to all queries.

The main advantage of this method is to embed the API endpoints within applications that do not support more sophisticated auth mechanisms, like Google Sheets or as IFrames.

Basic Auth

>>> curl -X GET https://api.covalenthq.com/v1/ENDPOINT/ \
     -u API_KEY:
     -H 'Content-Type: application/json'
# The colon prevents curl from asking for a password.

Provide your API key as the basic auth username. You can find your API key in the web interface. You do not need to provide a password.

Response format

{
  "data": {...},
  "error": false,
  "error_message": null,
  "error_code": null
}

By default, we return JSON responses with the same shape for all endpoints. The main keys are data, error, error_message and error_code.

If you specify a CSV response using the format parameter – it's possible to toggle the headers on and off using the format-options=noheader parameter.

Client libraries

Though the Covalent REST API is idiomatic, for the best experience, we recommend using one of the client libraries.

Rate limiting

Not enforced at present. Please let us know before you melt our servers!

API Status

>>> curl "https://api.covalenthq.com/v1/status/" 
{
  "data": {
    "1": {
      "name": "Ethereum.Foundation",
      "latest_block": {
        "signed_at": "2019-04-03T00:05:06",
        "age_seconds": 28.898127,
        "height": 7492053,
        "hash": "0xd460470b3ff6dd53691b98eb97f907c055b82d474c6464c8aed2b4e04309e351"
      },
      "latest_enriched_block": {
        "block_signed_at": "2019-04-02T23:37:34",
        "age_seconds": 1680.898127,
        "block_height": 7491932
      }
    },
    "market_data_update": {
      "updated_at": "2019-04-02T23:45:48.173706",
      "age": 1187
    }
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

The API Status endpoint tells you how recently the on-chain and off-chain data was refreshed.

HTTP request

GET https://api.covalenthq.com/v1/status/

Blocks

>>> curl "https://api.covalenthq.com/v1/1/block/6207112/" 
{
  "data": {
    "block": {
      "id": 1306258158258674000,
      "hash": "0xc90b63603a0b270576766e5f3a3b26290a4fb753622587f5faa93e5ac3f6d956",
      "version": 1702127665,
      "size": 38793,
      "signed_at": "2018-08-24T20:43:52",
      "parent_hash": "0x40533a67315a6c01633f7bf8044291daaadcdfbc8b16e4c54313011613af698c",
      "height": 6207112,
      "transactions_root": null,
      "uncles_root": null,
      "state_root": null,
      "receipts_root": null,
      "uncles": [],
      "extra_data": "0x65746865726d696e652d657534",
      "miner": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
      "mining_cost": 3476235820253555,
      "seal": [],
      "gas_limit": 8000029,
      "gas_used": 7979963,
      "observed_mediantime": null,
      "observed_difficulty": null,
      "confirmations_at_insertion": null,
      "miner_label": "Ethermine"
    },
    "transactions": [
      {
        "block_id": 1306258158258674000,
        "tx_offset": 0,
        "hash": "0xbda472257f4b997bf5b56b4d6d740b25a1856835cf697f9ca23c258a3b1ca5b7",
        "successful": true,
        "version": 1702127665,
        "size": 56,
        "mining_cost": 21000,
        "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
        "to": "0xa7ab4d96da92a2f51327ae4369292cc3986e16f7",
        "creates": null,
        "value": "60214405555576377",
        "payload_size": 0,
        "contract_input": null,
        "gas_offered": 50000,
        "gas_spent": 21000,
        "gas_price": 1000000000,
        "bitcoin_vins": null,
        "bitcoin_vouts": null,
        "block_signed_at": "2018-08-24T20:43:52",
        "block_height": 6207112,
        "to_label": null,
        "from_label": "Ethermine"
      },
      {...}
    ]
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

Get a specific block with its transactions. We support lookups by both height as well as block hash.

HTTP request

GET https://api.covalenthq.com/v1/1/block/latest/

GET https://api.covalenthq.com/v1/1/block/HEIGHT/

GET https://api.covalenthq.com/v1/1/block/0xHASH/

Transactions

Get transaction

>>> curl "https://api.covalenthq.com/v1/1/transaction/0x4959b4636961c4a17f55f99afbaab76435b228d481aec68b3aa12e96fbe130d4/" 
{
  "data": {
    "transactions": [
      {
        "block_id": 1306258158258674000,
        "tx_offset": 42,
        "hash": "0x4959b4636961c4a17f55f99afbaab76435b228d481aec68b3aa12e96fbe130d4",
        "successful": true,
        "version": 1702127665,
        "size": 48,
        "mining_cost": 21000,
        "from": "0xddca59f0f2d0362043549e9b2a779cc1db9e99a8",
        "to": "0x11372a7418d58b162d1120e9e65e5aa74936ed71",
        "creates": null,
        "value": "1",
        "payload_size": 0,
        "contract_input": null,
        "gas_offered": 37500,
        "gas_spent": 21000,
        "gas_price": 2100000000,
        "bitcoin_vins": null,
        "bitcoin_vouts": null,
        "to_label": "BlockchainCuties_Wallet",
        "from_label": null,
        "block_signed_at": "2018-08-24T20:43:52",
        "block_height": 6207112
      }
    ],
    "block": {
      "id": 1306258158258674000,
      "hash": "0xc90b63603a0b270576766e5f3a3b26290a4fb753622587f5faa93e5ac3f6d956",
      "version": 1702127665,
      "size": 38793,
      "signed_at": "2018-08-24T20:43:52",
      "parent_hash": "0x40533a67315a6c01633f7bf8044291daaadcdfbc8b16e4c54313011613af698c",
      "height": 6207112,
      "transactions_root": null,
      "uncles_root": null,
      "state_root": null,
      "receipts_root": null,
      "uncles": [],
      "extra_data": "0x65746865726d696e652d657534",
      "miner": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
      "mining_cost": 3476235820253555,
      "seal": [],
      "gas_limit": 8000029,
      "gas_used": 7979963,
      "observed_mediantime": null,
      "observed_difficulty": null,
      "confirmations_at_insertion": null,
      "miner_label": "Ethermine"
    }
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

Get a specific transaction by hash.

HTTP request

GET https://api.covalenthq.com/v1/1/transaction/0xHASH/

Get event logs

>>> curl "https://api.covalenthq.com/v1/1/transaction/0x4959b4636961c4a17f55f99afbaab76435b228d481aec68b3aa12e96fbe130d4/logs/" 
{
  "data": {
    "items": [
      {
        "log_offset": 66,
        "raw_log_topics": [
          "0xfcfff16f00000000000000000000000000000000000000000000000000000000",
          "0x000000000000000000000000381c2293585ee86a9f104a4896a140a8c1030cc2",
          "0x0000000000000000000000000000000000000000000000000000000000000000",
          "0x0000000000000000000000000000000000000000000000000000000000000000"
        ],
        "raw_log_data": "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000004fcfff16f",
        "sender_address": "0x448a5065aebb8e423f0896e6c5d525c040f59af3"
      },
      {
        "log_offset": 67,
        "raw_log_topics": [
          "0x89b8893b806db50897c8e2362c71571cfaeb9761ee40727f683f1793cda9df16",
          "0x000000000000000000000000381c2293585ee86a9f104a4896a140a8c1030cc2"
        ],
        "raw_log_data": "0x0000000000000000000000000000000000000000000000000000000000000134",
        "sender_address": "0x448a5065aebb8e423f0896e6c5d525c040f59af3"
      }
    ]
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

Get event logs for a specific transaction.

HTTP request

GET https://api.covalenthq.com/v1/1/transaction/0xHASH/logs/

Addresses

The address endpoints support both lookups by hash as well as by ENS (Ethereum Name Service) names.

Get address (basic information)

>>> curl "https://api.covalenthq.com/v1/1/address/0xHASH/" 
{
  "data": {
    "transactions": {
      "items": [
        {
          "block_id": 1382611269627053800,
          "tx_offset": 93,
          "hash": "0xff1141d1ad1a09da498a978f04f34b52dfdd3273e464d0958817275e0f9b1d20",
          "successful": true,
          "version": 1702127665,
          "size": 84,
          "mining_cost": 30006,
          "from": "0x7284a8451d9a0e7dc62b3a71c0593ea2ec5c5638",
          "to": "0xf48d08818b558659d3bf1fb257e4937a0dc85d58",
          "creates": null,
          "value": "0",
          "payload_size": 36,
          "contract_input": null,
          "gas_offered": 45009,
          "gas_spent": 30006,
          "gas_price": 3000000000,
          "bitcoin_vins": null,
          "bitcoin_vouts": null,
          "block_signed_at": "2019-03-18T14:52:56",
          "block_height": 7393517,
          "to_label": null,
          "from_label": null
        },
        {...}
      ]
    },
    "contract_info": null,
    "address": "0x7284a8451d9a0e7dc62b3a71c0593ea2ec5c5638"
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

Returns transactions belonging to an address. To return all known information about an addresses like total transaction count, address first seen, contracts deployed, etc., use the stats endpoint.

If a contract is deployed at the address, an additional contract_info key is returned:

"contract_info": {
  "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  "contract_currency_name": "Wrapped Ether",
  "contract_currency_ticker_symbol": "WETH",
  "contract_currency_decimals": 18,
  "contract_introduced_at": "2017-12-12T11:17:35"
}

Get address statistics

>>> curl "https://api.covalenthq.com/v1/1/address/0xHASH/stats/<metric>/" 

Returns all known information about an address.

HTTP request

GET https://api.covalenthq.com/v1/1/address/0xHASH/stats/<metric>/

where the required parameter metric is one of:

metric
tx_count
tx_last_activity
tx_first_seen
contracts_deployed
inflow_wei
outflow_wei
gasspent_wei
balance_eth
contract_info

Query parameters

Parameter Default Description
quote-currency optional One of usd, cad, inr, eth, eur. If not specified, use usd.

Transaction count tx_count

>>> curl "https://api.covalenthq.com/v1/1/address/0xHASH/stats/tx_count/" 
{
  "data": {
    "tx_count": 531
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

Transaction last activity tx_last_activity

>>> curl "https://api.covalenthq.com/v1/1/address/0xHASH/stats/tx_count/" 
{
  "data": {
    "tx_last_activity": "2019-03-28T19:17:17"
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

First transaction seen tx_first_seen

>>> curl "https://api.covalenthq.com/v1/1/address/0xHASH/stats/tx_first_seen/" 
{
  "data": {
    "tx_first_seen": "2018-03-08T09:05:04"
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

Contracts deployed contracts_deployed

>>> curl "https://api.covalenthq.com/v1/1/address/0xHASH/stats/contracts_deployed/" 
{
  "data": {
    "contracts_deployed": 20
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

Eth Inflow in Wei inflow_wei

>>> curl "https://api.covalenthq.com/v1/1/address/0xHASH/stats/inflow_wei/" 
{
  "data": {
    "inflow_wei": "55500513573168000000"
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

Eth Outflow in Weioutflow_wei

>>> curl "https://api.covalenthq.com/v1/1/address/0xHASH/stats/outflow_wei/" 
{
  "data": {
    "outflow_wei": "226018815407984997501"
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

Gaspent in Wei gasspent_wei

>>> curl "https://api.covalenthq.com/v1/1/address/0xHASH/stats/gasspent_wei/" 
{
  "data": {
    "gasspent_wei": "393804317069591506.0"
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

Account Balance balance_eth

>>> curl "https://api.covalenthq.com/v1/1/address/0xHASH/stats/balance_eth/" 
{
  "data": {
    "balance_eth": "2349416542132501573",
    "quote_rate": "159.26154203702",
    "quote": "374.1717013873056"
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

Contract info if avaialblecontract_info

>>> curl "https://api.covalenthq.com/v1/1/address/0xHASH/stats/contract_info/" 
{
  "data": {
    "contract_info": {
      "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "contract_currency_name": "Wrapped Ether",
      "contract_currency_ticker_symbol": "WETH",
      "contract_currency_decimals": 18,
      "contract_introduced_at": "2017-12-12T11:17:35"
    }
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

Get address token balances

>>> curl "https://api.covalenthq.com/v1/1/address/0xHASH/balances/" 
{
  "data": {
    "balances": [
      {
        "contract_address": null,
        "balance": "2349416542132499968",
        "quote_rate": "159.26154203702",
        "quote": "374.17170138730535",
        "contract_name": null,
        "contract_ticker_symbol": "ETH",
        "contract_decimals": 18
      },
      {
        "contract_address": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359",
        "balance": "200405005017460015104",
        "quote_rate": "0.990828328985026",
        "quote": "198.5669562416857",
        "contract_name": "DAI",
        "contract_ticker_symbol": "DAI",
        "contract_decimals": 18
      },
      {...},
    ],
    "address": "0x7284a8451d9a0e7dc62b3a71c0593ea2ec5c5638"
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

HTTP request

GET https://api.covalenthq.com/v1/1/address/0xHASH/balances/?quote-currency=cad

Query parameters

Parameter Default Description
quote-currency optional One of usd, cad, inr, eth, eur. If not specified, use usd.

Get address transfers

>>> curl "https://api.covalenthq.com/v1/1/address/0xHASH/transfers/" 
{
  "data": {
    "transfers": {
      "erc20": [
        {
          "tx_hash": "0xd51e71e093135b28f38c24dbd3710af02a58021e6ffaed72aa4057dce01f6515",
          "block_signed_at": "2019-03-17T11:08:23",
          "block_height": 7386097,
          "address_from": "0xbc33a1f908612640f2849b56b67a4de4d179c151",
          "address_to": "0x7284a8451d9a0e7dc62b3a71c0593ea2ec5c5638",
          "value": 628502862143447000,
          "contract_address": "0xdd974d5c2e2928dea5f71b9825b8b646686bd200",
          "contract_name": null,
          "contract_ticker_symbol": null,
          "contract_decimals": null,
          "address_to_label": null,
          "address_from_label": null,
          "contract_address_label": "KyberNetwork",
          "transfer_type": "IN"
        },
        {...}
      ]
    },
    "address": "0x7284a8451d9a0e7dc62b3a71c0593ea2ec5c5638"
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

HTTP request

GET https://api.covalenthq.com/v1/1/address/0xHASH/transfers/

Get address stacks – MakerDAO

>>> curl "https://api.covalenthq.com/v1/1/address/0xHASH/stacks/makerdao/" 
{
  "data": {
    "makerdao": {
      "sum_ink": "221577.06181019504",
      "sum_art": "12273400.0",
      "count_cups": 1,
      "dai_quote_rate": "0.983693408067103",
      "sum_art_quote": "12073262.674570782",
      "ink_quote_rate": "179.96915565990184",
      "sum_ink_quote": "39877036.727582686",
      "breakdown_cup": [
        {
          "id": 5199,
          "ink": "221577.06181019504",
          "per": "1.0408845013394263",
          "art": "12273400",
          "sum_locked": "238958.79551649716",
          "sum_freed": "17381.73370630222",
          "sum_minted": "13775100.0",
          "sum_wiped": "1501700.0",
          "dai_quote_rate": "0.983693408067103",
          "art_quote": "12073262.674570782",
          "ink_quote_rate": "179.96915565990184",
          "ink_quote": "39877036.727582686",
          "count_acts": 214
        }
      ]
    },
    "address": "0x5e90bdc06e1af172ce97fa8a029d0587ece6a831"
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

Return user activity in the MakerDAO protocol.

Field Description
id ID of the CUP
ink Collateral in PETH
per Exchange rate of PETH to ETH
art Outstanding debt in DAI
sum_locked Volume of collateral locked
sum_freed Volume on collateral freed
sum_minted Volume of DAI minted
sum_wiped Volume of DAI wiped
dai_quote_rate Exchange rate of DAI in quote-currency
art_quote Quote of outstanding debt converted to quote-currency
ink_quote_rate Exchange rate of collateral in quote-currency
ink_quote Ouote of collateral converted to quote-currency
count_acts Total number of actions performed against this CUP

HTTP request

GET https://api.covalenthq.com/v1/1/address/0xHASH/stacks/makerdao/

Get address stacks – Compound Finance

>>> curl "https://api.covalenthq.com/v1/1/address/0xHASH/stacks/compoundfinance/" 
{
  "data": {
    "compoundfinance": {
      "account_liquidity": "1000572523915525",
      "sum_supply_balance": "1000572523915525.0",
      "sum_supply_balance_asset": [
        {
          "supply_balance": "1000572523915525",
          "borrow_balance": "0",
          "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
          "contract_name": "Wrapped Ether",
          "contract_ticker_symbol": "WETH",
          "contract_decimals": 18
        },
        {
          "supply_balance": "0",
          "borrow_balance": "0",
          "contract_address": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359",
          "contract_name": "Dai Stablecoin v1.0",
          "contract_ticker_symbol": "DAI",
          "contract_decimals": 18
        }
      ]
    },
    "address": "0x7284a8451d9a0e7dc62b3a71c0593ea2ec5c5638"
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

Return user activity in the Compound Finance protocol.

Field Description
supply_balance Supply balance
borrow_balance Borrow balance
contract_address Address of ERC20 token
contract_name Name of ERC20 token
contract_ticker_symbol Ticker symbol of ERC20 token
contract_decimals Decimals of ERC20 token

HTTP request

GET https://api.covalenthq.com/v1/1/address/0xHASH/stacks/compoundfinance/

Get address stacks – UniSwap

>>> curl "https://api.covalenthq.com/v1/1/address/0xHASH/stacks/uniswap/" 
{
  "data": {
    "uniswap": {
      "sum_pool_share_eth_quote": "403293.42387581285",
      "sum_pool_share_token_quote": "401829.6454741491",
      "pool_exchange": [
        {
            "contract_address": "0x8dd5fbce2f6a956c3022ba3663759011dd51e73e",
            "contract_decimals": 18,
            "contract_name": "TrueUSD",
            "contract_ticker_symbol": "TUSD",
            "eth_quote_rate": "166.69459545068",
            "exchange": "0x4F30E682D0541eAC91748bd38A648d759261b8f3",
            "pool_liquidity_token": "1615432946624674066697",
            "pool_liquidity_total_supply": "1706601949533051511590",
            "pool_share_eth": "1487539156149097988096",
            "pool_share_eth_quote": "247964.73785131978",
            "pool_share_percentage": 0.9465786366098302,
            "pool_share_token": "246465172542910478942208",
            "pool_share_token_quote": "248237.61236379898",
            "pool_total_eth_reserve": "1571490311123772197006",
            "pool_total_token_reserve": "260374746492932770606433",
            "token_quote_rate": "1.00719144130021"
        },
        {
            "contract_address": "0x3772f9716cf6d7a09ede3587738aa2af5577483a",
            "contract_address": 18,
            "contract_name": "Synthetix Network Token",
            "contract_ticker_symbol": "SNX",
            "eth_quote_rate": "166.69459545068",
            "exchange": "0x5d8888a212d033cff5F2e0AC24ad91A5495bAD62",
            "pool_liquidity_token": "555358711767179189745",
            "pool_liquidity_total_supply": "565358711905343825164",
            "pool_share_eth": "578962414766028029952",
            "pool_share_eth_quote": "96509.90551057184",
            "pool_share_percentage": 0.9823121145432373,
            "pool_share_token": "1338702205009926887047168",
            "pool_share_token_quote": "93599.96559325476",
            "pool_total_eth_reserve": "589387432155652673374",
            "pool_total_token_reserve": "1362807385952281029606437",
            "token_quote_rate": "0.0699184368584503"
        },
        {...}
      ]
    },
    "address": "0xf6b6f07862a02c85628b3a9688beae07fea9c863"
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

Return user activity in the UniSwap protocol.

Field Description
contract_address Address of ERC20 token
contract_name Name of ERC20 token
contract_ticker_symbol Ticker symbol of ERC20 token
contract_decimals Decimals of ERC20 token
eth_quote_rate Spot ETH price in quote-currency
exchange Exchange address
pool_liquidity_token Current liquidity tokens
pool_liquidity_total_supply Total liquidity tokens
pool_share_percentage Percentage of liqudity pool (pool_liquidity_token / pool_liquidity_total_supply)
pool_share_eth Share of ETH liquidity
pool_share_eth_quote Share of ETH liquidity in quote-currency
pool_share_token Share of token liquidity
pool_share_token_quote Share of token liquidity in quote-currency
pool_total_eth_reserve Total ETH in reserve
pool_total_token_reserve Total tokens in reserve
token_quote_rate Spot token price in quote-currency

HTTP request

GET https://api.covalenthq.com/v1/1/address/0xHASH/stacks/uniswap/

Get address flows

>>> curl "https://api.covalenthq.com/v1/1/address/0xHASH/flows/" 
{
  "data": {
    "outflows": [
      {
        "address_to": "0x3a306a399085f3460bbcb5b77015ab33806a10d5",
        "sum_eth": "27142180416757047876",
        "count": 65,
        "address_to_label": "InstaDApp"
      },
      {...}
    ],
    "inflows": [
      {
        "address_from": "0xb579d4f1546d51980499aa96a2e411be3e449197",
        "sum_eth": "31268337323000000000",
        "count": 12,
        "address_from_label": null
      },
      {...}
    ]
    "address": "0x7284a8451d9a0e7dc62b3a71c0593ea2ec5c5638"
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

HTTP request

GET https://api.covalenthq.com/v1/1/address/0xHASH/flows/

Protocol specific endpoints

Overview

Protocol Endpoint
UniSwap List all exchanges
UniSwap Get overall volumes and liquidity by date
UniSwap Get volumes and liquidity by exchange by date
UniSwap Get volumes and liquidity for specific exchange by date
UniSwap Get all liqudity providers for all exchanges by date
UniSwap Get liqudity providers for specific exchange by date
UniSwap Get liqudity providers for specific provider by date

UniSwap – List all exchanges

>>> curl "https://api.covalenthq.com/v1/1/uniswap/list_exchanges/" 
{
  "data": {
    "exchanges": [
      {
        "exchange": "0xaE76c84C9262Cdb9abc0C2c8888e62Db8E22A0bF",
        "token": "0xE41d2489571d322189246DaFA5ebDe1F4699F498",
        "introduced_at": "2018-11-02T05:51:30",
        "contract_address": "0xe41d2489571d322189246dafa5ebde1f4699f498",
        "contract_name": "0x Token",
        "contract_ticker_symbol": "ZRX",
        "contract_decimals": 18,
        "eth_quote_rate": 175.858063433864,
        "eth_reserve": "336229500307108356891",
        "eth_reserve_quote": 59128.66879334385,
        "eth_sold_volume": "1031202810857406811212",
        "eth_bought_volume": "1012113981645978417452",
        "eth_sold_volume_quote": 181345.3293249407,
        "eth_bought_volume_quote": 177988.40478659913
      },
      {...}
    ]
  }
}

HTTP request

GET https://api.covalenthq.com/v1/1/uniswap/list_exchanges/

UniSwap – Get overall volumes and liquidity by date

>>> curl "https://api.covalenthq.com/v1/1/uniswap/" 
{
  "data": {
    "uniswap": [
      {
        "date": "2018-11-02",
        "sum_eth_reserve": 434530900855721700,
        "sum_eth_sold_volume": 0,
        "sum_eth_bought_volume": 0,
        "eth_quote_rate": 199.1226070207313,
        "eth_reserve_quote": 86.52492580945824,
        "eth_sold_volume_quote": 0,
        "eth_bought_volume_quote": 0
      },
      {
        "date": "2018-11-03",
        "sum_eth_reserve": 434530900855721700,
        "sum_eth_sold_volume": 0,
        "sum_eth_bought_volume": 0,
        "eth_quote_rate": 202.28275716666218,
        "eth_reserve_quote": 87.89810869920892,
        "eth_sold_volume_quote": 0,
        "eth_bought_volume_quote": 0
      },
      {...}
    ]
  }
}

HTTP request

GET https://api.covalenthq.com/v1/1/uniswap/

UniSwap – Get volume and liquidity by exchange by date

>>> curl "https://api.covalenthq.com/v1/1/uniswap/exchange/" 
{
  "data": {
    "uniswap_exchanges": [
      {
        "exchange": "0x5d8888a212d033cff5F2e0AC24ad91A5495bAD62",
        "contract_address": "0x3772f9716cf6d7a09ede3587738aa2af5577483a",
        "contract_name": "Synthetix Network Token",
        "contract_ticker_symbol": "SNX",
        "contract_decimals": 18,
        "series": [
          {
            "date": "2019-02-28",
            "eth_reserve": "9258044984365826487",
            "eth_sold_volume": "0",
            "eth_bought_volume": "0",
            "eth_quote_rate": 134.84981713392082,
            "eth_reserve_quote": 1248.4456731593446,
            "eth_sold_volume_quote": 0,
            "eth_bought_volume_quote": 0
          },
          {
            "date": "2019-03-01",
            "eth_reserve": "9258044984365826487",
            "eth_sold_volume": "0",
            "eth_bought_volume": "0",
            "eth_quote_rate": 135.4906837644075,
            "eth_reserve_quote": 1254.378845253369,
            "eth_sold_volume_quote": 0,
            "eth_bought_volume_quote": 0
          },
          {...}
        ]
      },
      {...}
    ]
  }
}

HTTP request

GET https://api.covalenthq.com/v1/1/uniswap/exchange/

UniSwap – Get volume and liquidity for specific exchange by date

>>> curl "https://api.covalenthq.com/v1/1/uniswap/exchange/0x5d8888a212d033cff5F2e0AC24ad91A5495bAD62/" 
{
  "data": {
    "uniswap_exchanges": [
      {
        "exchange": "0x5d8888a212d033cff5F2e0AC24ad91A5495bAD62",
        "contract_address": "0x3772f9716cf6d7a09ede3587738aa2af5577483a",
        "contract_name": "Synthetix Network Token",
        "contract_ticker_symbol": "SNX",
        "contract_decimals": 18,
        "series": [
          {
            "date": "2019-02-28",
            "eth_reserve": "9258044984365826487",
            "eth_sold_volume": "0",
            "eth_bought_volume": "0",
            "eth_quote_rate": 134.84981713392082,
            "eth_reserve_quote": 1248.4456731593446,
            "eth_sold_volume_quote": 0,
            "eth_bought_volume_quote": 0
          },
          {
            "date": "2019-03-01",
            "eth_reserve": "9258044984365826487",
            "eth_sold_volume": "0",
            "eth_bought_volume": "0",
            "eth_quote_rate": 135.4906837644075,
            "eth_reserve_quote": 1254.378845253369,
            "eth_sold_volume_quote": 0,
            "eth_bought_volume_quote": 0
          },
          {...}
        ]
      }
    ]
  }
}

HTTP request

GET https://api.covalenthq.com/v1/1/uniswap/exchange/<exchange_address>/

UniSwap – Get liqudity providers for specific exchange by date

>>> curl "https://api.covalenthq.com/v1/1/uniswap/liquidity_exchange/0x09cabEC1eAd1c0Ba254B09efb3EE13841712bE14/" 
{
  "data": {
    "uniswap_liquidity_providers": [
      {
        "exchange": "0x60a87cc7fca7e53867facb79da73181b1bb4238b",
        "token": "0x419d0d8bdd9af5e606ae2232ed285aff190e711b",
        "contract_address": "0x419d0d8bdd9af5e606ae2232ed285aff190e711b",
        "contract_name": "FunFair",
        "contract_ticker_symbol": "FUN",
        "contract_decimals": 8,
        "series": [
          {
            "block_signed_at": "2018-11-10T23:28:21+00:00",
            "kind": "AddLiquidity",
            "provider": "0x78c9126309909f71f7e674c3376a9e34cbbbc949",
            "eth_amount": "5155000000000000000",
            "token_amount": "8796100000000",
            "eth_quote_rate": 210.79061959752252,
            "eth_amount_quote": 1086.6256440252287,
            "pool_total_eth_reserve": "5155000000000000000",
            "pool_total_token_reserve": "8796100000000",
            "liquidity_balance": "5155000000000000000",
            "liquidity_supply": "5155000000000000000"
          },
          {
            "block_signed_at": "2018-11-12T03:38:00+00:00",
            "kind": "AddLiquidity",
            "provider": "0x11e4857bb9993a50c685a79afad4e6f65d518dda",
            "eth_amount": "58600000000000",
            "token_amount": "99988307",
            "eth_quote_rate": 212.4733247441558,
            "eth_amount_quote": 0.01245093683000753,
            "pool_total_eth_reserve": "5155117382532226056",
            "pool_total_token_reserve": "8796099988307",
            "liquidity_balance": "58599331791055",
            "liquidity_supply": "5155058599331791055"
          },
          {...}
        ]
      },
      {...}
    ]
  }
}

HTTP request

GET https://api.covalenthq.com/v1/1/uniswap/liquidity_exchange/<exchange_address>/

UniSwap – Get liqudity providers for specific provider by date

>>> curl "https://api.covalenthq.com/v1/1/uniswap/liquidity_provider/0xf369af914dbed0ad7afdddebc631ee0fda1b4891/" 
{
  "data": {
    "uniswap_liquidity_providers": [
      {
        "exchange": "0x09cabec1ead1c0ba254b09efb3ee13841712be14",
        "token": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359",
        "contract_address": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359",
        "contract_name": "Dai Stablecoin v1.0",
        "contract_ticker_symbol": "DAI",
        "contract_decimals": 18,
        "series": [
          {
            "block_signed_at": "2018-11-02T10:27:36+00:00",
            "kind": "AddLiquidity",
            "provider": "0xf369af914dbed0ad7afdddebc631ee0fda1b4891",
            "eth_amount": "30000000000000000000",
            "token_amount": "5900000000000000000000",
            "eth_quote_rate": 199.1226070207313,
            "eth_amount_quote": 5973.678210621939
          },
          {
            "block_signed_at": "2018-11-02T10:27:36+00:00",
            "kind": "AddLiquidity",
            "provider": "0xf369af914dbed0ad7afdddebc631ee0fda1b4891",
            "eth_amount": "30000000000000000000",
            "token_amount": "5900000000000000000000",
            "eth_quote_rate": 199.1226070207313,
            "eth_amount_quote": 5973.678210621939
          },
          {...}
        ]
      },
      {...}
    ]
  }
}

HTTP request

GET https://api.covalenthq.com/v1/1/uniswap/liquidity_provider/<provider_address>/

Leaderboard

Get all precomputed leaderboards

>>> curl "https://api.covalenthq.com/v1/1/leaderboard/" 
{
  "data": {
    "top_five_smart_contracts_by_tx": [
      {
        "contract_address_label": "Poloniex_1",
        "contract_address": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
        "tx_count": 23562
      },
      {
        "contract_address_label": "Poloniex_2",
        "contract_address": "0x209c4784ab1e8183cf58ca33cb740efbf3fc18ef",
        "tx_count": 10544
      },
      {
        "contract_address_label": "EtherDelta_2",
        "contract_address": "0x8d12a197cb00d4747a1fe03395095ce2a5cc6819",
        "tx_count": 10324
      },
      {
        "contract_address_label": null,
        "contract_address": "0x1158c3c9a70e85d8358972810ed984c8e6ffcf0f",
        "tx_count": 6995
      },
      {
        "contract_address_label": null,
        "contract_address": "0x37a9679c41e99db270bda88de8ff50c0cd23f326",
        "tx_count": 5929
      }
    ],
    "top_five_miners": [
      {
        "miners_address_label": "Ethermine",
        "miners_address": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
        "blocks_mined": 990907
      },
      {
        "miners_address_label": "DwarfPool_1",
        "miners_address": "0x2a65aca4d5fc5b5c859090a6c34d164135398226",
        "blocks_mined": 889265
      },
      {
        "miners_address_label": "Nanopool",
        "miners_address": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5",
        "blocks_mined": 658923
      },
      {
        "miners_address_label": "F2Pool",
        "miners_address": "0x61c808d82a3ac53231750dadc13c777b59310bd9",
        "blocks_mined": 481983
      },
      {
        "miners_address_label": "F2Pool",
        "miners_address": "0x829bd824b016326a401d083b33d092293333a830",
        "blocks_mined": 473925
      }
    ],
    "top_five_tokens_by_holders": [
      {
        "contract_currency_address": "0x37a9679c41e99db270bda88de8ff50c0cd23f326",
        "contract_currency_name": null,
        "contract_currency_ticker_symbol": null,
        "contract_currency_decimals": null,
        "holders": 317946
      },
      {
        "contract_currency_address": "0x86fa049857e0209aa7d9e616f7eb3b3b78ecfdb0",
        "contract_currency_name": null,
        "contract_currency_ticker_symbol": null,
        "contract_currency_decimals": null,
        "holders": 224214
      },
      {
        "contract_currency_address": "0xedbaf3c5100302dcdda53269322f3730b1f0416d",
        "contract_currency_name": null,
        "contract_currency_ticker_symbol": null,
        "contract_currency_decimals": null,
        "holders": 175485
      },
      {
        "contract_currency_address": "0x3495ffcee09012ab7d827abf3e3b3ae428a38443",
        "contract_currency_name": null,
        "contract_currency_ticker_symbol": null,
        "contract_currency_decimals": null,
        "holders": 152529
      },
      {
        "contract_currency_address": "0xb8c77482e45f1f44de1745f52c74426c631bdd52",
        "contract_currency_name": null,
        "contract_currency_ticker_symbol": null,
        "contract_currency_decimals": null,
        "holders": 143418
      }
    ],
    "top_five_addresses_by_balance": [
      {
        "address": "0x60db23e0d2ad2ee08c9de593f15b599042d3ee41",
        "balance": "2998994739082501942876",
        "address_label": null
      },
      {
        "address": "0xc2e9d9bc7afa7d4d4aab73fba07e3902a1ff84fd",
        "balance": "2996993899082501942876",
        "address_label": null
      },
      {
        "address": "0xd932e8c2349e945483ff7b1e7415bc22f3b9bc48",
        "balance": "1001000000000000000000",
        "address_label": null
      },
      {
        "address": "0xf595942283066a0f3e937d249b8cb1757183382e",
        "balance": "1001000000000000000000",
        "address_label": null
      },
      {
        "address": "0xbadecadb8fac4dce45bf36c2500558c62843763d",
        "balance": "1001000000000000000000",
        "address_label": null
      },
      {
        "address": "0x3c820eb9879cb363e823a2b73d8ec4b53e009b3e",
        "balance": "1001000000000000000000",
        "address_label": null
      },
      {
        "address": "0x92cb848ef862d7e0c02e14fefa5f00751a74ec91",
        "balance": "1001000000000000000000",
        "address_label": null
      },
      {
        "address": "0x8f07af4bc8a8ef19ef2c90d3e1ebeab7c48a38da",
        "balance": "1001000000000000000000",
        "address_label": null
      },
      {
        "address": "0xd9d496aaf93d6870d93aa40e4ee54fdd2223e1f1",
        "balance": "1001000000000000000000",
        "address_label": null
      },
      {
        "address": "0x22ca98fb98f171bce67f496cd7b5fb781d36c034",
        "balance": "1001000000000000000000",
        "address_label": null
      }
    ]
  },
  "error": false,
  "error_message": null,
  "error_code": null
}

This endpoint returns all the precomputed leaderboards.

HTTP request

GET https://api.covalenthq.com/v1/1/leaderboard/

Cryptotoken Logos API

We provide a free cryptocurrency logos API for use within your applications. To use it, you simply have to specify the token address (in lowercase) as a path to the Logos API.

Token Name Token Address Image
DAI 0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359
Kyber Network Crystal 0xdd974d5c2e2928dea5f71b9825b8b646686bd200
Bloom 0x107c4504cd79c5d2696ea0030a8dd4e92601b82e
Livepeer Token 0x58b6a8a3302369daec383334672404ee733ab239
Maker 0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2
Wrapped Ether 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2

HTTP request

GET https://logos.covalenthq.com/tokens/<token_address>.png

Errors

The Covalent API uses the following error codes:

Error Code Meaning
400 Bad Request -- Your request is invalid.
401 Unauthorized -- Your API key is wrong.
403 Forbidden -- The information requested is hidden for administrators only.
404 Not Found -- The specified information could not be found.
500 Internal Server Error -- We had a problem with our server. Try again later.
503 Service Unavailable -- We're temporarily offline for maintenance. Please try again later.