# Transactions (Coinbax Core API)

> Source: https://developers.coinbax.com/reference/coinbax-core/transactions/
> Staging base URL: https://core-staging.coinbax.com/api/v1

Global transaction management

## List transactions

`GET /transactions`

- Auth: Bearer token
- Operation ID: `listTransactions`

Retrieve a paginated list of transactions. Transactions are aggregated from all
connected platforms (via platform mappings) or from the global API key.

**Filtering:**
- Filter by status, date range, addresses, wallet address

**Pagination:**
- Default: 20 items per page
- Max: 100 items per page

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `page` | query | integer | no | Page number (1-indexed) |
| `limit` | query | integer | no | Items per page |
| `status` | query | enum ("PENDING", "ESCROWED", "IN_REVIEW", "COMPLETED", "FAILED", "CANCELLED") | no | Filter by transaction status |
| `dateFrom` | query | string (date-time) | no | Start date filter (ISO 8601) |
| `dateTo` | query | string (date-time) | no | End date filter (ISO 8601) |
| `fromAddress` | query | string | no | Filter by sender wallet address |
| `toAddress` | query | string | no | Filter by receiver wallet address |
| `walletAddress` | query | string | no | Filter by either sender or receiver address |

### Example request

```bash
curl https://core-staging.coinbax.com/api/v1/transactions \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

### Responses

**200** Transaction list retrieved successfully

```json
{
  "success": true,
  "data": {
    "data": [
      {
        "id": "tx_abc123",
        "status": "COMPLETED",
        "amount": "100.00",
        "currency": "USDC",
        "fromAddress": "0x1234567890abcdef1234567890abcdef12345678",
        "toAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
        "blockchainNetwork": "base",
        "chainId": 8453,
        "txHash": "0xabcd...ef12",
        "createdAt": "2026-02-24T10:00:00.000Z",
        "_platformName": "Main Platform",
        "_platformId": "platform_xyz"
      }
    ],
    "meta": {
      "total": 150,
      "page": 1,
      "limit": 20,
      "totalPages": 8,
      "platformCount": 3
    }
  },
  "meta": {
    "timestamp": "2026-02-24T12:00:00.000Z",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}
```

**401** Unauthorized - missing or invalid authentication

**500** Internal server error

---

## Get transaction by ID

`GET /transactions/{id}`

- Auth: Bearer token
- Operation ID: `getTransaction`

Retrieve a transaction by its unique identifier.

The transaction is searched across all connected platforms.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string (uuid) | yes | Transaction UUID |

### Example request

```bash
curl https://core-staging.coinbax.com/api/v1/transactions/<id> \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

### Responses

**200** Transaction found

```json
{
  "success": true,
  "data": {
    "id": "tx_550e8400-e29b-41d4-a716-446655440000",
    "status": "COMPLETED",
    "amount": "100.00",
    "currency": "USDC",
    "fromAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "toAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
    "blockchainNetwork": "base",
    "chainId": 8453,
    "txHash": "0xabcdef1234567890abcdef1234567890abcdef12345678901234567890abcdef12",
    "orchestrationType": "raw",
    "metadata": {
      "workspaceId": "123e4567-e89b-12d3-a456-426614174000"
    },
    "createdAt": "2026-02-24T10:00:00.000Z",
    "updatedAt": "2026-02-24T10:05:00.000Z",
    "_platformName": "Main Platform",
    "_platformId": "platform_xyz"
  },
  "meta": {
    "timestamp": "2026-02-24T12:00:00.000Z",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}
```

**401** Unauthorized - missing or invalid authentication

**404** Resource not found

**500** Internal server error

---

## Get transaction statistics

`GET /transactions/stats`

- Auth: Bearer token
- Operation ID: `getTransactionStats`

Retrieve aggregated transaction statistics across all connected platforms.

Returns counts and totals grouped by transaction status.

### Example request

```bash
curl https://core-staging.coinbax.com/api/v1/transactions/stats \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

### Responses

**200** Transaction statistics retrieved successfully

```json
{
  "success": true,
  "data": {
    "COMPLETED": {
      "count": 1500,
      "total_amount": "150000.00"
    },
    "PENDING": {
      "count": 25,
      "total_amount": "2500.00"
    },
    "ESCROWED": {
      "count": 10,
      "total_amount": "1000.00"
    },
    "IN_REVIEW": {
      "count": 5,
      "total_amount": "500.00"
    },
    "FAILED": {
      "count": 15,
      "total_amount": "1500.00"
    },
    "CANCELLED": {
      "count": 8,
      "total_amount": "800.00"
    }
  },
  "meta": {
    "timestamp": "2026-02-24T12:00:00.000Z",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}
```

**401** Unauthorized - missing or invalid authentication

**500** Internal server error