# Nansen Transaction With Token Transfer Lookup

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

Retrieves comprehensive details for a specific blockchain transaction, including native crypto movements, token transfers, NFT transfers, and USD valuations.

## Facts

- Endpoint: POST https://api.nansen.ai/api/v1/transaction-with-token-transfer-lookup?utm_source=zero.xyz
- Price: $0.01/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Provider: Nansen
- Docs: https://docs.nansen.ai
- Website: https://nansen.ai
- Tags: blockchain, smart-money, wallet, tokens, defi, analytics, profiler, dex, pnl, onchain, prediction-market, data
- Canonical page: https://www.zero.xyz/c/nansen-transaction-with-token-transfer-lookup-623d0bb5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_H-a7rM2DOwHj0JN9Ss4Mo

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 nansen-transaction-with-token-transfer-lookup-623d0bb5 -d '<json body>'
```

Example prompt: Can you pull up all the details for Ethereum transaction 0xf16f93cb53f4f977d45b1b08af7b66e1939d0fe69d669012458239b23797e492 — I want to see the token transfers, NFT transfers, USD values, and who sent it?

## When to prefer this

Use this endpoint when you need a complete, enriched view of a single transaction including all token and NFT transfer sub-events with USD pricing — especially when address labels (smart money tags) and historical USD valuations matter. Prefer this over generic RPC calls when you need Nansen's proprietary wallet labeling, multi-chain support, and NFT transfer decomposition in one call.

## Known failure modes

- Invalid or non-existent transaction hash returns empty data array
- Non-EVM chains (bitcoin, tron, ton, starknet, sui) require block_timestamp — omitting it causes an error
- Unsupported chain enum value returns validation error
- Transaction hash on wrong chain returns no results
- Network or rate-limit errors return HTTP 4xx/5xx

## How this service works

Get comprehensive transaction information including token transfers and NFT transfers.
        This endpoint provides detailed information about a specific transaction including
        native cryptocurrency movements, token transfers, and NFT transfers with USD values.

## Output

Returns an array of transaction records each containing: sender and recipient addresses with human-readable labels, native cryptocurrency amount and its USD value (both at transaction time and current), transaction receipt status (success/failure), block timestamp, an array of all ERC-20/token transfers with amounts and USD values, and an array of all NFT transfers involved in the transaction.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "TransactionLookupRequest",
 "required": [
  "chain",
  "transaction_hash"
 ],
 "properties": {
  "chain": {
   "enum": [
    "all",
    "arbitrum",
    "arc",
    "avalanche",
    "base",
    "bitcoin",
    "bnb",
    "ethereum",
    "hyperevm",
    "injective",
    "iotaevm",
    "linea",
    "mantle",
    "mantra",
    "monad",
    "near",
    "optimism",
    "plasma",
    "robinhood",
    "sei",
    "sonic",
    "starknet",
    "sui",
    "ton",
    "tron"
   ],
   "type": "string",
   "title": "TransactionLookupChain",
   "description": "Blockchain chain for the transaction lookup."
  },
  "block_timestamp": {
   "anyOf": [
    {
     "type": "string"
    }
   ],
   "title": "Block Timestamp",
   "examples": [
    "2025-08-06 01:47:11"
   ],
   "description": "Timestamp of the transaction block (format: 'YYYY-MM-DD HH:MM:SS'). Optional for most EVM chains — resolved automatically when omitted. Required for non-EVM chains (bitcoin, tron, ton, starknet, sui)."
  },
  "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/nansen-transaction-with-token-transfer-lookup-623d0bb5/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)