Skip to main content
GET
/
v1
/
wallet
/
transactions
curl "https://api.saturn-pay.com/v1/wallet/transactions?limit=20" \
  -H "Authorization: Bearer sk_agt_..."

{
  "transactions": [
    {
      "id": "tx_abc123",
      "type": "charge",
      "amountUsdCents": 15,
      "amountSats": 45,
      "description": "reason (openai/gpt-4o)",
      "agentId": "agt_xyz789",
      "capability": "reason",
      "provider": "openai",
      "auditId": "aud_def456",
      "createdAt": "2024-01-20T14:30:00Z"
    },
    {
      "id": "tx_def456",
      "type": "credit",
      "amountUsdCents": 1000,
      "amountSats": 30000,
      "description": "Card payment",
      "createdAt": "2024-01-20T10:00:00Z"
    }
  ],
  "total": 2,
  "limit": 50,
  "offset": 0
}
Returns a list of all transactions (charges, credits, refunds) for your wallet.

​
Query Parameters

​
type
string
Filter by type: charge, credit, refund
​
agentId
string
Filter by agent ID
​
startDate
string
ISO 8601 date to filter from
​
endDate
string
ISO 8601 date to filter to
​
limit
number
Maximum number of results (default: 50, max: 100)
​
offset
number
Number of results to skip (for pagination)

​
Response

​
transactions
array
Array of transaction objects
curl "https://api.saturn-pay.com/v1/wallet/transactions?limit=20" \
  -H "Authorization: Bearer sk_agt_..."

{
  "transactions": [
    {
      "id": "tx_abc123",
      "type": "charge",
      "amountUsdCents": 15,
      "amountSats": 45,
      "description": "reason (openai/gpt-4o)",
      "agentId": "agt_xyz789",
      "capability": "reason",
      "provider": "openai",
      "auditId": "aud_def456",
      "createdAt": "2024-01-20T14:30:00Z"
    },
    {
      "id": "tx_def456",
      "type": "credit",
      "amountUsdCents": 1000,
      "amountSats": 30000,
      "description": "Card payment",
      "createdAt": "2024-01-20T10:00:00Z"
    }
  ],
  "total": 2,
  "limit": 50,
  "offset": 0
}