Skip to main content
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_keystring✓Customer API key.
wallet_idstring✓Accepts 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.

​
Examples

from py_1151 import Client

client = Client(api_key="sk_live_...")

transactions = client.get_wallet_transactions("w_c8b07c7d-9c7d-4a33-9200-0bdfa82dc497")

for tx in transactions:
    print(tx.id, tx.direction, tx.amount, tx.metadata)
The responses from each SDK expose the same fields as the REST payload, so you can iterate and filter using your preferred language.