The draft API, documented.
A draft, symbol-level API surface for the same organized record the dashboard reads. Clean JSON, no counterparty field.
API Reference
The five draft endpoints, each addressable by symbol, with the key fields each returns.
Jump →Data Dictionary
Every field defined in plain language: units, signs, and what each measure means.
Jump →Examples
A request and the JSON it returns, including the signed change fields and the missing counterparty field.
Jump →Limits
How freshness is reported and how missing data is handled.
Jump →One request, notional by symbol.
Authenticate with a bearer token and ask for any covered symbol. The response is flat, signed, and free of any counterparty field by design. Figures shown are samples.
GET /v1/notional-outstanding?symbol=NVDA Host: api.vantapool.com Authorization: Bearer <your_api_key> Accept: application/json
{ "symbol": "NVDA", "reference_security": "NVIDIA Corporation", "notional_outstanding_usd": 109350000000, "open_contracts": 29146, "net_notional_change_usd": 142300000, "added_usd": 1203500000, "reduced_usd": -1061200000, "pct_vs_market": 69, "as_of": "2026-07-17" }
No counterparty field is returned, and that is the design. VantaPool reports public swap activity by reference security only. Every figure is symbol-level, signed, and typed: reduced_usd is returned negative, so added_usd plus reduced_usd equals net_notional_change_usd. Figures shown are samples.
Five endpoints. One spine.
Notional outstanding, daily added and reduced notional, upcoming expirations, rankings, and price context, each addressable by symbol. All accept a ?symbol= query.
All endpoints return an as_of timestamp.
Every term, defined plainly.
The output vocabulary. Each measure describes reported, public swap activity: an event or a quantity, not a direction or an intent.
Notional Outstanding
Total notional of contracts still on the book.
Net Notional Change
Buys minus sells over the window: notional added minus notional reduced, as a signed figure.
Buy / Sell
Buy and sell measure size changes on existing contracts: an increase is a buy, a reduction or close is a sell. Newly opened contracts are counted separately as New.
Swap Volume
Gross $ flow over the window, regardless of net direction. The window is part of the label: Swap Volume · 5D.
Expiration
The scheduled date on which a reported contract reaches the end of its term. The field is expiration_date.
Upcoming Expirations
Notional outstanding scheduled to expire on a given date or within a window, by symbol.
% vs Market
The market price vs the price these swaps were struck at.
Avg Price
Average price these swaps were struck at: total notional ÷ total quantity.
Open Contracts
Contracts still on the book. Like open interest, for swaps.
What the data is, and what it is not.
Every endpoint returns an as_of timestamp so you can confirm which session a figure belongs to.
When a symbol has no reported activity for a session, its change fields return zero rather than a guess. Missing data is reported as missing, not interpolated. Figures shown across these docs are samples for documentation.
% vs Market sets the market price against the price these swaps were struck at. It is a reference distance only, not a profit, loss, or return measure. Added and Reduced are activity events.