# Animica Address History

> Animica Address History is a paid API for AI agents from animica.dev, paid per call via x402, $0.002164/call, status unknown (last checked 2026-09-15).

Retrieves paginated on-chain transaction history for a given ANM blockchain address, with filtering by direction, height range, and cursor-based pagination.

## Facts

- Endpoint: POST https://animica.dev/x402/chain/address-history
- Price: $0.002164/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/animica-address-history-2128bd74
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Lu71f-4YfSGw8r4xrCSQK

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 animica-address-history-2128bd74 -d '<json body>'
```

Example prompt: Show me the last 50 incoming transactions for the Animica address anim1abc123…, starting from block 10000, newest first.

## When to prefer this

Choose this endpoint when you need to retrieve on-chain transaction history for a specific Animica (ANM) blockchain address, especially when you need filtering by direction (in/out/self), block height ranges, or paginated access to large histories. It is the canonical source for ANM account activity and is better than generic blockchain explorers when working natively within the Animica ecosystem.

## Known failure modes

- Invalid address format (not anim1… bech32m or 32-byte hex) returns error
- Cursor mismatch if index snapshot changed between pages
- from_height greater than to_height returns empty or error
- limit out of range (0 or >500) returns validation error
- Address with no transactions returns empty transactions array
- Network or payment failure returns HTTP 402 or 5xx

## How this service works

Full transaction history for one Animica account (anim1… bech32m), served from the gateway's own head-following index with a stable cursor — up to 500 rows per call, amounts in nANM as decimal strings. The free per-block and per-tx APIs stay free; single-address lookups on explorer.animica.org stay free too (they scan at most 250 blocks per call).

## Output

A JSON object containing a transactions array (each entry has height, tx_index, tx_hash, direction, counterparty, value, tip, gas, kind, block_hash, and timestamp with amounts in nANM decimal strings), plus index metadata (as_of_height, head_height, lag_blocks), total count, has_more flag, next_cursor for pagination, a derivation block documenting rules, and payment metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "rows per page, 1..500 (default 100)"
  },
  "order": {
   "type": "string",
   "description": "desc (newest first, default) | asc"
  },
  "cursor": {
   "type": "string",
   "description": "\"<as_of>:<height>:<tx_index>\" from a previous response's next_cursor; pages the same index snapshot"
  },
  "address": {
   "type": "string",
   "description": "anim1… bech32m address (or a 32-byte hex account digest)"
  },
  "direction": {
   "type": "string",
   "description": "any (default) | in | out | self"
  },
  "to_height": {
   "type": "integer",
   "description": "inclusive upper height bound (default: the index tip)"
  },
  "from_height": {
   "type": "integer",
   "description": "inclusive lower height bound (default 0 = genesis)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/animica-address-history-2128bd74/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from animica.dev](https://www.zero.xyz/host/animica.dev/llms.txt)