# Ethereum Address Transaction History (via Etherscan V2)

> Ethereum Address Transaction History (via Etherscan V2) is a paid API for AI agents from 2s.io, paid per call via x402, $0.0036/call, status unknown (last checked 2026-09-14).

Returns paginated normal transaction history for an Ethereum (or EVM chain) address, newest-first, with hashes, block info, timestamps, from/to, ETH value, gas data, decoded method names, and error flags.

## Facts

- Endpoint: GET https://2s.io/api/crypto/address-history
- Price: $0.0036/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ethereum-address-transaction-history-via-etherscan-v2-1960d65e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2pn6xZXw6UtiHqDp0hamG

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ethereum-address-transaction-history-via-etherscan-v2-1960d65e
```

Example prompt: Pull the last 25 transactions for Ethereum address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on mainnet (chainId 1), page 1, sorted newest-first — I want to see the hashes, ETH values, gas used, and decoded function names.

## When to prefer this

Use this endpoint when you need the full transaction history for a wallet address — including decoded method names, gas details, and error flags — rather than a single transaction receipt. Prefer over a single-hash lookup (crypto.tx) when you need to audit activity, paginate through many txs, or filter by block range. Also useful for EVM chains beyond mainnet when upstream Etherscan V2 coverage exists.

## Known failure modes

- Invalid or malformed Ethereum address returns an error or empty result
- Upstream Etherscan V2 outage or rate limit causes failure
- chainId not covered by upstream multichain support returns an error
- page/offset out of range returns empty result set
- startBlock greater than endBlock returns empty or error
- Address with no transactions returns an empty list

## How this service works

Transaction history for an Ethereum address (via Etherscan V2). Returns normal transactions newest-first: hash, block, timestamp, from/to, value (wei + ETH), gas used, gas price, decoded method id + function name, error flag, and any contract created. Paginate with page + offset; bound with startBlock/endBlock. Defaults to Ethereum mainnet; other EVM chains are reachable by chainId where upstream coverage allows. Net-new vs crypto.tx (single-hash receipt).

## Output

A paginated list of normal transactions for the given address, each including transaction hash, block number, Unix timestamp, from/to addresses, value in wei and ETH, gas limit, gas used, gas price, decoded method ID and function name, error flag (empty string if success), and any contract address created. Results default to descending (newest-first) order.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "page": {
       "type": "integer",
       "minimum": 1
      },
      "sort": {
       "enum": [
        "asc",
        "desc"
       ],
       "type": "string"
      },
      "offset": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1
      },
      "address": {
       "type": "string"
      },
      "chainId": {
       "type": "integer",
       "default": 1,
       "minimum": 1,
       "description": "EVM chain id; defaults to 1 (Ethereum). Other chains (8453 Base, 137 Polygon, 42161 Arbitrum…) require upstream multichain coverage."
      },
      "endBlock": {
       "type": "integer",
       "minimum": 0
      },
      "startBlock": {
       "type": "integer",
       "minimum": 0
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ethereum-address-transaction-history-via-etherscan-v2-1960d65e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)