Get Wallet Transactions
Retrieve transaction history for a specific wallet.
curl "https://api.karen.dev/api/v1/wallets/WALLET_ID/transactions?limit=50" \
-H "Authorization: Bearer YOUR_API_KEY"
Maximum number of transactions to return
Array of transaction records
Unique transaction record ID
Wallet that initiated the transaction
Agent that initiated the transaction (if applicable)
Transaction type: transfer, swap, airdrop, token_launch, stake, etc.
Transaction status: pending, confirmed, failed, or blocked
Solana transaction signature
Transaction-specific details (amounts, addresses, tokens, etc.)
List of guardrail checks that were applied
Error message if transaction failed
Get All Transactions
Retrieve transaction history across all wallets.
curl "https://api.karen.dev/api/v1/transactions?limit=100" \
-H "Authorization: Bearer YOUR_API_KEY"
Maximum number of transactions to return
Array of transaction records from all wallets
Transaction Types
The following transaction types are tracked:
transfer - SOL transfersswap - Token swaps via Jupiterairdrop - Devnet/testnet airdropstoken_transfer - SPL token transferstoken_launch - New token creationmint_supply - Minting additional token supplyrevoke_authority - Revoking mint/freeze authoritystake - SOL stakingunstake - Stake deactivationwithdraw_stake - Stake withdrawalburn - Token burningclose_account - Closing token accountswrap_sol - Wrapping SOL to wSOLunwrap_sol - Unwrapping wSOL to SOLfreeze - Freezing token accountsthaw - Unfreezing token accountsother - Other transaction types
Transaction Status
pending - Transaction submitted, awaiting confirmationconfirmed - Transaction confirmed on-chainfailed - Transaction failed to executeblocked - Transaction blocked by guardrails
Example Response
{
"transactions": [
{
"id": "tx_abc123",
"walletId": "wallet_xyz",
"agentId": "agent_trader",
"type": "swap",
"status": "confirmed",
"signature": "5Kj...",
"details": {
"inputToken": "So11111111111111111111111111111111111111112",
"outputToken": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"inputAmount": 1.0,
"outputAmount": 150.25,
"slippageBps": 50
},
"guardrailsApplied": [
"amount_limit",
"rate_limit",
"program_whitelist"
],
"timestamp": "2024-03-15T10:30:00Z"
},
{
"id": "tx_def456",
"walletId": "wallet_xyz",
"type": "transfer",
"status": "confirmed",
"signature": "3Xy...",
"details": {
"from": "7xK...",
"to": "9mP...",
"amount": 0.5
},
"guardrailsApplied": ["amount_limit"],
"timestamp": "2024-03-15T09:15:00Z"
}
]
}