--- updatedAt: 2025-10-16T15:28:37.000Z agentTools: projectIndex: https://api-ascn-ai.readme.io/llms.txt --- # Get Address Transactions Returns a list of address transactions sorted from newest to oldest. Important: by default, only transactions that involved tokens are returned. You can change this behavior by changing the “with_transfer_only” parameter. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "Wallets API docs", "summary": "This document contains a description of all essential request and response schemes.", "version": "1.1.1", "x-logo": { "url": "https://s3.arbitragescanner.io/logo.png" } }, "paths": { "/v1/address_transactions/": { "get": { "tags": [ "Address-analysis" ], "summary": "Get Address Transactions", "description": "Returns a list of address transactions sorted from newest to oldest. Important: by default, only transactions that involved tokens are returned. You can change this behavior by changing the “with_transfer_only” parameter.", "operationId": "get_address_transactions_v1_address_transactions__get", "parameters": [ { "name": "chain", "in": "query", "required": true, "schema": { "$ref": "#/components/schemas/AllowedChainsEnum" } }, { "name": "address", "in": "query", "required": true, "schema": { "type": "string", "description": "EVM-compatible address", "title": "Address" }, "description": "EVM-compatible address", "example": "0x461A5b8326ba0e2dfd133651a3b559dc8d3b0400" }, { "name": "volume_usd__gte", "in": "query", "required": false, "schema": { "type": "number", "description": "filter for selecting transactions, the volume in USD of which exceeds or equals the specified value", "examples": [ 5000 ], "title": "Volume Usd Gte" }, "description": "filter for selecting transactions, the volume in USD of which exceeds or equals the specified value" }, { "name": "timestamp__gte", "in": "query", "required": false, "schema": { "type": "string", "format": "date-time", "description": "filter for selecting transactions executed on or after the specified time", "title": "Timestamp Gte" }, "description": "filter for selecting transactions executed on or after the specified time" }, { "name": "timestamp__lte", "in": "query", "required": false, "schema": { "type": "string", "format": "date-time", "description": "filter for selecting transactions executed on or before the specified time", "title": "Timestamp Lte" }, "description": "filter for selecting transactions executed on or before the specified time" }, { "name": "transaction_type", "in": "query", "required": false, "schema": { "type": "array", "items": { "$ref": "#/components/schemas/TransactionTypeEnum" }, "description": "filter for selecting transactions of a specific type or multiple types", "title": "Transaction Type" }, "description": "filter for selecting transactions of a specific type or multiple types", "example": [ "swap" ] }, { "name": "exchange_name", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "filter for selecting transactions executed on a particular dex platforms", "title": "Exchange Name" }, "description": "filter for selecting transactions executed on a particular dex platforms", "example": [ "uniswap" ] }, { "name": "with_transfer_only", "in": "query", "required": false, "schema": { "type": "boolean", "description": "filter for selecting transactions in which the token balance has changed", "default": true, "title": "With Transfer Only" }, "description": "filter for selecting transactions in which the token balance has changed" }, { "name": "transaction_tokens", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "filter for selecting transactions in which the specified token or tokens participated", "title": "Transaction Tokens" }, "description": "filter for selecting transactions in which the specified token or tokens participated" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1000, "default": 20, "title": "Limit" } }, { "name": "skip", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Skip" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AddressTransactionsResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } } }, "components": { "schemas": { "AddressCategoryEnum": { "type": "string", "enum": [ "cex", "dex", "token" ], "title": "AddressCategoryEnum" }, "AddressTransactionsResponse": { "properties": { "transactions": { "$ref": "#/components/schemas/TransactionsPaginated" } }, "type": "object", "required": [ "transactions" ], "title": "AddressTransactionsResponse", "example": { "transactions": { "meta": { "count": 89, "has_next_page": true, "limit": 50, "skip": 0 }, "rows": [ { "direction": "out", "exchange_slug": "uniswap", "fee": 0.003110222511399276, "fee_usd": 9.592517167432533, "from_address": "0x461a5b8326ba0e2dfd133651a3b559dc8d3b0400", "from_address_type": "wallet", "timestamp": "2024-04-16T22:23:23Z", "to_address": "0x3fc91a3afd70395cd496c647d5a6cc9d4b2b7fad", "to_address_category": "dex", "to_address_label": "uniswap", "to_address_logo": "uniswap", "to_address_type": "contract", "tokens_in": [ { "amount_usd": 19965.930791107145, "contract_address": "0xaaee1a9723aadb7afa2810263653a34ba2c21c7a", "name": "Mog Coin", "price": 4.858454182738464e-7, "quantity": 41095233257.6148, "symbol": "Mog", "token_id": "27659" } ], "tokens_out": [ { "amount_usd": 18014.24605441031, "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "name": "Wrapped Ether", "price": 3084.19, "quantity": 5.840835374737065, "symbol": "WETH", "token_id": "2396" }, { "amount_usd": 2001.5828949344789, "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "name": "Wrapped Ether", "price": 3084.19, "quantity": 0.6489817083041184, "symbol": "WETH", "token_id": "2396" } ], "transaction_hash": "0xbe636c09d8db2064521f60f6c39e01ff6ddd2b9eb756228c00ce1d1d3fb2ada9", "transaction_type": "swap", "volume_usd": 20015.82894934479 }, { "direction": "out", "exchange_slug": "uniswap", "fee": 0.002562143937502296, "fee_usd": 7.912028586203966, "from_address": "0xd267fda7ecbe322e64bf807de06e8e2284b72da9", "from_address_label": "seawise: resolver", "from_address_logo": "seawise", "from_address_type": "wallet", "timestamp": "2024-04-16T22:20:59Z", "to_address": "0xd1742b3c4fbb096990c8950fa635aec75b30781a", "to_address_category": "dex", "to_address_label": "uniswap", "to_address_logo": "uniswap", "to_address_type": "contract", "tokens_in": [ { "amount_usd": 7250.853783961539, "contract_address": "0xaaee1a9723aadb7afa2810263653a34ba2c21c7a", "name": "Mog Coin", "price": 4.81080580872262e-7, "quantity": 15072015109.848734, "symbol": "Mog", "token_id": "27659" } ], "tokens_out": [ { "amount_usd": 7266.6500051521725, "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "name": "Wrapped Ether", "price": 3088.05, "quantity": 2.353151666958816, "symbol": "WETH", "token_id": "2396" } ], "transaction_hash": "0x5b7ab4cc74ec58ee35a6ce0079415d42c37314e5be519604088a0df559852be5", "transaction_type": "swap", "volume_usd": 7266.6500051521725 } ] } } }, "AddressTypeEnum": { "type": "string", "enum": [ "contract", "wallet" ], "title": "AddressTypeEnum" }, "AllowedChainsEnum": { "type": "string", "enum": [ "ethereum", "polygon", "arbitrum", "optimism", "base", "bsc" ], "title": "AllowedChainsEnum" }, "DirectionEnum": { "type": "string", "enum": [ "in", "out" ], "title": "DirectionEnum" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "PaginationMeta": { "properties": { "count": { "type": "integer", "title": "Count", "default": 0 }, "skip": { "type": "integer", "title": "Skip", "default": 0 }, "limit": { "type": "integer", "title": "Limit", "default": 0 }, "has_next_page": { "type": "boolean", "title": "Has Next Page", "default": false } }, "type": "object", "title": "PaginationMeta" }, "Transaction": { "properties": { "transaction_hash": { "type": "string", "title": "Transaction Hash" }, "timestamp": { "type": "string", "format": "date-time", "title": "Timestamp" }, "transaction_type": { "$ref": "#/components/schemas/TransactionTypeEnum" }, "fee": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Fee" }, "fee_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Fee Usd" }, "to_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To Address" }, "to_address_type": { "anyOf": [ { "$ref": "#/components/schemas/AddressTypeEnum" }, { "type": "null" } ] }, "to_address_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To Address Label" }, "to_address_category": { "anyOf": [ { "$ref": "#/components/schemas/AddressCategoryEnum" }, { "type": "null" } ] }, "to_address_logo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To Address Logo" }, "from_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From Address" }, "from_address_type": { "anyOf": [ { "$ref": "#/components/schemas/AddressTypeEnum" }, { "type": "null" } ] }, "from_address_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From Address Label" }, "from_address_category": { "anyOf": [ { "$ref": "#/components/schemas/AddressCategoryEnum" }, { "type": "null" } ] }, "from_address_logo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From Address Logo" }, "direction": { "anyOf": [ { "$ref": "#/components/schemas/DirectionEnum" }, { "type": "null" } ] }, "tokens_in": { "anyOf": [ { "items": { "$ref": "#/components/schemas/TransactionTokenData" }, "type": "array" }, { "type": "null" } ], "title": "Tokens In", "default": [] }, "tokens_out": { "anyOf": [ { "items": { "$ref": "#/components/schemas/TransactionTokenData" }, "type": "array" }, { "type": "null" } ], "title": "Tokens Out", "default": [] }, "exchange_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Exchange Slug" }, "volume_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Volume Usd" } }, "type": "object", "required": [ "transaction_hash", "timestamp", "transaction_type", "fee", "fee_usd", "to_address", "to_address_type", "to_address_label", "to_address_category", "to_address_logo", "from_address", "from_address_type", "from_address_label", "from_address_category", "from_address_logo", "direction", "exchange_slug" ], "title": "Transaction" }, "TransactionTokenData": { "properties": { "contract_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Contract Address" }, "symbol": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Symbol" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "quantity": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Quantity" }, "price": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Price" }, "amount_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Amount Usd" }, "token_id": { "anyOf": [ { "type": "integer" }, { "type": "string" }, { "type": "null" } ], "title": "Token Id", "readOnly": true } }, "type": "object", "required": [ "token_id" ], "title": "TransactionTokenData" }, "TransactionTypeEnum": { "type": "string", "enum": [ "swap", "send", "receive", "deposit", "withdraw", "approve", "execute", "burn", "mint", "bridge", "other" ], "title": "TransactionTypeEnum" }, "TransactionsPaginated": { "properties": { "rows": { "items": { "$ref": "#/components/schemas/Transaction" }, "type": "array", "title": "Rows" }, "meta": { "$ref": "#/components/schemas/PaginationMeta" } }, "type": "object", "required": [ "rows", "meta" ], "title": "TransactionsPaginated" }, "ValidationError": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" } }, "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "name": "X-API-Key", "in": "header" } } }, "tags": [ { "name": "Address-analysis", "description": "Various address research operations in the blockchain." } ], "servers": [ { "url": "https://b2b.api.arbitragescanner.io/api/wallets/" } ], "security": [ { "ApiKeyAuth": [] } ] } ```