# Ventuals

Pre-market perpetual markets. USDH-margined.

**Launch date:** November 2025\
**Data available from:** 2025-11-13 (complete history since launch)\
**Collateral token:** USDH\
**Dex identifier:** `vntl`\
**Example markets:** `vntl:ANTHROPIC`, `vntl:SPACEX`

## Datasets

**Bucket:** `s3://hydromancer-reservoir` (requester pays)

| Dataset                        | Path                                                                 |
| ------------------------------ | -------------------------------------------------------------------- |
| **All fills**                  | `by_dex/vntl/fills/perp/all/date=YYYY-MM-DD/fills.parquet`           |
| **Liquidations**               | `by_dex/vntl/fills/perp/liquidations/date=YYYY-MM-DD/fills.parquet`  |
| **ADL**                        | `by_dex/vntl/fills/perp/adl/date=YYYY-MM-DD/fills.parquet`           |
| **Builder fills**              | `by_dex/vntl/fills/perp/builder_fills/date=YYYY-MM-DD/fills.parquet` |
| **TWAP fills**                 | `by_dex/vntl/fills/perp/twap_fills/date=YYYY-MM-DD/fills.parquet`    |
| **Candles**                    | `by_dex/vntl/candles/1s/date=YYYY-MM-DD/candles.parquet`             |
| **Perp positioning snapshots** | `by_dex/vntl/snapshots/perp/date=YYYY-MM-DD/*.parquet`               |

Sub-dataset files are only created for dates with data. If a file is missing, there were no events of that type on that date.

## Quick Start

```sql
INSTALL httpfs;
LOAD httpfs;
SET s3_region = 'ap-northeast-1';

-- All Ventuals fills for a day
SELECT timestamp, coin, base_symbol, side, price, size, direction
FROM read_parquet('s3://hydromancer-reservoir/by_dex/vntl/fills/perp/all/date=2026-03-22/fills.parquet')
ORDER BY timestamp;

-- Volume by market
SELECT base_symbol, sum(price * size) as volume_usd, count(*) as trades
FROM read_parquet('s3://hydromancer-reservoir/by_dex/vntl/fills/perp/all/date=2026-03-22/fills.parquet')
GROUP BY base_symbol ORDER BY volume_usd DESC;
```

For schema details see: [Fills](https://github.com/hydromancerxyz/docs/blob/main/reservoir/fills.md) · [Candles](/reservoir/schema-reference/candles.md) · [Snapshots](/reservoir/schema-reference/snapshots.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hydromancer.xyz/reservoir/ventuals.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.