Transfer

Builds a transfer of asset from authority to recipient.

The response is chain-dependent and exactly one field is present. Solana standards return a base64 tx. EVM standards (native, erc20, erc721, erc1155) instead return an evm object with to, data, value and an advisory gasLimit — fill in the nonce and EIP-1559 fees, then sign and broadcast it as an ordinary EVM transaction. When gasLimit is absent, estimate it client-side.

EVM NFTs are addressed as <contract>-<tokenId>. amount is the amount in the token's smallest unit as a decimal string — because these are uint256 values that overflow a 64-bit integer — wei for native, token base units for erc20, and the token count for erc1155 (defaults to 1). It is ignored for standards that are always 1-of-1 (every Solana standard, plus erc721). objkt is not supported on this route.

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, which selects the program the transaction is built against. Solana: nft (Token Metadata), pnft (programmable NFT), cnft (compressed), core / core-collection (Metaplex Core). objkt is a Tezos asset. EVM: native, erc20, erc721, erc1155. Individual endpoints accept only a subset — an unsupported standard is rejected with a 400.

Value in

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

amount?string

Amount in the token's smallest unit, as a decimal string — wei for native, token base units for erc20, token count for erc1155 (defaults to 1). Ignored for every Solana standard and erc721, which are always 1-of-1. A string rather than a number because these are uint256 values that overflow a 64-bit integer.

targetPriorityFeeLamports?integer

Total priority fee to target for this transaction, in lamports. The builder derives the compute-unit price from it and the transaction's compute budget. Omit to let mallow pick a fee from current network conditions.

Formatuint64

blockhash?string

Recent blockhash to stamp onto the transaction, base58. Omit to let mallow supply one — mallow's is cached for up to 10 seconds, so two identical requests inside that window compile the same transaction, with the same signature once signed. Supply your own to control the expiry window, or when otherwise-identical requests must produce distinct transactions. Rejected with a 400 if it is not valid base58; a blockhash the cluster has already aged out builds fine and fails at send time.

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`