Transaction API

The Transaction API prepares Solana transactions for Swig wallet creation, transfers, swaps, and custom instruction sets. It does not replace required application signatures. Responses include explicit signature requests for embedded secp256r1 and secp256k1 authorization; native Ed25519 signers are represented in the serialized Solana transaction instead.

Supported preparation routes

Method	Route
`POST`	`/transaction/prepare/batch`
`POST`	`/transaction/wallet/create`
`POST`	`/transaction/transfer/sol`
`POST`	`/transaction/transfer/spl-token`
`POST`	`/transaction/swap/jupiter`
`POST`	`/transaction/prepare/custom`

Preparation requests are not retried automatically. A replay can duplicate work, so decide per call whether repeating is correct.

Auth

Use an API key:

Authorization: Bearer sk_your_api_key

Common request fields

Field	Type	Description
`network`	enum	`NETWORK_DEVNET` or `NETWORK_MAINNET`
`feePayer`	string	Fee payer public key used in the prepared Solana transaction
`swigAddress`	string	Swig config address for existing-wallet operations
`requesterAuthority`	object	Wallet authority requesting the operation

Prepared transaction response

Most endpoints return a prepared transaction or a response containing prepared transactions.

Field	Type	Description
`transaction`	base64 string	Serialized unsigned or partially signed Solana transaction
`transactionEncoding`	enum	Currently `TRANSACTION_ENCODING_BASE64`
`wallet`	object	`swigConfigAddress` and `walletAddress` when known
`expiresAt`	timestamp	Expiration for the prepared transaction
`network`	enum	Network for which the transaction was prepared
`recentBlockhash`	string	Recent blockhash used in the transaction
`kind`	enum	Prepared transaction category
`signatureRequests`	array	Embedded `secp256r1` or `secp256k1` signatures to obtain and patch before submission

Each signature request carries scheme, signer, messageHash, slot, and counter. The signer is encoded for its signature scheme, and messageHash is the hex-encoded message to sign. An empty array does not prove that the transaction needs no application signature; inspect the Solana transaction’s required signer set for native Ed25519 authorities and other transaction-level signers.

Prepare a batch

POST /transaction/prepare/batch batches one or more supported operations for an existing Swig.

{
  "network": "NETWORK_DEVNET",
  "feePayer": "FeePayerPublicKey",
  "swigAddress": "SwigConfigAddress",
  "requesterAuthority": {
    "ed25519": { "publicKey": "RequesterPublicKey" }
  },
  "operations": [
    {
      "transferSol": {
        "destination": "DestinationPublicKey",
        "lamports": "1000000"
      }
    },
    {
      "transferToken": {
        "mint": "MintAddress",
        "destinationOwner": "DestinationOwnerPublicKey",
        "amount": "1000000"
      }
    }
  ]
}

Prepare custom instructions

POST /transaction/prepare/custom builds one prepared Swig transaction from the Solana instructions supplied by the application.

{
  "network": "NETWORK_DEVNET",
  "feePayer": "FeePayerPublicKey",
  "swigAddress": "SwigConfigAddress",
  "requesterAuthority": {
    "ed25519": { "publicKey": "RequesterPublicKey" }
  },
  "instructions": [
    {
      "programId": "ProgramPublicKey",
      "accounts": [
        {
          "pubkey": "WritableAccountPublicKey",
          "isWritable": true
        }
      ],
      "data": "Base64EncodedInstructionData"
    }
  ],
  "addressLookupTableAccounts": ["LookupTablePublicKey"]
}

The response is prepared only. The application still supplies every embedded signature request and transaction-level signer, then chooses direct or sponsored submission.

Create a wallet

POST /transaction/wallet/create

{
  "network": "NETWORK_DEVNET",
  "feePayer": "FeePayerPublicKey",
  "policyId": "policy_123",
  "initialUser": {
    "ed25519": { "publicKey": "InitialUserPublicKey" }
  }
}

Transfer SOL

POST /transaction/transfer/sol

{
  "network": "NETWORK_DEVNET",
  "feePayer": "FeePayerPublicKey",
  "swigAddress": "SwigConfigAddress",
  "requesterAuthority": {
    "ed25519": { "publicKey": "RequesterPublicKey" }
  },
  "destination": "DestinationPublicKey",
  "lamports": "1000000"
}

Transfer SPL token

POST /transaction/transfer/spl-token

{
  "network": "NETWORK_DEVNET",
  "feePayer": "FeePayerPublicKey",
  "swigAddress": "SwigConfigAddress",
  "requesterAuthority": {
    "ed25519": { "publicKey": "RequesterPublicKey" }
  },
  "mint": "MintAddress",
  "destinationOwner": "DestinationOwnerPublicKey",
  "amount": "1000000"
}

Jupiter swap

POST /transaction/swap/jupiter

{
  "network": "NETWORK_DEVNET",
  "feePayer": "FeePayerPublicKey",
  "swigAddress": "SwigConfigAddress",
  "requesterAuthority": {
    "ed25519": { "publicKey": "RequesterPublicKey" }
  },
  "inputMint": "InputMintAddress",
  "outputMint": "OutputMintAddress",
  "amount": "1000000",
  "slippageBps": 50
}

Optional Jupiter controls:

Field	Type	Purpose
`slippageBps`	number	Maximum slippage in basis points
`wrapAndUnwrapSol`	boolean	Let Jupiter wrap or unwrap native SOL
`tipAmountLamports`	integer string	Optional prioritization tip
`computeUnitPricePercentile`	string	Jupiter compute-unit price percentile
`maxAccounts`	number	Limit the accounts used by the route
`mode`	string	Opaque swap mode forwarded to Jupiter
`blockhashSlotsToExpiry`	number	Requested blockhash lifetime in slots
`destinationAccount`	string	Destination owner; the backend derives the SPL token account, or uses the address for native SOL

After preparation

The response is prepared only. Your application supplies every embedded signature request and transaction-level signer, then submits the transactions in the returned order — directly, or through the Paymaster API. If policyId is omitted on wallet creation, initialUser is required and the API creates a wallet policy for the caller’s organization.

Start Here

Runtime APIs

Boundaries

Transaction API

Supported preparation routes

Auth

Common request fields

Prepared transaction response

Prepare a batch

Prepare custom instructions

Create a wallet

Transfer SOL

Transfer SPL token

Jupiter swap

After preparation

​Supported preparation routes

​Auth

​Common request fields

​Prepared transaction response

​Prepare a batch

​Prepare custom instructions

​Create a wallet

​Transfer SOL

​Transfer SPL token

​Jupiter swap

​After preparation

Supported preparation routes

Auth

Common request fields

Prepared transaction response

Prepare a batch

Prepare custom instructions

Create a wallet

Transfer SOL

Transfer SPL token

Jupiter swap

After preparation