---
title: "List NFT transfers involving one or more wallets"
method: POST
path: "/?ankr_getNftTransfers"
tags: ["NFT API"]
---

# List NFT transfers involving one or more wallets

`POST /?ankr_getNftTransfers`

## Request

- Base URL: `https://rpc.ankr.com/multichain/569ca1f392f7d3d0bb1073a1173ecb649af1d9249231fe59fa95db19d5ae41fe`
- URL: `https://rpc.ankr.com/multichain/569ca1f392f7d3d0bb1073a1173ecb649af1d9249231fe59fa95db19d5ae41fe/?ankr_getNftTransfers`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ankr/apis/ankr-advanced-api/docs/%3Fankr_getNftTransfers/post.ts> (a function with typed inputs; its response is checked against the schema)

Returns the on-chain history of NFT transfers in which the specified wallet(s) appear as sender or recipient. Each entry carries the contract, token ID, collection name, image URL, block height, and timestamp.

Pass an `address` array (single or multiple wallets). Optionally scope by `blockchain`, block range (`fromBlock` / `toBlock`), or wall-clock range (`fromTimestamp` / `toTimestamp`). Paginate with `pageSize` (default `100`, max `10000`) and `pageToken`.

Part of the **NFT API** product (700 compute units per call, $0.00007 at base rate).

## Request body

- object
  - `id` integer, required: Client-supplied request ID echoed in the response.
  - `jsonrpc` '2.0', required
  - `method` 'ankr_getNftTransfers', required
  - `params` object, required
    - `address` string[]: Wallet address(es) to query. ENS accepted on Ethereum.
    - `blockchain` string[]: Chains to query. Omit or pass an empty array to query all supported chains.
    - `fromBlock` union: Start block (integer or `earliest`, or hex).
      - integer
      - string
    - `toBlock` union: End block (integer or `latest`, or hex).
      - integer
      - string
    - `fromTimestamp` integer: UNIX timestamp lower bound.
    - `toTimestamp` integer: UNIX timestamp upper bound.
    - `descOrder` boolean: Sort newest first when `true`.
    - `pageSize` integer: Entries per page. Default `100`, max `10000`.
    - `pageToken` string: Opaque page token from a prior response's `nextPageToken`.

## Response `200`

Success. JSON-RPC `result` envelope contains the `transfers` array and pagination cursor. JSON-RPC errors are returned with HTTP 200 — check for an `error` key in the response body.

- object
  - `id` integer, required
  - `jsonrpc` '2.0', required
  - `result` object, required
    - `nextPageToken` string: Cursor for the next page.
    - `transfers` object[], nullable, required: NFT transfers for the wallets in the query.
      - `blockHeight` integer, required
      - `blockchain` 'arbitrum' | 'avalanche' | 'base' | 'bsc' | 'eth' | 'fantom' | 'flare' | 'gnosis' | 'linea' | 'optimism' | 'polygon' | 'scroll' | 'somnia_mainnet' | 'taiko' | 'telos' | 'xlayer' | 'avalanche_fuji' | 'base_sepolia' | 'eth_sepolia' | 'optimism_sepolia' | 'polygon_amoy', required
      - `collectionName` string, required
      - `collectionSymbol` string, required
      - `contractAddress` string: Contract address of the NFT.
      - `fromAddress` string, required
      - `imageUrl` string, required
      - `name` string, required
      - `timestamp` integer, required: UNIX timestamp of the block.
      - `toAddress` string, required
      - `tokenId` string
      - `transactionHash` string, required
      - `type` string, required: Contract type: `ERC721` or `ERC1155`.
      - `value` string, required: NFTs transferred (>1 only for ERC-1155).

## Other responses

- `400`: Bad Request — malformed JSON-RPC envelope or invalid `params`. The gateway rejects before the JSON-RPC layer processes the call.
- `401`: Unauthorized — missing or invalid API key in the server URL path. Verify that `{API_KEY}` is set to a valid project key.
- `429`: Too Many Requests — the API key has exceeded its rate or quota limits. Back off and retry; consider upgrading the Premium tier for higher limits.
- `500`: Server error — unexpected condition. Retry with exponential backoff; if it persists, file a ticket at https://www.ankr.com/support/.

---

[API](https://skmtc.dev/ankr/apis/ankr-advanced-api.md) - [All operations](https://skmtc.dev/ankr/apis/ankr-advanced-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ankr/apis/ankr-advanced-api/revisions/77e494aeec1b?raw)