> For the complete documentation index, see [llms.txt](https://docs.dapplooker.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapplooker.com/products/api-endpoints/wallet-intelligence/wallet-transactions.md). # Wallet Transactions #### **Endpoint** **GET** `https://api.dapplooker.com/v1/wallet-transactions/{address}` #### **Authentication** | Method | Description | | ------------------------- | ----------------------------------------------------------------------------------------------------------------- | | **API Key** | Provide your DappLooker API key using the `api_key` query parameter for authenticated access. | | **x402 Payment Protocol** | If `api_key` is not provided, the request automatically uses the x402 protocol for on-chain payment verification. | #### **Path Parameters** | Parameter | Type | Mandatory | Description | | --------- | ------ | --------- | ------------------------------------- | | `address` | string | Yes | EVM (`0x…`) or Solana wallet address. | #### **Query Parameters** | Parameter name | Type | Mandatory | Description | | ---------------------------------- | ------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `api_key` | string | Yes | Your unique DappLooker API key used for authentication. Optional if querying via x402 | | `currency` | string | No | Currency for price and value fields. Default: `usd`. | | `filter[operation_types]` | string | No | Comma-separated transaction types to include. Values: `trade`, `send`, `receive`, `deposit`, `withdraw`, `approve`, `claim`, `mint`, `burn`, `delegate`, `revoke`, `revoke_delegation`, `deploy`, `execute`, `bid`. | | `filter[chain_ids]` | string | No | Comma-separated chain IDs to filter. | | `filter[fungible_ids]` | string | No | Filter to transactions involving specific token IDs. | | `filter[fungible_implementations]` | string | No | Filter by specific token contract implementations (chain + address pairs). Format: `ethereum:0x…,base:0x…`. | | `filter[min_mined_at]` | string | No | Start of date range as Unix timestamp in milliseconds. Returns transactions mined at or after this time. | | `filter[max_mined_at]` | string | No | End of date range as Unix timestamp in milliseconds. Returns transactions mined at or before this time. | | `filter[trash]` | string | No | Spam filter. Values: `only_non_trash` (recommended), `only_trash`, `no_filter` (default). | | `filter[search_query]` | string | No | Full-text search across transaction metadata. Min 2 chars, max 64 chars. | | `page[after]` | string | No | Pagination cursor. Use the full URL from `links.next` in the previous response. | | `page[size]` | integer | No | Results per page. Default and max: `100`. | #### **Example Request** bash ```bash # Full transaction history, no spam curl --location 'https://api.dapplooker.com/v1/wallet-transactions/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990?api_key=&filter[trash]=only_non_trash' # DeFi activity only (swaps, deposits, withdrawals, claims) curl --location 'https://api.dapplooker.com/v1/wallet-transactions/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990?api_key=&filter[operation_types]=trade,deposit,withdraw,claim' # Date-range filter (January 2025) curl --location 'https://api.dapplooker.com/v1/wallet-transactions/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990?api_key=&filter[min_mined_at]=1735689600000&filter[max_mined_at]=1738368000000' # Solana wallet curl --location 'https://api.dapplooker.com/v1/wallet-transactions/8BH9pjtgyZDC4iAQH5ZiYDZ1MDWC98xki2V8NzqqKW3K?api_key=' ``` #### **Example Response** json ```json { "success": true, "data": [ { "id": "52d994a173d755e99845e861d534a419", "address": "0x42b9df65b219b3dd36ff330a4dd8f327a6ada990", "operation_type": "trade", "hash": "0x109d8622084d562263230ba5de412b5cd7c372019131e2c9d0a8aa4925eb6034", "chain_id": "ethereum", "mined_at_block": 15345739, "mined_at": "2024-08-15T11:26:31+00:00", "sent_from": "0x42b9df65b219b3dd36ff330a4dd8f327a6ada990", "sent_to": "0x794a61358d6845594f94dc1db02a252b5b4814ad", "status": "confirmed", "nonce": 3757, "fee": { "fungible_info": { "name": "Ethereum", "symbol": "ETH", "icon": { "url": "https://icons.dapplooker.com/tokens/eth.png" } }, "quantity": { "int": "15700000000000000", "decimals": 18, "float": 0.0157, "numeric": "0.0157" }, "price": 2542.23, "value": 39.97 }, "transfers": [ { "direction": "out", "sender": "0x42b9df65b219b3dd36ff330a4dd8f327a6ada990", "recipient": "0x794a61358d6845594f94dc1db02a252b5b4814ad", "act_id": "act_001", "fungible_info": { "name": "USD Coin", "symbol": "USDC", "icon": { "url": "https://icons.dapplooker.com/tokens/usdc.png" }, "verified": true }, "quantity": { "int": "500000000", "decimals": 6, "float": 500.00, "numeric": "500.00" }, "value": 500.00, "price": 1.00 }, { "direction": "in", "sender": "0x794a61358d6845594f94dc1db02a252b5b4814ad", "recipient": "0x42b9df65b219b3dd36ff330a4dd8f327a6ada990", "act_id": "act_002", "fungible_info": { "name": "Ethereum", "symbol": "ETH", "icon": { "url": "https://icons.dapplooker.com/tokens/eth.png" }, "verified": true }, "quantity": { "int": "196500000000000000", "decimals": 18, "float": 0.1965, "numeric": "0.1965" }, "value": 499.52, "price": 2542.23 } ], "approvals": [], "acts": [ { "id": "act_001", "type": "swap_exact_input" } ], "refund": null, "application_metadata": { "name": "Uniswap", "icon": { "url": "https://icons.dapplooker.com/protocols/uniswap.png" }, "contract_address": "0x794a61358d6845594f94dc1db02a252b5b4814ad", "method": "exactInputSingle" }, "flags": { "is_trash": false } } ], "links": { "next": "https://api.dapplooker.com/v1/wallet-transactions/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990?page[after]=eyJsYXN0SWQiOiI1MmQ5OTRhMSJ9" } } ``` #### **Response Fields Explanation** * `id` *(string)*: Unique transaction identifier. * `address` *(string)*: The wallet address this transaction belongs to. * `operation_type` *(string)*: Human-readable label for the transaction type. Values: `trade`, `send`, `receive`, `deposit`, `withdraw`, `approve`, `claim`, `mint`, `burn`, `delegate`, `revoke`, `revoke_delegation`, `deploy`, `execute`, `bid`. * `hash` *(string)*: On-chain transaction hash. * `chain_id` *(string)*: Blockchain where the transaction was executed. * `mined_at_block` *(integer)*: Block number where the transaction was confirmed. * `mined_at` *(string)*: ISO 8601 timestamp of when the transaction was confirmed. * `sent_from` *(string)*: Sender address — may be a wallet or smart contract. * `sent_to` *(string)*: Recipient address — may be a wallet or smart contract. * `status` *(string)*: Transaction status. Values: `confirmed`, `failed`, `pending`. * `nonce` *(integer)*: Transaction nonce. * `fee` *(object)*: Gas cost paid for this transaction. * `fungible_info` *(object)*: Gas token metadata — name, symbol, `icon.url`. * `quantity.int` *(string)*: Raw gas amount in base units. * `quantity.decimals` *(integer)*: Decimal precision. * `quantity.float` *(float)*: Display-ready gas amount. * `quantity.numeric` *(string)*: Gas amount as a string. * `price` *(float)*: Gas token price at the time the transaction was mined. * `value` *(float)*: Fee cost in the selected currency. * `transfers` *(array)*: Individual asset movements within the transaction. Each item includes: * `direction` *(string)*: Movement direction relative to the queried wallet. Values: `in` (received), `out` (sent), `self`. * `sender` *(string)*: Address that sent the asset in this transfer. * `recipient` *(string)*: Address that received the asset in this transfer. * `act_id` *(string | null)*: Reference to the associated act in the `acts` array. Links transfers to the specific contract action that caused them. * `fungible_info` *(object | null)*: Token name, symbol, `icon.url`, and verification status. Null for non-fungible transfers. * `quantity.int` *(string)*: Raw amount in base units. * `quantity.decimals` *(integer)*: Decimal precision. * `quantity.float` *(float)*: Display-ready token amount. * `quantity.numeric` *(string)*: Token amount as a string. * `value` *(float)*: Transfer value in the selected currency. * `price` *(float)*: Historical token price at the time the transaction was mined. * `approvals` *(array)*: Token approval events within this transaction (ERC-20 `approve` calls). Each item includes the approved spender, token info, and approved amount. * `acts` *(array)*: High-level contract actions executed in this transaction. Each act has an `id` (referenced by `transfers[].act_id`) and a `type` describing the on-chain function called. * `refund` *(object | null)*: Gas refund details if a refund was issued. Null if no refund occurred. * `application_metadata` *(object | null)*: DeFi protocol context for this transaction. * `name` *(string)*: Protocol display name. * `icon.url` *(string)*: Protocol logo URL. * `contract_address` *(string)*: Protocol contract address. * `method` *(string | null)*: Contract function called (e.g. `exactInputSingle`, `deposit`). Null if not resolvable. * `flags.is_trash` *(boolean)*: Whether this transaction is classified as spam. * `links.next` *(string | null)*: Full URL for the next page of results. Null when on the last page.