---
title: "List private transactions"
method: GET
path: "/v1/private-transactions"
tags: ["Private Transactions"]
---

# List private transactions

`GET /v1/private-transactions`

## Request

- Base URL: `https://api.liquidcompute.co`
- URL: `https://api.liquidcompute.co/v1/private-transactions`
- Auth: API key in header `X-API-Key`

Returns individual private transaction records, newest first
(`date` descending). There is no pagination: the full filtered
window is returned in one response.

H100 coverage begins September 2024; B200 coverage begins August
2025; additional models are added as data arrives. Each data
refresh replaces the full record set for a GPU model with a new
snapshot — an irregular cadence, not real time. Records returned
by an earlier request may therefore be restated or removed by a
later refresh, not only added to, and responses carry no snapshot
identifier tying a record to the refresh that produced it.

Included with Enterprise. Requires the `private-txns` entitlement
family; requests without it return `404` `not_found`.

## Query parameters

- `gpu_model` 'a100' | 'h100' | 'h200' | 'b200' | 'b300'
- `contract_type` 'reserved' | 'on-demand' | 'spot'
- `region` 'us' | 'eu' | 'apac' | 'global' | 'global+us' | 'apac+us'
- `start` string, date
- `end` string, date

## Response `200`

Private transaction records.

- PrivateTransactionsResponse
  - `data` PrivateTransaction[], required
    - `gpu_model` 'a100' | 'h100' | 'h200' | 'b200' | 'b300', required
    - `contract_type` 'reserved' | 'on-demand' | 'spot', required
    - `term_days_min` integer, nullable, required: Minimum contracted term in days; null for on-demand and spot deals.
    - `term_days_max` integer, nullable, required: Maximum contracted term in days; equals term_days_min for single-term deals, null for on-demand and spot deals.
    - `price_usd_gpu_hr` number, required: Volume-weighted average price in USD per GPU-hour.
    - `discount_pct` integer, nullable, required: Percentage off list price; null when the discount was not shown for the deal (null is not 0).
    - `gpu_count` integer, required
    - `region` 'us' | 'eu' | 'apac' | 'global' | 'global+us' | 'apac+us', required
    - `date` string, date, required
    - `is_rolling` boolean, required: True when the deal rolls (auto-renews) from the stated date.
  - `total_count` integer, required
  - `filters` object, required: Echoes only the query parameters present on the request.
    - `gpu_model` string
    - `contract_type` string
    - `region` string
    - `start` string
    - `end` string

## Other responses

- `400`: Invalid or unsupported query parameter.
- `401`: Missing or invalid API key.
- `404`: Unknown endpoint, unavailable resource, or an index or index family outside your authorization.
- `429`: Rate limit exceeded.
- `502`: Upstream service or gateway configuration failure.
- `503`: API-key validation is temporarily unavailable.

---

[API](https://skmtc.dev/liquidcompute/apis/liquidcompute-api.md) - [All operations](https://skmtc.dev/liquidcompute/apis/liquidcompute-api/llms.txt) - [OpenAPI document](https://skmtc.dev/liquidcompute/apis/liquidcompute-api/revisions/f58bc0aabb07?raw)