> ## Documentation Index > Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # Earliest Wallet Transactions API > Fetches the earliest transactions involving an address. Frequently seen in wallet applications. > [card] Credit Cost > > 0.1 per item > [card] Processing > > Realtime > [!TIP] > > Estimate your monthly cost for this API using the [Pricing Calculator](https://goldrush.dev/docs/pricing-calculator.md?endpoint=%2Fapi-reference%2Ffoundational-api%2Ftransactions%2Fget-earliest-transactions-for-address-v3). > [!NOTE] > > Returns the same results as the first timebucket for an address in the [Get recent transactions](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3.md) endpoint. > > Requests that return status `200` and no data cost `0.1` credits. > > Calls with `no-logs` cost `0.05` credits/item. > > Internal transactions are included in the response by using `with-internal` and cost `0.05` credits/item. > [!NOTE] > > `with-internal` is supported on select EVM chains only. See [Traces Support](https://goldrush.dev/docs/resources/traces-support.md) for the current list of supported chains. > [accordion] Related guides > > > [card] > > > > Introducing Transactions V3 APIs > > > > [Open](https://goldrush.dev/guides/introducing-transactions-v3-apis) > > > [card] > > > > Comparing GoldRush's Transactions API to RPC Providers > > > > [Open](https://goldrush.dev/guides/comparing-covalent-s-transactions-api-to-rpc-providers) > > > [card] > > > > How to Get Transaction History for an Address on Ethereum > > > > [Open](https://goldrush.dev/guides/how-to-get-transaction-history-for-an-address-on-ethereum) ## OpenAPI ````yaml GET /v1/{chainName}/bulk/transactions/{walletAddress}/ openapi: 3.1.0 info: title: GoldRush Multichain Data APIs version: 1.0.0 description: Covalent's GoldRush Multichain Data APIs OpenAPI Schema. servers: - url: https://api.covalenthq.com security: - bearerAuth: [] paths: /v1/{chainName}/bulk/transactions/{walletAddress}/: get: tags: - get-earliest-transactions-for-address-v3 description: >- Fetches the earliest transactions involving an address. Frequently seen in wallet applications. operationId: getEarliestTimeBucketTransactionsForAddress parameters: - name: chainName in: path description: 'The chain name eg: `eth-mainnet`.' required: true schema: type: string - name: walletAddress in: path description: >- The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. required: true schema: type: string - name: quote-currency in: query description: >- The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. required: false schema: type: string - name: no-logs in: query description: Omit log events. required: false schema: type: boolean - name: with-internal in: query description: Whether to include internal transfers/transactions. required: false schema: type: boolean - name: with-classification in: query description: >- Whether to include a human-readable classification of each transaction, such as a swap or a token transfer. Supported on the same chains as `with-internal`. Costs an extra `0.05` credits/item. required: false schema: type: boolean responses: '200': description: Successful response content: application/json: schema: type: object properties: address: type: string description: The requested address. updated_at: type: string format: date-time description: >- The timestamp when the response was generated. Useful to show data staleness to users. quote_currency: type: string description: 'The requested quote currency eg: `USD`.' chain_id: type: integer description: 'The requested chain ID eg: `1`.' chain_name: type: string description: 'The requested chain name eg: `eth-mainnet`.' chain_tip_height: type: integer description: >- The latest block height of the blockchain at the time this response was provided. chain_tip_signed_at: type: string format: date-time description: >- The timestamp of the latest signed block at the time this response was provided. complete: type: boolean current_bucket: type: integer description: The current bucket of the response. links: type: object properties: prev: type: string description: URL link to the next page. next: type: string description: URL link to the previous page. items: type: array items: type: object properties: block_signed_at: type: string format: date-time description: The block signed timestamp in UTC. block_height: type: integer description: The height of the block. block_hash: type: string description: >- The hash of the block. Use it to remove transactions from re-org-ed blocks. tx_hash: type: string description: The requested transaction hash. tx_offset: type: integer description: The offset is the position of the tx in the block. successful: type: boolean description: Indicates whether a transaction failed or succeeded. from_address: type: string description: The sender's wallet address. miner_address: type: string description: The address of the miner. to_address: type: string description: The receiver's wallet address. value: type: string description: b;The value attached to this tx. value_quote: type: number format: double description: The value attached in `quote-currency` to this tx. pretty_value_quote: type: string description: >- A prettier version of the quote for rendering purposes. gas_metadata: type: object properties: contract_decimals: type: integer description: >- Use contract decimals to format the token balance for display purposes - divide the balance by `10^{contract_decimals}`. contract_name: type: string description: The string returned by the `name()` method. contract_ticker_symbol: type: string description: >- The ticker symbol for this contract. This field is set by a developer and non-unique across a network. contract_address: type: string description: >- Use the relevant `contract_address` to lookup prices, logos, token transfers, etc. supports_erc: type: array items: type: string description: >- A list of supported standard ERC interfaces, eg: `ERC20` and `ERC721`. logo_url: type: string description: The contract logo URL. description: The requested chain native gas token metadata. gas_offered: type: integer format: int64 gas_spent: type: integer format: int64 description: The gas spent for this tx. gas_price: type: integer format: int64 description: The gas price at the time of this tx. fees_paid: type: string description: >- b;The total transaction fees (`gas_price` * `gas_spent`) paid for this tx, denoted in wei. gas_quote: type: number format: double description: The gas spent in `quote-currency` denomination. pretty_gas_quote: type: string description: >- A prettier version of the quote for rendering purposes. gas_quote_rate: type: number format: double description: >- The native gas exchange rate for the requested `quote-currency`. explorers: type: array items: type: object properties: label: type: string description: The name of the explorer. url: type: string description: The URL of the explorer. description: The explorer links for this transaction. log_events: type: array items: type: object properties: block_signed_at: type: string format: date-time description: The block signed timestamp in UTC. block_height: type: integer format: int64 description: The height of the block. tx_offset: type: integer format: int64 description: >- The offset is the position of the tx in the block. log_offset: type: integer format: int64 description: >- The offset is the position of the log entry within an event log. tx_hash: type: string description: The requested transaction hash. raw_log_topics: type: array items: type: string description: The log topics in raw data. sender_contract_decimals: type: integer description: >- Use contract decimals to format the token balance for display purposes - divide the balance by `10^{contract_decimals}`. sender_name: type: string description: The name of the sender. sender_contract_ticker_symbol: type: string sender_address: type: string description: The address of the sender. sender_logo_url: type: string description: The contract logo URL. supports_erc: type: array items: type: string description: >- A list of supported standard ERC interfaces, eg: `ERC20` and `ERC721`. sender_factory_address: type: string description: >- The address of the deployed UniswapV2 like factory contract for this DEX. raw_log_data: type: string description: The log events in raw. decoded: type: object properties: name: type: string signature: type: string params: type: array items: type: object properties: name: type: string type: type: string indexed: type: boolean decoded: type: boolean value: type: string description: The decoded item. description: The log events. internal_transfers: type: array items: type: object properties: from_address: type: string description: The contract address sending the native token. to_address: type: string description: >- The internal transfer recipient wallet address. value: type: string description: b;The value of the internal transfer in wei. gas_limit: type: integer format: int64 description: >- The gas available from the parent transaction or contract call. description: >- List of internal transfers/transactions associated with the wallet address. classification: type: object properties: version: type: integer description: The version of the classification engine. type: type: string description: >- The transaction type eg: `swap`, `send_token`, `receive_token` or `add_liquidity`. Returns `unclassified` when no type applies. category: type: string description: >- The category the transaction type belongs to eg: `defi`, `nft`, `transfer` or `lending`. description: type: string description: >- 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: type: string description: >- 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: type: object properties: standard: type: string description: >- The account abstraction standard eg: `erc-4337`. entry_point: type: string description: The EntryPoint contract address. bundler: type: string description: >- The bundler that submitted the transaction. Same as the transaction's `from_address`. sender: type: string description: >- The smart account that sent the user operation. paymaster: type: string description: >- The paymaster that sponsored the user operation. Not present for self-funded operations. description: >- ERC-4337 account abstraction details. Only present when the transaction executes a user operation, in which case `type` describes the action inside it. sent: type: array items: type: object properties: action: type: string description: >- The kind of transfer eg: `paid_gas`, `token_sent` or `token_received`. from: type: object properties: address: type: string description: The wallet or contract address. description: The sender. to: type: object properties: {} description: >- The recipient, with the same fields as `from`. Not present for gas fees. amount: type: string description: >- The amount transferred, adjusted for the token's decimals eg: `872.590000000000000000`. token: type: object properties: {} description: >- The token transferred, with the same fields as `gas_metadata`. For the chain's native token, `contract_address` is the ticker symbol eg: `ETH`. description: >- Assets sent by `account_address`, including gas fees. received: type: array items: type: object properties: {} description: >- Assets received by `account_address`, with the same fields as `sent`. description: >- A human-readable classification of the transaction. Only present when `with-classification=true`. description: List of response items. x-codeSamples: [] components: securitySchemes: bearerAuth: type: http scheme: bearer description: >- Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.