跳转到主要内容
POST
/
v1
/
spl
/
transfer
Transfer SPL Tokens
curl --request POST \
  --url https://payments.magicblock.app/v1/spl/transfer \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": "3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE",
  "to": "Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L",
  "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "amount": 1000000,
  "visibility": "private",
  "fromBalance": "base",
  "toBalance": "base",
  "initIfMissing": true,
  "initAtasIfMissing": true,
  "initVaultIfMissing": false,
  "memo": "Order #1042",
  "minDelayMs": "0",
  "maxDelayMs": "0",
  "clientRefId": "42",
  "split": 1,
  "gasless": true
}
'
{
  "kind": "transfer",
  "version": "legacy",
  "transactionBase64": "<string>",
  "sendTo": "base",
  "recentBlockhash": "<string>",
  "lastValidBlockHeight": 123,
  "instructionCount": 1,
  "requiredSigners": [
    "<string>"
  ],
  "validator": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.magicblock.gg/llms.txt

Use this file to discover all available pages before exploring further.

请求头

authorization
string

Optional. Authentication token for requests that need to connect to the Private Ephemeral Rollup. Format: Bearer <token>.

示例:

"Bearer 1234567890"

请求体

application/json
from
string
必填

Sender wallet pubkey.

示例:

"3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE"

to
string
必填

Recipient wallet pubkey.

示例:

"Bt9oNR5cCtnfuMmXgWELd6q5i974PdEMQDUE55nBC57L"

mint
string
必填

SPL mint pubkey.

示例:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

amount
integer
必填

Base-unit amount as an integer JSON value with minimum 1.

必填范围: x >= 1
示例:

1000000

visibility
enum<string>
必填

Use public for a transparent SPL transfer or private to route through the Private Ephemeral Rollup.

可用选项:
public,
private
fromBalance
enum<string>
必填

Where the sender's balance is held. Drives which RPC the API uses for blockhash and where the client should submit.

可用选项:
base,
ephemeral
toBalance
enum<string>
必填

Where the recipient should receive the funds.

可用选项:
base,
ephemeral
cluster

Optional. Use mainnet for BASE_RPC_URL and EPHEMERAL_RPC_URL, devnet for BASE_DEVNET_RPC_URL and EPHEMERAL_DEVNET_RPC_URL, or provide a custom http(s) RPC URL to override the base RPC while keeping the configured ephemeral RPC.

可用选项:
mainnet,
devnet
示例:

"mainnet"

validator
string

Optional. When this transfer route needs a validator and none is provided, the API resolves it from the selected ephemeral RPC via getIdentity.

示例:

"MAS1Dt9qreoRMQ14YQuhg8UTZMMzDdKhmkZMECCzk57"

initIfMissing
boolean

Optional. Initialize the transfer queue if missing.

initAtasIfMissing
boolean

Optional. Initialize associated token accounts if missing.

initVaultIfMissing
boolean

Optional. Initialize the vault if missing. Defaults to false.

memo
string

Optional. Appends a final Memo Program instruction with this UTF-8 message.

示例:

"Order #1042"

minDelayMs
string

Optional. Private transfer only. Defaults to 0. Earliest (ms) the queued transfer may settle.

Pattern: ^\d+$
示例:

"0"

maxDelayMs
string

Optional. Private transfer only. Defaults to 0 when omitted, or to minDelayMs when only minDelayMs is set. Must be >= minDelayMs.

Pattern: ^\d+$
示例:

"0"

clientRefId
string

Optional. Private transfer only. Encrypted client reference ID that can be used to confirm a payment.

Pattern: ^\d+$
示例:

"42"

split
integer

Optional. Private transfer only. Defaults to 1. Number of queue entries to split the transfer across. Must be between 1 and 15 and cannot exceed amount.

必填范围: x <= 15
示例:

1

gasless
boolean

Optional. When true, the API uses the configured sponsor as transaction fee payer and prepends a relay-fee token transfer to the sponsor ATA.

示例:

true

legacy
boolean

Optional. Defaults to false. When true, skips lookup-table compilation and returns a legacy transaction. Private base -> base transfers may otherwise return a v0 transaction when a useful lookup table is configured.

响应

Unsigned serialized transaction

kind
enum<string>
必填
可用选项:
transfer
version
enum<string>
必填
可用选项:
legacy,
v0
transactionBase64
string
必填
sendTo
enum<string>
必填
可用选项:
base,
ephemeral
recentBlockhash
string
必填
lastValidBlockHeight
integer
必填
instructionCount
integer
必填
必填范围: x >= 0
requiredSigners
string[]
必填
validator
string