> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rwa.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Transactions

> On-chain transaction data endpoints

Get on-chain transaction data for RWA tokens, including mints, burns, and transfers.

<Note>
  Transaction data is only available for RWA tokens. Stablecoin transactions (e.g., USDC, USDT) are not included.
</Note>

<Warning>
  This endpoint is rate limited to **120 requests per hour** per organization. See [Rate Limits](/api/overview#rate-limits) for details.
</Warning>

## GET /v4/transactions

Returns a list of transactions with filtering, sorting, and pagination.

**Default sort:** `date` descending | **Default page size:** 25

### Fields

| Field                 | Type     | Filterable | Description                         |
| --------------------- | -------- | :--------: | ----------------------------------- |
| `id`                  | number   |     Yes    | Unique transaction identifier       |
| `date`                | datetime |     Yes    | Transaction date                    |
| `timestamp`           | string   |     Yes    | Transaction timestamp               |
| `transaction_hash`    | string   |     Yes    | On-chain transaction hash           |
| `amount`              | number   |     Yes    | Transaction amount (in token units) |
| `usd_amount`          | number   |     Yes    | Transaction amount (USD)            |
| `to_address`          | string   |     Yes    | Recipient wallet address            |
| `from_address`        | string   |     Yes    | Sender wallet address               |
| `transaction_type_id` | number   |     Yes    | Transaction type identifier         |
| `token_id`            | number   |     Yes    | Associated token ID                 |
| `asset_id`            | number   |     Yes    | Associated asset ID                 |
| `asset_class_id`      | number   |     Yes    | Associated asset class ID           |
| `protocol_id`         | number   |     Yes    | Associated platform ID              |
| `network_id`          | number   |     Yes    | Associated network ID               |

Each transaction result also includes nested `asset`, `token`, and `transaction_type` objects with details.

### Example Request

```bash theme={null}
curl -G 'https://api.rwa.xyz/v4/transactions' \
  -H "Authorization: Bearer $RWA_API_KEY" \
  --data-urlencode 'query={
    "filter": {
      "operator": "and",
      "filters": [
        {
          "operator": "equals",
          "field": "asset_class_id",
          "value": 1
        },
        {
          "operator": "gte",
          "field": "usd_amount",
          "value": 1000000
        }
      ]
    },
    "sort": { "field": "date", "direction": "desc" },
    "pagination": { "page": 1, "perPage": 10 }
  }'
```

### Example Response

```json theme={null}
{
  "results": [
    {
      "id": "1-0x9d60a645b0a92c98...-42",
      "date": "2026-03-17T00:00:00.000Z",
      "timestamp": "2026-03-17T11:02:59.000Z",
      "transaction_hash": "0x9d60a645b0a92c98...",
      "amount": 22331806.95,
      "usd_amount": 24995829.91,
      "from_address": "0xfd78ee919681417d...",
      "to_address": "0x0000000000000000...",
      "transaction_type": {
        "id": 2,
        "slug": "token-burn",
        "name": "Token Burn",
        "description": "Tokens are destroyed and removed from the circulating supply."
      },
      "token": {
        "id": "20",
        "asset_id": "51",
        "network_name": "Ethereum",
        "address": "0x136471a34f..."
      },
      "asset": {
        "id": "51",
        "name": "Circle USYC",
        "asset_class_name": "US Treasury Debt"
      }
    }
  ],
  "pagination": { "page": 1, "perPage": 10, "pageCount": 312, "resultCount": 3118 }
}
```

## GET /v4/transactions/meta

Returns [metadata](/api/meta) about available fields, filter operators, and select options for the transactions endpoint.

### Example Request

```bash theme={null}
curl -X GET "https://api.rwa.xyz/v4/transactions/meta" \
  -H "Authorization: Bearer $RWA_API_KEY"
```