Logo
Covalent API Documentation

getTimeBucketTransactionsForAddress

GET https://api.covalenthq.com/v1/:chainName/bulk/transactions/:walletAddress/:timeBucket/?quote-currency=&no-logs=&with-safe=

Returns: TransactionsTimeBucketResponse

{
  "address" : "{{STRING}}",
  "updated_at" : "{{DATETIME}}",
  "next_update_at" : "{{DATETIME}}",
  "quote_currency" : "{{STRING}}",
  "chain_id" : "{{INTEGER}}",
  "chain_name" : "{{STRING}}",
  "complete" : "{{BOOLEAN}}",
  "current_bucket" : "{{INTEGER}}",
  "links" : {
    "prev" : "{{STRING}}",
    "next" : "{{STRING}}"
  },
  "items" : [ {
    "block_signed_at" : "{{DATETIME}}",
    "block_height" : "{{INTEGER}}",
    "block_hash" : "{{STRING}}",
    "tx_hash" : "{{STRING}}",
    "tx_offset" : "{{INTEGER}}",
    "successful" : "{{BOOLEAN}}",
    "from_address" : "{{STRING}}",
    "miner_address" : "{{STRING}}",
    "from_address_label" : "{{STRING}}",
    "to_address" : "{{STRING}}",
    "to_address_label" : "{{STRING}}",
    "value" : "{{STRING}}",
    "value_quote" : "{{DOUBLE}}",
    "pretty_value_quote" : "{{STRING}}",
    "gas_metadata" : {
      "contract_decimals" : "{{INTEGER}}",
      "contract_name" : "{{STRING}}",
      "contract_ticker_symbol" : "{{STRING}}",
      "contract_address" : "{{STRING}}",
      "supports_erc" : [ "{{STRING}}" ],
      "logo_url" : "{{STRING}}"
    },
    "gas_offered" : "{{STRING}}",
    "gas_spent" : "{{STRING}}",
    "gas_price" : "{{STRING}}",
    "fees_paid" : "{{STRING}}",
    "gas_quote" : "{{DOUBLE}}",
    "pretty_gas_quote" : "{{STRING}}",
    "gas_quote_rate" : "{{DOUBLE}}",
    "explorers" : [ {
      "label" : "{{STRING}}",
      "url" : "{{STRING}}"
    } ],
    "dex_details" : [ {
      "log_offset" : "{{INTEGER}}",
      "protocol_name" : "{{STRING}}",
      "protocol_address" : "{{STRING}}",
      "protocol_logo_url" : "{{STRING}}",
      "aggregator_name" : "{{STRING}}",
      "aggregator_address" : "{{STRING}}",
      "version" : "{{INTEGER}}",
      "fork_version" : "{{INTEGER}}",
      "fork" : "{{STRING}}",
      "event" : "{{STRING}}",
      "pair_address" : "{{STRING}}",
      "pair_lp_fee_bps" : "{{DOUBLE}}",
      "lp_token_address" : "{{STRING}}",
      "lp_token_ticker" : "{{STRING}}",
      "lp_token_num_decimals" : "{{INTEGER}}",
      "lp_token_name" : "{{STRING}}",
      "lp_token_value" : "{{DOUBLE}}",
      "exchange_rate_usd" : "{{DOUBLE}}",
      "token_0_address" : "{{STRING}}",
      "token_0_ticker" : "{{STRING}}",
      "token_0_num_decimals" : "{{INTEGER}}",
      "token_0_name" : "{{STRING}}",
      "token_1_address" : "{{STRING}}",
      "token_1_ticker" : "{{STRING}}",
      "token_1_num_decimals" : "{{INTEGER}}",
      "token_1_name" : "{{STRING}}",
      "token_0_amount" : "{{DOUBLE}}",
      "token_0_quote_rate" : "{{DOUBLE}}",
      "token_0_usd_quote" : "{{DOUBLE}}",
      "pretty_token_0_usd_quote" : "{{STRING}}",
      "token_0_logo_url" : "{{STRING}}",
      "token_1_amount" : "{{DOUBLE}}",
      "token_1_quote_rate" : "{{DOUBLE}}",
      "token_1_usd_quote" : "{{DOUBLE}}",
      "pretty_token_1_usd_quote" : "{{STRING}}",
      "token_1_logo_url" : "{{STRING}}",
      "sender" : "{{STRING}}",
      "recipient" : "{{STRING}}"
    } ],
    "nft_sale_details" : [ {
      "log_offset" : "{{INTEGER}}",
      "topic0" : "{{STRING}}",
      "protocol_contract_address" : "{{STRING}}",
      "protocol_name" : "{{STRING}}",
      "protocol_logo_url" : "{{STRING}}",
      "to" : "{{STRING}}",
      "from" : "{{STRING}}",
      "maker" : "{{STRING}}",
      "taker" : "{{STRING}}",
      "token_id" : "{{DOUBLE}}",
      "collection_address" : "{{STRING}}",
      "collection_name" : "{{STRING}}",
      "token_address" : "{{STRING}}",
      "token_name" : "{{STRING}}",
      "ticker_symbol" : "{{STRING}}",
      "num_decimals" : "{{INTEGER}}",
      "contract_quote_rate" : "{{DOUBLE}}",
      "nft_token_price" : "{{DOUBLE}}",
      "nft_token_price_usd" : "{{DOUBLE}}",
      "pretty_nft_token_price_usd" : "{{STRING}}",
      "nft_token_price_native" : "{{DOUBLE}}",
      "pretty_nft_token_price_native" : "{{STRING}}",
      "token_count" : "{{INTEGER}}",
      "num_token_ids_sold_per_sale" : "{{INTEGER}}",
      "num_token_ids_sold_per_tx" : "{{INTEGER}}",
      "num_collections_sold_per_sale" : "{{INTEGER}}",
      "num_collections_sold_per_tx" : "{{INTEGER}}",
      "trade_type" : "{{STRING}}",
      "trade_group_type" : "{{STRING}}"
    } ],
    "lending_details" : [ {
      "log_offset" : "{{INTEGER}}",
      "protocol_name" : "{{STRING}}",
      "protocol_address" : "{{STRING}}",
      "protocol_logo_url" : "{{STRING}}",
      "version" : "{{STRING}}",
      "fork" : "{{STRING}}",
      "fork_version" : "{{STRING}}",
      "event" : "{{STRING}}",
      "lp_token_name" : "{{STRING}}",
      "lp_decimals" : "{{INTEGER}}",
      "lp_ticker_symbol" : "{{STRING}}",
      "lp_token_address" : "{{STRING}}",
      "lp_token_amount" : "{{DOUBLE}}",
      "lp_token_price" : "{{DOUBLE}}",
      "exchange_rate" : "{{DOUBLE}}",
      "exchange_rate_usd" : "{{DOUBLE}}",
      "token_name_in" : "{{STRING}}",
      "token_decimal_in" : "{{INTEGER}}",
      "token_address_in" : "{{STRING}}",
      "token_ticker_in" : "{{STRING}}",
      "token_logo_in" : "{{STRING}}",
      "token_amount_in" : "{{DOUBLE}}",
      "amount_in_usd" : "{{DOUBLE}}",
      "pretty_amount_in_usd" : "{{STRING}}",
      "token_name_out" : "{{STRING}}",
      "token_decimals_out" : "{{INTEGER}}",
      "token_address_out" : "{{STRING}}",
      "token_ticker_out" : "{{STRING}}",
      "token_logo_out" : "{{STRING}}",
      "token_amount_out" : "{{DOUBLE}}",
      "amount_out_usd" : "{{DOUBLE}}",
      "pretty_amount_out_usd" : "{{STRING}}",
      "borrow_rate_mode" : "{{DOUBLE}}",
      "borrow_rate" : "{{DOUBLE}}",
      "on_behalf_of" : "{{STRING}}",
      "liquidator" : "{{STRING}}",
      "user" : "{{STRING}}"
    } ],
    "log_events" : [ {
      "block_signed_at" : "{{DATETIME}}",
      "block_height" : "{{INTEGER}}",
      "tx_offset" : "{{INTEGER}}",
      "log_offset" : "{{INTEGER}}",
      "tx_hash" : "{{STRING}}",
      "raw_log_topics" : [ "{{STRING}}" ],
      "sender_contract_decimals" : "{{INTEGER}}",
      "sender_name" : "{{
Curl
curl -X GET 'https://api.covalenthq.com/v1/:chainName/bulk/transactions/:walletAddress/:timeBucket/?quote-currency=&no-logs=&with-safe=?quote-currency=&no-logs=&with-safe=' -H 'Content-Type: application/json'

ENDPOINTS