curl -X GET "https://api.danubeai.com/v1/wallet/transactions?limit=20" \
-H "danube-api-key: YOUR_API_KEY"
from danube import DanubeClient
with DanubeClient(api_key="YOUR_API_KEY") as client:
for tx in client.wallet.get_transactions(limit=20):
print(f"{tx.created_at} {tx.type} {tx.amount_cents / 100:+.2f}")
import { DanubeClient } from 'danube';
const client = new DanubeClient({ apiKey: 'YOUR_API_KEY' });
const transactions = await client.wallet.getTransactions({ limit: 20 });
for (const tx of transactions) {
console.log(`${tx.createdAt} ${tx.type} ${(tx.amountCents / 100).toFixed(2)}`);
}
{
"transactions": [
{
"id": "7c2d9e4f-1a3b-4c5d-8e6f-0a1b2c3d4e5f",
"user_id": "2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10",
"type": "tool_execution",
"amount_cents": -5,
"balance_after_cents": 1495,
"reference_id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
"reference_type": "tool_execution",
"metadata": {},
"created_at": "2026-09-11T14:30:00+00:00"
},
{
"id": "3a4b5c6d-7e8f-4a9b-8c0d-1e2f3a4b5c6d",
"user_id": "2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10",
"type": "deposit",
"amount_cents": 1500,
"balance_after_cents": 1500,
"reference_id": "pi_3Q…",
"reference_type": "stripe_payment",
"metadata": {},
"created_at": "2026-09-10T09:00:00+00:00"
}
],
"total": 2,
"limit": 20,
"offset": 0
}
Wallet
Get Wallet Transactions
List your wallet transactions, newest first, with pagination and an optional type filter
GET
/
v1
/
wallet
/
transactions
curl -X GET "https://api.danubeai.com/v1/wallet/transactions?limit=20" \
-H "danube-api-key: YOUR_API_KEY"
from danube import DanubeClient
with DanubeClient(api_key="YOUR_API_KEY") as client:
for tx in client.wallet.get_transactions(limit=20):
print(f"{tx.created_at} {tx.type} {tx.amount_cents / 100:+.2f}")
import { DanubeClient } from 'danube';
const client = new DanubeClient({ apiKey: 'YOUR_API_KEY' });
const transactions = await client.wallet.getTransactions({ limit: 20 });
for (const tx of transactions) {
console.log(`${tx.createdAt} ${tx.type} ${(tx.amountCents / 100).toFixed(2)}`);
}
{
"transactions": [
{
"id": "7c2d9e4f-1a3b-4c5d-8e6f-0a1b2c3d4e5f",
"user_id": "2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10",
"type": "tool_execution",
"amount_cents": -5,
"balance_after_cents": 1495,
"reference_id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
"reference_type": "tool_execution",
"metadata": {},
"created_at": "2026-09-11T14:30:00+00:00"
},
{
"id": "3a4b5c6d-7e8f-4a9b-8c0d-1e2f3a4b5c6d",
"user_id": "2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10",
"type": "deposit",
"amount_cents": 1500,
"balance_after_cents": 1500,
"reference_id": "pi_3Q…",
"reference_type": "stripe_payment",
"metadata": {},
"created_at": "2026-09-10T09:00:00+00:00"
}
],
"total": 2,
"limit": 20,
"offset": 0
}
Overview
Returns the credit wallet’s transaction history: deposits, tool execution charges, refunds, payouts and adjustments. Results are ordered newest first and paginated withlimit and offset. This is the same wallet that Get Wallet Balance reports on, and amounts are in cents.
Auth: Requires authentication (JWT or API key).
Query Parameters
integer
default:"50"
Maximum number of transactions to return. Values above 100 are capped to 100.
integer
default:"0"
Number of transactions to skip
string
Return only one transaction type:
deposit, tool_execution, refund, payout or adjustment. Any other value returns a 400.Response
array
The page of transactions, newest first.
Show Transaction
Show Transaction
string
Transaction id
string
Owner of the wallet
string
deposit, tool_execution, refund, payout or adjustmentinteger
Signed amount in cents: positive for deposits, negative for usage
integer
Wallet balance in cents after this transaction
string | null
Id of the related record, if any
string | null
Kind of record
reference_id points at, such as stripe_payment, tool_execution or refundobject
Extra details recorded with the transaction
string | null
When the transaction was recorded (ISO 8601)
integer
Number of matching transactions across all pages
integer
The limit applied to this page, after the cap
integer
The offset applied to this page
Example
The Python SDK returns thetransactions list and takes limit and offset; it does not expose the type filter.
curl -X GET "https://api.danubeai.com/v1/wallet/transactions?limit=20" \
-H "danube-api-key: YOUR_API_KEY"
from danube import DanubeClient
with DanubeClient(api_key="YOUR_API_KEY") as client:
for tx in client.wallet.get_transactions(limit=20):
print(f"{tx.created_at} {tx.type} {tx.amount_cents / 100:+.2f}")
import { DanubeClient } from 'danube';
const client = new DanubeClient({ apiKey: 'YOUR_API_KEY' });
const transactions = await client.wallet.getTransactions({ limit: 20 });
for (const tx of transactions) {
console.log(`${tx.createdAt} ${tx.type} ${(tx.amountCents / 100).toFixed(2)}`);
}
{
"transactions": [
{
"id": "7c2d9e4f-1a3b-4c5d-8e6f-0a1b2c3d4e5f",
"user_id": "2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10",
"type": "tool_execution",
"amount_cents": -5,
"balance_after_cents": 1495,
"reference_id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
"reference_type": "tool_execution",
"metadata": {},
"created_at": "2026-09-11T14:30:00+00:00"
},
{
"id": "3a4b5c6d-7e8f-4a9b-8c0d-1e2f3a4b5c6d",
"user_id": "2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10",
"type": "deposit",
"amount_cents": 1500,
"balance_after_cents": 1500,
"reference_id": "pi_3Q…",
"reference_type": "stripe_payment",
"metadata": {},
"created_at": "2026-09-10T09:00:00+00:00"
}
],
"total": 2,
"limit": 20,
"offset": 0
}