Transfer

Builds a transfer of asset from authority to recipient.

Solana standards return a base64 tx. EVM standards (native, erc20, erc721, erc1155) return an evm object instead: add the nonce and fees, then sign and send it as an ordinary EVM transaction. objkt is not supported.

Transfers built with memo or tagFeeAccount appear in mallow's activity feeds. Either way, the recipient becomes the owner.

A Solana transfer must fit in one transaction. If a compressed NFT's transfer doesn't, the request fails with 400; retry with transactionVersion: 1 if the wallet supports it.

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Moves an asset between wallets. Spans Solana and EVM — which fields apply depends on tokenStandard. objkt (Tezos) is not supported on this route.

authority*string

Wallet sending the asset (base58 on Solana, 0x address on EVM). Signs the transaction.

asset*string

Asset to transfer. A mint address on Solana; on EVM, the <contract>-<tokenId> pair for erc721/erc1155 or the token contract for erc20.

recipient*string

Wallet receiving the asset.

tokenStandard*TokenStandard

Asset standard. Solana: nft (Token Metadata), pnft (programmable NFT), cnft and cnft-v2 (compressed NFTs, Bubblegum v1 and v2), core and core-collection (Metaplex Core). Tezos: objkt. EVM: native, erc20, erc721, erc1155. Each endpoint accepts only some of these and returns 400 for the rest.

Value in

"nft"
"core"
"core-collection"
"pnft"
"cnft"
"cnft-v2"
"objkt"
"native"
"erc20"
"erc721"
"erc1155"

amount?string

Amount in the token's smallest unit, as a string: wei for native, base units for erc20, token count for erc1155 (default 1). Ignored for Solana standards and erc721.

memo?string

Free-form note written on-chain alongside the transfer, signed by authority. Solana standards only; ignored on EVM.

tagFeeAccount?boolean

Show the transfer in mallow's activity feeds without adding a memo (a memo does this too). Solana only.

transactionVersion?integer

Solana transaction version: 0 (the default) or 1. A version 1 transaction can be up to 4,096 bytes instead of 1,232, which some compressed NFT transfers need. Request 1 only if the signing wallet supports it. Ignored on EVM.

Formatuint8

Range0 <= value <= 1

targetPriorityFeeLamports?integer

Priority fee per transaction, in lamports. By default it is a cap: mallow pays what the network currently needs, up to this amount (50,000 when omitted). Set exactPriorityFee to pay exactly this amount instead. The fee is never less than 15,000 lamports.

Formatuint64

exactPriorityFee?boolean

Pay targetPriorityFeeLamports exactly instead of treating it as a cap. Defaults to false.

blockhash?string

Recent blockhash to build the transaction with (base58). Omit it to let mallow supply one; identical requests a few seconds apart then return the same transaction.

Response Body

`application/json`

curl -X POST "https://example.com/v2/tx/assets/transfer" \  -H "Content-Type: application/json" \  -d '{    "authority": "string",    "asset": "string",    "recipient": "string",    "tokenStandard": "nft"  }'

{  "result": {    "tx": "string",    "evm": {      "to": "string",      "data": "string",      "value": "string",      "gasLimit": "string"    }  }}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`