POST /wallet/transactions Returns the transactions that belong to a wallet you manage.

Request

{
  "api_key": "sk_live_...",
  "wallet_id": "w_c8b07c7d-9c7d-4a33-9200-0bdfa82dc497"
}
FieldTypeRequiredNotes
api_keystringCustomer API key.
wallet_idstringAccepts the 1151 wallet ID (w_<uuid>) or on-chain address.

Response

{
  "transactions": [
    {
      "id": "tx_2c4f2b01-5f49-4c66-b379-a9e0c7df8f5e",
      "created_at": 1712609133,
      "direction": "outbound",
      "amount": "0.05000000",
      "asset": "BTC",
      "destination": "bc1p...",
      "success": true,
      "testnet": false,
      "metadata": {
        "invoice": "INV-42"
      }
    },
    {
      "id": "tx_b79d71c5-7838-4b12-90e4-132077e5be3f",
      "created_at": 1712595001,
      "direction": "inbound",
      "amount": "0.25000000",
      "asset": "BTC",
      "destination": "bc1p...",
      "success": true,
      "testnet": false,
      "metadata": null
    }
  ]
}
  • Transactions are ordered newest to oldest.
  • Each entry includes the same metadata returned from POST /transaction/get so you can search or filter by your own keys.

Errors

StatusPayloadWhen it happens
400{ "error": "Missing required fields" }api_key or wallet_id omitted.
403{ "error": "API key is not valid" }API key fails validation.
404{ "error": "Wallet not found" }Wallet does not belong to your account.
500{ "error": "<message>" }Unexpected service error.

SDK equivalents

  • JavaScript: client.getWalletTransactions({ walletId }) or wallet.transactions()
  • Python: client.get_wallet_transactions(wallet_id) or wallet.transactions()