# Marilux

> Marilux (https://marilux.dev/en) is a US market data API for developers: historical and real-time data for US stocks, ETFs and options, including aggregate bars, trades and quotes, option chains with Greeks, and WebSocket streaming. Endpoint paths and responses match the Polygon.io API, so the Polygon SDKs (polygon-api-client, @polygon.io/client-js) work by changing the API key and base URL. Prices in USD, paid in crypto (USDT, USDC and other major coins) via an online checkout. Operated by WY Studio LLC.

## Products

- [US stock market data API](https://marilux.dev/en/stocks): Starter is delayed ~15 minutes with 5 years of history; Advanced is real-time with 20+ years of history, trades, NBBO quotes, financials, short data and WebSocket streaming.
- [US options data API](https://marilux.dev/en/options): contracts, chain snapshots with Greeks, IV and open interest, options bars, trades and quotes, 5+ years of history; standalone or on the same key as stocks.
- [Flat Files](https://marilux.dev/en/docs/flatfiles): full-market daily and minute bars per trading day (gzip CSV).
- Not available: indices, forex, futures.

## Pricing (USD)

- Stocks Starter: $6.99/month, $18.99/quarter, $35.99/6 months, $69.99/year
- Stocks Advanced: $16.99/month, $45.99/quarter, $87.99/6 months, $169.99/year
- Options: $16.99/month, $45.99/quarter, $87.99/6 months, $169.99/year
- Traffic packs: 60 GB $5.99 (Starter), 120 GB $9.99 (Advanced/Options), valid 90 days
- Free 3-day Advanced trial after email verification, no card, never auto-charges
- Plans are prepaid and don't auto-renew. Details: [pricing](https://marilux.dev/en/pricing), [refund policy](https://marilux.dev/en/refund)

## Integration

- Base URL: https://marilux.dev
- Auth: header `Authorization: Bearer <API key>` or query `apiKey=<API key>`
- WebSocket: wss://marilux.dev/stocks (Advanced, Polygon-compatible protocol)
- Python: `RESTClient(api_key="mh_live_...", base="https://marilux.dev")`

## Docs

- [Quick start](https://marilux.dev/en/docs): Swap in your API key and base URL and keep using the Polygon SDK you already know.
- [Stocks endpoints](https://marilux.dev/en/docs/stocks): Bars, snapshots, reference data and corporate actions for US stocks and ETFs; Advanced adds trades, quotes, financials and short data.
- [WebSocket streaming](https://marilux.dev/en/docs/websocket): Advanced only: real-time trades and quotes over WebSocket, using the same protocol as Polygon.
- [Options data](https://marilux.dev/en/docs/options): Contracts, chain snapshots with Greeks, IV and open interest, options bars, trades and quotes.
- [Flat Files](https://marilux.dev/en/docs/flatfiles): Full-market daily and minute bars packaged per trading day — the fast way to load a backtest database.
- [Headers & limits](https://marilux.dev/en/docs/limits): How calls, rate, concurrency and traffic quotas are counted, and how to read them from response headers.
- [Errors](https://marilux.dev/en/docs/errors): What each status code and error message means, and what to do about it.
- [Full docs as plain text](https://marilux.dev/en/llms-full.txt)
- [OpenAPI 3.1 spec](https://marilux.dev/en/openapi.json): every REST endpoint with parameters and response schemas; import into Postman or generate a client

## Contact

- Email: Contact@marilux.dev

## Guides

- [Get a US option chain with Greeks in Python](https://marilux.dev/en/guides/python-option-chain): Pull the full option chain for one expiration and read prices, implied volatility and the Greeks for every contract. Plain requests, no SDK, and the complete script runs as is.
- [Use the Polygon Python SDK with Marilux](https://marilux.dev/en/guides/polygon-sdk): Our endpoint paths and response shapes match the Polygon API, so the official Python SDK works as is. Pass your Marilux API key and base URL when you create the client and leave the rest of your code alone.

## Options basics

- [Option Greeks explained: delta, gamma, theta, vega](https://marilux.dev/en/learn/option-greeks): The Greeks measure how sensitive an option's price is to each thing that moves it. We'll read them one by one off a real AAPL option chain.
- [What is implied volatility (IV)?](https://marilux.dev/en/learn/implied-volatility): Implied volatility is the market's expectation of future price swings, backed out of the option's price. It's the standard way to tell whether an option is cheap or expensive.
- [US option symbols explained](https://marilux.dev/en/learn/option-symbol): Every US option contract has a unique symbol, such as O:AAPL261023C00345000. Once you can read it, you can build the symbol for any contract yourself.