Skip to main content
GET
https://partners-backend-1038109371738.europe-west1.run.app
/
api
/
v1
/
{chain_id}
/
wallets
/
{wallet}
/
transactions
curl "https://partners-backend-1038109371738.europe-west1.run.app/api/v1/8453/wallets/0x.../transactions?page=1&limit=20&sort=date_desc"
{
  "transactions": [
    {
      "action": "deposit",
      "date": "2024-01-15T10:30:00Z",
      "amount": 1000000000,
      "token_type": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "status": "approved",
      "transaction_hash": "0xabc...",
      "protocol": "aave"
    },
    {
      "action": "swap",
      "date": "2024-01-16T08:00:00Z",
      "amount": 500000000,
      "token_type": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "status": "approved",
      "transaction_hash": "0xdef...",
      "protocol": "compound",
      "new_token": "0x..."
    }
  ],
  "pagination": {
    "total_items": 15,
    "total_pages": 1,
    "current_page": 1,
    "items_per_page": 20
  }
}
SDK Alternative: Use giza.agent.getTransactions() for a simpler TypeScript interface. See SDK docs

Description

Retrieves paginated transaction history for a wallet including deposits, withdrawals, swaps, and rebalancing operations.

Path Parameters

chain_id
integer
required
The blockchain chain ID
wallet
string
required
The wallet address

Query Parameters

page
integer
default:"1"
Page number (starts at 1)
limit
integer
default:"20"
Number of items per page (max 100)
sort
string
default:"date_desc"
Sort order: date_desc or date_asc

Response

transactions
array
Array of transactions
pagination
object
Pagination info
curl "https://partners-backend-1038109371738.europe-west1.run.app/api/v1/8453/wallets/0x.../transactions?page=1&limit=20&sort=date_desc"
{
  "transactions": [
    {
      "action": "deposit",
      "date": "2024-01-15T10:30:00Z",
      "amount": 1000000000,
      "token_type": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "status": "approved",
      "transaction_hash": "0xabc...",
      "protocol": "aave"
    },
    {
      "action": "swap",
      "date": "2024-01-16T08:00:00Z",
      "amount": 500000000,
      "token_type": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "status": "approved",
      "transaction_hash": "0xdef...",
      "protocol": "compound",
      "new_token": "0x..."
    }
  ],
  "pagination": {
    "total_items": 15,
    "total_pages": 1,
    "current_page": 1,
    "items_per_page": 20
  }
}