# Nansen Transaction with Token Transfer Lookup

> Nansen Transaction with Token Transfer Lookup is a paid API for AI agents from api.nansen.ai, paid per call via MPP or x402, $0.01/call, status unknown (last checked 2026-09-15).

Retrieves comprehensive on-chain transaction data including token transfers and NFT transfers for a given transaction hash

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/transaction-with-token-transfer-lookup
- Price: $0.01/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-nansen-ai-09eb695e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UNmVYlU8xjqXxrjN7ro9J

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 api-nansen-ai-09eb695e
```

Example prompt: Can you pull the full token transfer details for transaction 0x4a3b...c9d2 on Ethereum — I need to see every token and NFT that changed hands, the sender/receiver wallets, and the amounts involved.

## When to prefer this

Use this endpoint when you need complete token and NFT transfer breakdowns for a specific on-chain transaction, especially when Nansen's smart money wallet labels and entity data are needed alongside raw transfer data. Prefer over generic blockchain explorers when you want enriched entity/label context.

## Known failure modes

- Invalid or malformed transaction hash returns 400 error
- Transaction hash not found on specified chain returns 404
- Unsupported blockchain network returns validation error
- Rate limiting or quota exceeded returns 429
- Network connectivity issues return 500 series errors

## How this service works

Get Transaction with Token Transfer Lookup Data

## Output

Returns comprehensive transaction information including all token transfers (ERC-20, ERC-721, ERC-1155), involved wallet addresses, token contract details, amounts, and NFT transfer metadata for the specified transaction hash.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "TransactionLookupRequest",
 "required": [
  "chain",
  "transaction_hash",
  "block_timestamp"
 ],
 "properties": {
  "chain": {
   "enum": [
    "arbitrum",
    "avalanche",
    "base",
    "bitcoin",
    "bnb",
    "ethereum",
    "hyperevm",
    "injective",
    "iotaevm",
    "linea",
    "mantle",
    "mantra",
    "monad",
    "near",
    "optimism",
    "plasma",
    "ronin",
    "scroll",
    "sei",
    "sonic",
    "starknet",
    "sui",
    "ton",
    "tron"
   ],
   "type": "string",
   "title": "TransactionLookupChain",
   "description": "Blockchain chain for the transaction lookup."
  },
  "block_timestamp": {
   "type": "string",
   "title": "Block Timestamp",
   "examples": [
    "2025-08-06 01:47:11"
   ],
   "description": "Timestamp of the transaction"
  },
  "transaction_hash": {
   "type": "string",
   "title": "Transaction Hash",
   "examples": [
    "0xf16f93cb53f4f977d45b1b08af7b66e1939d0fe69d669012458239b23797e492"
   ],
   "description": "Transaction hash to lookup"
  }
 },
 "description": "",
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "TransactionLookupListResponse",
 "required": [
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "TransactionLookupResponse",
    "required": [
     "chain",
     "transaction_hash",
     "from_address",
     "from_address_label",
     "to_address",
     "to_address_label",
     "native_value",
     "dated_native_price",
     "dated_native_value_usd",
     "current_native_price",
     "current_native_value_usd",
     "receipt_status",
     "block_timestamp",
     "token_transfer_array",
     "nft_transfer_array"
    ],
    "properties": {
     "chain": {
      "type": "string",
      "title": "Chain",
      "description": "The blockchain network of the transaction"
     },
     "to_address": {
      "type": "string",
      "title": "To Address",
      "description": "The hexadecimal address of the recipient"
     },
     "from_address": {
      "type": "string",
      "title": "From Address",
      "description": "The hexadecimal address of the sender"
     },
     "native_value": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Native Value",
      "description": "The amount of native cryptocurrency transferred"
     },
     "receipt_status": {
      "anyOf": [
       {
        "type": "integer"
       }
      ],
      "title": "Receipt Status",
      "description": "The status of the transaction receipt (1 for success, 0 for failure)"
     },
     "block_timestamp": {
      "type": "string",
      "title": "Block Timestamp",
      "description": "The timestamp of the block in which the transaction was included"
     },
     "to_address_label": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "To Address Label",
      "description": "The name or label associated with the recipient's address"
     },
     "transaction_hash": {
      "type": "string",
      "title": "Transaction Hash",
      "description": "The unique identifier of the transaction"
     },
     "dated_native_price": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Dated Native Price",
      "description": "The price of the native cryptocurrency at the time of the transaction"
     },
     "from_address_label": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "From Address Label",
      "description": "The name or label associated with the sender's addr
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-nansen-ai-09eb695e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.nansen.ai](https://www.zero.xyz/host/api.nansen.ai/llms.txt)