…

petral Quantitative API & Workflow Interoperability

Every dataset on petral is available for programmatic integration into Python models, Excel sheets, and automated workflows. Public endpoints are accessible with your personal desk API key across headers or URL parameters.

🔒Personal Desk API Key Access

Sign in or create a free account to obtain your personal desk API key for programmatic quantitative analysis, Jupyter notebooks, and automated Excel spreadsheets.

Base URL

https://petral2.vercel.app

Interactive Swagger ↗OpenAPI Schema ↗Health Check ↗

Prices & curves

/api/benchmarksBenchmark registry (WTI/Brent/RBOB/HO)

/api/curve/{key}Forward curve + Nelson-Siegel fit + structure

/api/curves/{key}Accrued daily curve snapshots (scrubber)

/api/history/{key}?window=Front-month price history

/api/term-structure/{key}Calendar spreads, carry, z-scores

/api/marketsLive tile board (crude/products/spread/macro)

/api/candles/{market}?tf=OHLC candles (1m/5m/15m/1h/1D)

/api/screenerCross-market screener (~136 symbols)

Fundamentals & positioning

/api/eiaEIA weekly inventories (live)

/api/cot/{key}CFTC Commitments of Traders (live)

/api/refineryRefinery utilization - EIA WPSR (live)

/api/productionUS crude production (live)

/api/cracksCrack spreads - computed from live WTI/RBOB/HO

/api/grade-diffsGrade differentials (Brent-WTI live)

Macro, physical & flows

/api/macroDXY / US10Y / VIX / copper / SPX (live)

/api/fxFX pairs

/api/arbArb route economics

/api/storageCash-and-carry storage economics

/api/freightVLCC routes + bunkers

/api/ais/captureGlobal tanker capture - positions, size class, direction

/api/ais/capture-historyPer-region tanker counts over time

/api/weatherGulf Coast alerts + Atlantic hurricanes (live)

News & synthesis

/api/newsHeadlines + risk flags (live RSS)

/api/synthesisMorning brief - bullets + calendar

Terms. CORS is open for read-only use. Please cache responses and be gentle - this runs on a serverless tier. No auth required. Data is aggregated from free public sources (EIA, FRED, CFTC, yfinance, RSS); attribution to those sources is your responsibility. Not investment advice. Every table on the site also exports to CSV via the ↓ csv button.