--- title: "GET /v1/{chainName}/bulk/transactions/{walletAddress}/{timeBucket}/" method: GET path: "/v1/{chainName}/bulk/transactions/{walletAddress}/{timeBucket}/" tags: ["get-time-bucket-transactions-for-address-v3"] --- # GET /v1/{chainName}/bulk/transactions/{walletAddress}/{timeBucket}/ `GET /v1/{chainName}/bulk/transactions/{walletAddress}/{timeBucket}/` ## Request - Base URL: `https://api.covalenthq.com` - URL: `https://api.covalenthq.com/v1/{chainName}/bulk/transactions/{walletAddress}/{timeBucket}/` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Fetches all transactions, including their decoded log events, in a 15-minute time bucket interval. ## Path parameters - `chainName` string, required - `walletAddress` string, required - `timeBucket` integer, required ## Query parameters - `quote-currency` string - `no-logs` boolean - `with-classification` boolean ## Response `200` Successful response - object - `address` string: The requested address. - `updated_at` string, date-time: The timestamp when the response was generated. Useful to show data staleness to users. - `quote_currency` string: The requested quote currency eg: `USD`. - `chain_id` integer: The requested chain ID eg: `1`. - `chain_name` string: The requested chain name eg: `eth-mainnet`. - `chain_tip_height` integer: The latest block height of the blockchain at the time this response was provided. - `chain_tip_signed_at` string, date-time: The timestamp of the latest signed block at the time this response was provided. - `complete` boolean - `current_bucket` integer: The current bucket of the response. - `links` object - `prev` string: URL link to the next page. - `next` string: URL link to the previous page. - `items` object[]: List of response items. - `block_signed_at` string, date-time: The block signed timestamp in UTC. - `block_height` integer: The height of the block. - `block_hash` string: The hash of the block. Use it to remove transactions from re-org-ed blocks. - `tx_hash` string: The requested transaction hash. - `tx_offset` integer: The offset is the position of the tx in the block. - `successful` boolean: Indicates whether a transaction failed or succeeded. - `from_address` string: The sender's wallet address. - `miner_address` string: The address of the miner. - `to_address` string: The receiver's wallet address. - `value` string: b;The value attached to this tx. - `value_quote` number, double: The value attached in `quote-currency` to this tx. - `pretty_value_quote` string: A prettier version of the quote for rendering purposes. - `gas_metadata` object: The requested chain native gas token metadata. - `contract_decimals` integer: Use contract decimals to format the token balance for display purposes - divide the balance by `10^{contract_decimals}`. - `contract_name` string: The string returned by the `name()` method. - `contract_ticker_symbol` string: The ticker symbol for this contract. This field is set by a developer and non-unique across a network. - `contract_address` string: Use the relevant `contract_address` to lookup prices, logos, token transfers, etc. - `supports_erc` string[]: A list of supported standard ERC interfaces, eg: `ERC20` and `ERC721`. - `logo_url` string: The contract logo URL. - `gas_offered` integer - `gas_spent` integer: The gas spent for this tx. - `gas_price` integer: The gas price at the time of this tx. - `fees_paid` string: b;The total transaction fees (`gas_price` * `gas_spent`) paid for this tx, denoted in wei. - `gas_quote` number, double: The gas spent in `quote-currency` denomination. - `pretty_gas_quote` string: A prettier version of the quote for rendering purposes. - `gas_quote_rate` number, double: The native gas exchange rate for the requested `quote-currency`. - `explorers` object[]: The explorer links for this transaction. - `label` string: The name of the explorer. - `url` string: The URL of the explorer. - `log_events` object[]: The log events. - `block_signed_at` string, date-time: The block signed timestamp in UTC. - `block_height` integer: The height of the block. - `tx_offset` integer: The offset is the position of the tx in the block. - `log_offset` integer: The offset is the position of the log entry within an event log. - `tx_hash` string: The requested transaction hash. - `raw_log_topics` string[]: The log topics in raw data. - `sender_contract_decimals` integer: Use contract decimals to format the token balance for display purposes - divide the balance by `10^{contract_decimals}`. - `sender_name` string: The name of the sender. - `sender_contract_ticker_symbol` string - `sender_address` string: The address of the sender. - `sender_logo_url` string: The contract logo URL. - `supports_erc` string[]: A list of supported standard ERC interfaces, eg: `ERC20` and `ERC721`. - `sender_factory_address` string: The address of the deployed UniswapV2 like factory contract for this DEX. - `raw_log_data` string: The log events in raw. - `decoded` object: The decoded item. - `name` string - `signature` string - `params` object[] - `name` string - `type` string - `indexed` boolean - `decoded` boolean - `value` string - `internal_transfers` object[]: List of internal transfers/transactions associated with the wallet address. - `from_address` string: The contract address sending the native token. - `to_address` string: The internal transfer recipient wallet address. - `value` string: b;The value of the internal transfer in wei. - `gas_limit` integer: The gas available from the parent transaction or contract call. - `classification` object: A human-readable classification of the transaction. Only present when `with-classification=true`. - `version` integer: The version of the classification engine. - `type` string: The transaction type eg: `swap`, `send_token`, `receive_token` or `add_liquidity`. Returns `unclassified` when no type applies. - `category` string: The category the transaction type belongs to eg: `defi`, `nft`, `transfer` or `lending`. - `description` string: A plain-English summary of the transaction for display eg: `Swapped 872.59 AERO for 0.279091760280112109 WETH.`. Use `type` for programmatic logic. - `account_address` string: The address the transaction was classified for: the requested wallet address, or the transaction's `from_address` on endpoints without one. `sent` and `received` are relative to this address. - `account_abstraction` object: ERC-4337 account abstraction details. Only present when the transaction executes a user operation, in which case `type` describes the action inside it. - `standard` string: The account abstraction standard eg: `erc-4337`. - `entry_point` string: The EntryPoint contract address. - `bundler` string: The bundler that submitted the transaction. Same as the transaction's `from_address`. - `sender` string: The smart account that sent the user operation. - `paymaster` string: The paymaster that sponsored the user operation. Not present for self-funded operations. - `sent` object[]: Assets sent by `account_address`, including gas fees. - `action` string: The kind of transfer eg: `paid_gas`, `token_sent` or `token_received`. - `from` object: The sender. - `address` string: The wallet or contract address. - `to` object: The recipient, with the same fields as `from`. Not present for gas fees. - `amount` string: The amount transferred, adjusted for the token's decimals eg: `872.590000000000000000`. - `token` object: The token transferred, with the same fields as `gas_metadata`. For the chain's native token, `contract_address` is the ticker symbol eg: `ETH`. - `received` object[]: Assets received by `account_address`, with the same fields as `sent`. ## Changes - **2026-10-22** `31713d2c30bc`: 2 info - added the new optional `query` request parameter `with-classification` - added the optional property `items/items/classification` to the response with the `200` status [Operation history](https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis/changes/v1/:chainName/bulk/transactions/:walletAddress/:timeBucket/get.md) --- [API](https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis.md) - [All operations](https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis/revisions/31713d2c30bc?raw)