POST
/
v1
/
wallets
/
{wallet_id}
/
rpc
  --url https://api.privy.io/v1/wallets/{wallet_id}/rpc \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'privy-app-id: <privy-app-id>' \
  --data '{
  "method": "transfer",
  "network": "MAINNET",
  "params": {
    "receiver_spark_address": "sprt1pgss8z35rpycv4duqdk5u3sclhjnztjunv5yajlwk69tyv5fsvwwe9mg8n4d49",
    "amount_sats": 16
  }
}'
{
  "method": "transfer",
  "data": {
    "id": "01983eb7-4008-7b73-b269-c0bd86955a1b",
    "sender_identity_public_key": "027bca218b2853d5ff2e9b174370f58107a23df98a759e968c523253c1702dd485",
    "receiver_identity_public_key": "038a3418498655bc036d4e4618fde5312e5c9b284ecbeeb68ab23289831cec9768",
    "status": "TRANSFER_STATUS_SENDER_KEY_TWEAKED",
    "total_value": 16,
    "expiry_time": "1970-01-01T00:00:00.000Z",
    "leaves": [
      {
        "leaf": {
          "id": "01983e38-b2f8-7649-a910-b2be1424de1d",
          "tree_id": "01983e36-e645-7a34-ab95-a6faec210992",
          "value": 16,
          "parent_node_id": "01983e38-b2e2-7edd-9b6b-a784545aa28c",
          "node_tx": "<hex-encoded-tx>",
          "refund_tx": "<hex-encoded-refund>",
          "vout": 0,
          "verifying_public_key": "<pubkey>",
          "owner_identity_public_key": "<pubkey>",
          "signing_keyshare": {
            "owner_identifiers": ["...", "..."],
            "threshold": 2,
            "public_key": "<pubkey>",
            "public_shares": {
              "...": "<pubkey>",
              "...": "<pubkey>"
            },
            "updated_time": "2025-07-24T23:14:14.598Z"
          },
          "status": "TRANSFER_LOCKED",
          "network": "MAINNET"
        },
        "secret_cipher": "<ciphertext>",
        "signature": "<hex>",
        "intermediate_refund_tx": "<hex>"
      }
    ],
    "created_time": "2025-07-24T23:14:14.276Z",
    "updated_time": "2025-07-24T23:14:14.618Z",
    "type": "TRANSFER",
    "transfer_direction": "OUTGOING",
    "encoding": "hex"
  }
}
  --url https://api.privy.io/v1/wallets/{wallet_id}/rpc \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'privy-app-id: <privy-app-id>' \
  --data '{
  "method": "transfer",
  "network": "MAINNET",
  "params": {
    "receiver_spark_address": "sprt1pgss8z35rpycv4duqdk5u3sclhjnztjunv5yajlwk69tyv5fsvwwe9mg8n4d49",
    "amount_sats": 16
  }
}'
{
  "method": "transfer",
  "data": {
    "id": "01983eb7-4008-7b73-b269-c0bd86955a1b",
    "sender_identity_public_key": "027bca218b2853d5ff2e9b174370f58107a23df98a759e968c523253c1702dd485",
    "receiver_identity_public_key": "038a3418498655bc036d4e4618fde5312e5c9b284ecbeeb68ab23289831cec9768",
    "status": "TRANSFER_STATUS_SENDER_KEY_TWEAKED",
    "total_value": 16,
    "expiry_time": "1970-01-01T00:00:00.000Z",
    "leaves": [
      {
        "leaf": {
          "id": "01983e38-b2f8-7649-a910-b2be1424de1d",
          "tree_id": "01983e36-e645-7a34-ab95-a6faec210992",
          "value": 16,
          "parent_node_id": "01983e38-b2e2-7edd-9b6b-a784545aa28c",
          "node_tx": "<hex-encoded-tx>",
          "refund_tx": "<hex-encoded-refund>",
          "vout": 0,
          "verifying_public_key": "<pubkey>",
          "owner_identity_public_key": "<pubkey>",
          "signing_keyshare": {
            "owner_identifiers": ["...", "..."],
            "threshold": 2,
            "public_key": "<pubkey>",
            "public_shares": {
              "...": "<pubkey>",
              "...": "<pubkey>"
            },
            "updated_time": "2025-07-24T23:14:14.598Z"
          },
          "status": "TRANSFER_LOCKED",
          "network": "MAINNET"
        },
        "secret_cipher": "<ciphertext>",
        "signature": "<hex>",
        "intermediate_refund_tx": "<hex>"
      }
    ],
    "created_time": "2025-07-24T23:14:14.276Z",
    "updated_time": "2025-07-24T23:14:14.618Z",
    "type": "TRANSFER",
    "transfer_direction": "OUTGOING",
    "encoding": "hex"
  }
}

Headers

privy-app-id
string
required
ID of your Privy app.
privy-authorization-signature
string
Request authorization signature. If multiple signatures are required, they should be comma separated.

Path Parameters

wallet_id
string
required
ID of the wallet to get.
These wallet methods are modeled after the Spark Wallet SDK. For more information about this wallet method, check out the Spark Wallet documentation.

Body

method
string
required
Available options: transfer
network
string
required
Available options: MAINNET, REGTEST
params
object
required

Returns

method
enum<string>
required
Available options: transfer
data
object
required
The returned Transfer object