---
title: "NFT Transfer"
method: POST
path: "/nft"
tags: ["NFT"]
---

# NFT Transfer

`POST /nft`

Computes routes and generates transaction messages for cross-chain NFT transfers within the Initia ecosystem. Supports:
- Same-chain transfers (EVM, Move, and Wasm chains)
- Single-hop IBC (L2 to L1 or L1 to L2 via ICS-721)
- Multi-hop (L2 to L1 to L2, two IBC hops)

## Request body

- object
  - `from_address` string, required — Sender address.
  - `from_chain_id` string, required — Source chain ID.
  - `to_address` string, required — Recipient address.
  - `to_chain_id` string, required — Destination chain ID.
  - `token_ids` string[], required — Token IDs to transfer (maximum 30).
  - `collection_address` string, required — NFT collection contract address. Pass an empty string for Move chains.
  - `class_id` string — IBC class ID. Required for cross-chain transfers.
  - `class_trace` object — IBC class trace for multi-hop transfers.
    - `path` string — IBC trace path.
    - `base_class_id` string — Base class ID.
  - `object_addresses` string[] — Move object addresses (maximum 30). Required for same-chain Move transfers.
  - `l1_recover_address` string — L1 recovery address for L2 to L1 to L2 transfers. Defaults to from_address.
  - `outgoing_proxy` string — Outgoing proxy contract address (Wasm chains).
  - `timeout` integer — IBC timeout in seconds.

## Response `200`

Successful response

- object
  - `msgs` object[] — Array of transaction messages appropriate for the source chain's VM type.
    - `typeUrl` string
    - `value` object

## Changes

- **2026-04-02** `f731767cc880` — 1 warning
  - removed the request property `ignore_blacklist`
- **2026-03-25** `8f391fd6e76c` — 1 info
  - added the new optional request property `ignore_blacklist`

[Change history](https://skmtc.dev/initia-labs/apis/router-api/changes/nft/post.md)

---

[API](https://skmtc.dev/initia-labs/apis/router-api.md) · [All operations](https://skmtc.dev/initia-labs/apis/router-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/initia-labs/router-api/revisions/d69782928523/schema)