Unified Transactions

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

Type	Description
`deposit`	Incoming crypto deposit
`withdrawal`	Outbound crypto transfer
`swap`	Token swap (cross-chain or same-chain)
`fee`	Platform fee deduction
`auto_forwarding`	Automatically forwarded deposit
`card_transaction`	Yativo Card spend at a merchant
`iban_transfer`	IBAN bank transfer (EUR)
`gateway_payment`	Crypto payment gateway receipt
`agentic_transaction`	AI 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.

Overview

Wallets & Assets

Transactions

Yativo Card

Payment Gateway

Agentic Wallets

IBAN

Automation

Compliance

B2B

Developer Tools

Tutorials

SDKs

Browser Extensions (Coming Soon)

Sandbox

Unified Transactions

Why Unified Transactions

List Unified Transactions

Transaction Types

Get Transaction Details

Calculate Fees

Analytics

Export Transactions

Request an Export

List Exports

Download an Export

Next Steps

API Reference

Webhooks

Analytics

​Why Unified Transactions

​List Unified Transactions

​Transaction Types

​Get Transaction Details

​Calculate Fees

​Analytics

​Export Transactions

​Request an Export

​List Exports

​Download an Export

​Next Steps

API Reference

Webhooks

Analytics

Why Unified Transactions

List Unified Transactions

Transaction Types

Get Transaction Details

Calculate Fees

Analytics

Export Transactions

Request an Export

List Exports

Download an Export

Next Steps