Ikhtisar API Transaksi

Halaman ini diterjemahkan secara otomatis oleh AI. Versi bahasa Inggris adalah acuan resmi.Lihat versi bahasa Inggris →

Apa itu Transaction API?

Transaction API Raydium (Route V2) adalah layanan sisi server yang membangun transaksi swap Solana yang terserialisasi tanpa memerlukan klien untuk mempertahankan koneksi RPC atau menggabungkan seluruh SDK Raydium. Ini sangat menyederhanakan integrasi untuk:

Frontend web yang tidak dapat menjalankan klien RPC lokal
Aplikasi mobile dengan sumber daya terbatas
Bot trading tanpa antarmuka
Agregator dan penyedia dompet

Alih-alih melakukan perutean pool kompleks dan konstruksi transaksi di klien, Anda meminta kutipan swap dan pembuatan transaksi dari API kami, kemudian menandatangani dan menyiarkan hasilnya menggunakan RPC Solana apa pun.

Ikhtisar Alur Kerja

Transaction API memisahkan perhatian menjadi dua fase:

1. Fase Komputasi: Dapatkan Kutipan

Panggil /compute/swap-base-in atau /compute/swap-base-out untuk menerima output swap yang diharapkan (atau input yang diperlukan) berdasarkan status pool saat ini. Endpoint ini read-only dan tidak memerlukan penandatanganan apa pun:

GET /compute/swap-base-in?inputMint=EPjF...&outputMint=So111...&amount=1000000&slippageBps=50&txVersion=V0

Respons mencakup:

Jumlah output yang diharapkan
Perincian rute (pool dan sumber likuiditas mana yang digunakan)
Dampak harga

2. Fase Transaksi: Bangun dan Tandatangani

Setelah Anda memiliki respons komputasi, teruskan ke /transaction/swap-base-in atau /transaction/swap-base-out (bersama dengan dompet dan konfigurasi):

POST /transaction/swap-base-in
Content-Type: application/json

{
  "wallet": "YourWalletAddress",
  "swapResponse": { ...response from /compute/swap-base-in },
  "txVersion": "V0",
  "computeUnitPriceMicroLamports": "1000",
  "wrapSol": false,
  "unwrapSol": false,
  "inputAccount": "TokenAccount1...",
  "outputAccount": "TokenAccount2..."
}

Respons berisi:

Transaksi versioned yang dikodekan base64 siap untuk ditandatangani
Alamat tabel pencarian alamat (jika txVersion=V0)

Klien Anda kemudian:

Mendekode transaksi
Menandatanganinya dengan keypair pengguna
Menyiarkannya melalui RPC Solana apa pun
Menunggu konfirmasi

Endpoint Komputasi

`GET /compute/swap-base-in`

Kasus penggunaan: Pengguna menentukan jumlah input, kami menghitung output. Parameter query yang diperlukan:

inputMint – Alamat mint token yang Anda kirim
outputMint – Alamat mint token yang Anda inginkan
amount – Jumlah input dalam lamport (unit terkecil)
slippageBps – Slippage maksimal yang dapat diterima dalam basis poin (0–10000)
txVersion – V0 atau LEGACY

Opsional:

referrerBps – Jika Anda memiliki otoritas referrer, basis poin output untuk dikumpulkan sebagai biaya referrer

`GET /compute/swap-base-out`

Kasus penggunaan: Pengguna menentukan output yang diinginkan, kami menghitung input yang diperlukan. Parameter query yang diperlukan:

inputMint, outputMint, amount (output yang diinginkan), slippageBps, txVersion

Catatan: Tidak ada basis poin referrer untuk base-out (belum diimplementasikan).

Endpoint Transaksi

`POST /transaction/swap-base-in`

Membangun transaksi untuk jumlah input tetap. Isi yang diperlukan:

wallet – Alamat dompet penandatangan Anda
swapResponse – Seluruh objek respons komputasi
txVersion – Versi transaksi
computeUnitPriceMicroLamports – Biaya prioritas dalam mikro-lamport

Opsional:

wrapSol – Jika true, bungkus SOL native untuk input
unwrapSol – Jika true, buka bungkus WSOL menjadi SOL di output
inputAccount – Akun token untuk input (diperlukan jika tidak membungkus SOL)
outputAccount – Akun token untuk output
nonceInfo – Nonce tahan lama untuk penandatanganan offline
jitoInfo – Parameter paket perlindungan MEV Jito
referrerWallet – Dompet referrer untuk pengumpulan biaya

`POST /transaction/swap-base-out`

Membangun transaksi untuk jumlah output tetap. Parameter yang sama dengan base-in, kecuali:

Bidang referrerInfo saat ini dikomentari (belum diimplementasikan)

Amplop Respons

Semua endpoint mengembalikan amplop standar:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "success": true,
  "version": "V1",
  "data": { ... }
}

Saat error, success adalah false dan msg berisi kode error (misalnya, REQ_WALLET_ERROR, REQ_SLIPPAGE_BPS_ERROR).

Bentuk Respons Transaksi

Respons transaksi yang berhasil terlihat seperti:

{
  "id": "...",
  "success": true,
  "version": "V1",
  "data": {
    "transaction": "AgABB...",  // Base64-encoded transaction
    "addressLookupTableAddresses": ["Address1...", "Address2..."]  // For V0 only
  }
}

Contoh Integrasi

Berikut adalah alur khas dalam pseudocode:

// 1. Get quote
const quote = await fetch(
  'https://transaction-v1.raydium.io/compute/swap-base-in?' +
  'inputMint=EPjF...&outputMint=So111...&amount=1000000&slippageBps=50&txVersion=V0'
).then(r => r.json());

// 2. Validate quote
if (!quote.success) {
  throw new Error(quote.msg);
}

// 3. Build transaction
const tx = await fetch(
  'https://transaction-v1.raydium.io/transaction/swap-base-in',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      wallet: userWalletAddress,
      swapResponse: quote,
      txVersion: 'V0',
      computeUnitPriceMicroLamports: '1000',
      inputAccount: userInputTokenAccount,
      outputAccount: userOutputTokenAccount,
    }),
  }
).then(r => r.json());

// 4. Decode and sign
const transaction = VersionedTransaction.deserialize(
  Buffer.from(tx.data.transaction, 'base64')
);
transaction.sign([userKeypair]);

// 5. Send via RPC
const rpc = new Connection('https://api.mainnet-beta.solana.com');
const sig = await rpc.sendTransaction(transaction);
await rpc.confirmTransaction(sig);

Parameter Utama Dijelaskan

`txVersion`

V0: Transaksi Solana modern dengan Address Lookup Tables (ALTs). Ukuran serialisasi lebih kecil, biaya lebih rendah.
LEGACY: Format transaksi pre-ALT. Lebih besar, tetapi berfungsi dengan semua endpoint RPC.

Pilih V0 jika memungkinkan; jatuh kembali ke LEGACY jika RPC atau dompet Anda tidak mendukung ALTs.

`computeUnitPriceMicroLamports`

Biaya prioritas untuk penyertaan blok yang lebih cepat. Atur ke 0 untuk tidak ada biaya prioritas, atau nilai yang lebih tinggi (misalnya, 1000) untuk bersaing di jaringan yang ramai. Unit adalah mikro-lamport per unit komputasi.

`slippageBps`

Toleransi slippage maksimal dalam basis poin. 100 = 1%, 50 = 0,5%.

Gunakan nilai yang lebih rendah (misalnya, 25–50 bps) untuk swap yang paling stabil
Tingkatkan untuk pasangan volatile atau likuiditas rendah

`wrapSol` dan `unwrapSol`

wrapSol: Jika true, API membungkus SOL native Anda menjadi WSOL. Tidak perlu inputAccount.
unwrapSol: Jika true, API membuka bungkus WSOL output kembali ke SOL native. Tidak perlu outputAccount.

Jika keduanya false, Anda harus menyediakan akun token eksplisit.

Endpoint Jaringan

Jaringan	Mainnet	Devnet
Host	`transaction-v1.raydium.io`	`transaction-v1-devnet.raydium.io`
Protocol	HTTPS	HTTPS

Kode Error

Pesan error umum:

Kode	Arti
`REQ_SLIPPAGE_BPS_ERROR`	Slippage tidak valid atau di luar jangkauan
`REQ_INPUT_MINT_ERROR`	Alamat mint input tidak valid
`REQ_OUTPUT_MINT_ERROR`	Alamat mint output tidak valid
`REQ_AMOUNT_ERROR`	Jumlah bukan angka yang valid
`REQ_TX_VERSION_ERROR`	txVersion harus V0 atau LEGACY
`REQ_WALLET_ERROR`	Alamat dompet tidak valid
`REQ_INPUT_ACCOUT_ERROR`	Akun token input hilang atau tidak valid
`REQ_OUTPUT_ACCOUT_ERROR`	Akun token output hilang atau tidak valid
`UNKNOWN_ERROR`	Error sisi server; periksa parameter permintaan Anda

Overview

API v3

Transaction API

Perps API

LaunchLab APIs

Dynamic IPFS API

Owner API

API v1

Temp API

Apa itu Transaction API?

Ikhtisar Alur Kerja

1. Fase Komputasi: Dapatkan Kutipan

2. Fase Transaksi: Bangun dan Tandatangani

Endpoint Komputasi

`GET /compute/swap-base-in`

`GET /compute/swap-base-out`

Endpoint Transaksi

`POST /transaction/swap-base-in`

`POST /transaction/swap-base-out`

Amplop Respons

Bentuk Respons Transaksi

Contoh Integrasi

Parameter Utama Dijelaskan

`txVersion`

`computeUnitPriceMicroLamports`

`slippageBps`

`wrapSol` dan `unwrapSol`

Endpoint Jaringan

Kode Error

Lihat Juga

Overview

API v3

Transaction API

Perps API

LaunchLab APIs

Dynamic IPFS API

Owner API

API v1

Temp API

Documentation Index

​Apa itu Transaction API?

​Ikhtisar Alur Kerja

​1. Fase Komputasi: Dapatkan Kutipan

​2. Fase Transaksi: Bangun dan Tandatangani

​Endpoint Komputasi

​GET /compute/swap-base-in

​GET /compute/swap-base-out

​Endpoint Transaksi

​POST /transaction/swap-base-in

​POST /transaction/swap-base-out

​Amplop Respons

​Bentuk Respons Transaksi

​Contoh Integrasi

​Parameter Utama Dijelaskan

​txVersion

​computeUnitPriceMicroLamports

​slippageBps

​wrapSol dan unwrapSol

​Endpoint Jaringan

​Kode Error

​Lihat Juga

Apa itu Transaction API?

Ikhtisar Alur Kerja

1. Fase Komputasi: Dapatkan Kutipan

2. Fase Transaksi: Bangun dan Tandatangani

Endpoint Komputasi

`GET /compute/swap-base-in`

`GET /compute/swap-base-out`

Endpoint Transaksi

`POST /transaction/swap-base-in`

`POST /transaction/swap-base-out`

Amplop Respons

Bentuk Respons Transaksi

Contoh Integrasi

Parameter Utama Dijelaskan

`txVersion`

`computeUnitPriceMicroLamports`

`slippageBps`

`wrapSol` dan `unwrapSol`

Endpoint Jaringan

Kode Error

Lihat Juga