Skip to main content
The Unified Transaction system aggregates all transaction types — deposits, withdrawals, swaps, card transactions, IBAN transfers, gateway payments, auto-forwarding, and agentic wallet transactions — into a single queryable ledger. You can also export transaction history as PDF or CSV files.

​
Why Unified Transactions

Instead of querying separate endpoints for each transaction type, the unified system gives you:
  • One endpoint to list all transactions regardless of type
  • Consistent schema across deposits, withdrawals, swaps, card spends, IBAN transfers, and more
  • Export to PDF (branded) or CSV for accounting and compliance
  • Fee tracking with per-transaction fee breakdowns
  • Analytics with aggregated volume, fee totals, and type distribution

​
List Unified Transactions

curl -X GET 'https://crypto-api.yativo.com/api/v1/unified-transactions/list?page=1&limit=20' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
Response
{
  "success": true,
  "data": {
    "transactions": [
      {
        "transaction_id": "utx_01abc123",
        "type": "deposit",
        "status": "completed",
        "amount": "500.00",
        "asset": "USDC",
        "chain": "solana",
        "from_address": "7xKXtg2CW87d...",
        "to_address": "GY1EZGdpiJNyx...",
        "tx_hash": "5xYz...",
        "fee_amount": "0.00",
        "created_at": "2026-03-26T10:00:00Z"
      },
      {
        "transaction_id": "utx_02def456",
        "type": "card_transaction",
        "status": "completed",
        "amount": "25.99",
        "asset": "EUR",
        "merchant_name": "Amazon",
        "card_last_four": "4242",
        "created_at": "2026-03-26T11:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 150
    }
  }
}

​
Transaction Types

TypeDescription
depositIncoming crypto deposit
withdrawalOutbound crypto transfer
swapToken swap (cross-chain or same-chain)
feePlatform fee deduction
auto_forwardingAutomatically forwarded deposit
card_transactionYativo Card spend at a merchant
iban_transferIBAN bank transfer (EUR)
gateway_paymentCrypto payment gateway receipt
agentic_transactionAI agent wallet transaction

​
Get Transaction Details

curl -X GET 'https://crypto-api.yativo.com/api/v1/unified-transactions/utx_01abc123' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

​
Calculate Fees

Preview the fees for a transaction before executing: 
curl -X POST 'https://crypto-api.yativo.com/api/v1/unified-transactions/calculate-fees' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "withdrawal",
    "amount": "100.00",
    "chain": "ethereum"
  }'

​
Analytics

Get aggregated transaction analytics with fee breakdowns: 
curl -X GET 'https://crypto-api.yativo.com/api/v1/unified-transactions/analytics-with-fees' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

​
Export Transactions

Export your transaction history as a branded PDF report or a CSV spreadsheet.

​
Request an Export

curl -X POST 'https://crypto-api.yativo.com/api/v1/unified-transactions/export' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "format": "pdf",
    "date_from": "2026-03-01",
    "date_to": "2026-03-31",
    "types": ["deposit", "withdrawal", "swap"]
  }'
Response
{
  "success": true,
  "data": {
    "export_id": "exp_01abc123",
    "format": "pdf",
    "status": "processing",
    "created_at": "2026-04-01T12:00:00Z"
  }
}

​
List Exports

curl -X GET 'https://crypto-api.yativo.com/api/v1/unified-transactions/export/list' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

​
Download an Export

curl -X GET 'https://crypto-api.yativo.com/api/v1/unified-transactions/export/exp_01abc123/download' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --output transactions.pdf
Export files are available for 24 hours after generation.

​
Next Steps

API Reference

Full endpoint reference for unified transactions.

Webhooks

Get notified on transaction events.

Analytics

Dashboard-level transaction analytics.