# Novig API: which Novig data source to use

> Independent. Not affiliated with, endorsed by or sponsored by Novig.

Canonical: https://novigapi.com/novig-api
Facts checked: 2026-11-12

To trade, use Novig's official API at docs.novig.com, which needs an account, KYC, signed keys and a location check. To read data, Novig's free daily CSVs start on 3 Aug 2026, checked 12 Nov 2026. For intraday history, names and fair prices without a Novig account, use novigapi.com. (Source: [data.novig.com manifest (index.json)](https://data.novig.com/reporting/trade-data/index.json))

Novig has an official API and free daily data files. novigapi.com is an independent, read-only layer on top: no Novig account, names resolved, intraday line history, fair prices and alerts. Below is what each source does, what it requires, and which one fits your job.

## 1. The official Novig trading API

Novig's API lives at [docs.novig.com](https://docs.novig.com/index.md) and describes itself as a way to trade sports contracts on the Novig exchange. It publishes an OpenAPI 3.1 spec titled Novig API 3.0.0. What it requires, checked 12 Nov 2026:

- **An account and keys.** You create a management key in your Novig profile. It opens and funds subaccounts, and each subaccount gets its own trading key.
- **Signed requests.** Every request is signed with NOVIG-V3 using Ed25519 or P-256, sent as `Novig-Key-Id`, `Novig-Timestamp` and `Novig-Signature` headers. The timestamp must be within 30 seconds.
- **Identity and location checks.** Production at `api.novig.com` runs a real identity check and a location check. Paper, at `api.paper.novig.com`, is play money with no location check and a simulated profile.
- **Blocked states.** Novig's help center says it is unavailable to anyone physically in Nevada, Arizona or Michigan; you must be 21 or older.
- **One WebSocket.** It uses the REST host and carries four channels: `book` (every order-book change), `tape` (every execution), `lifecycle` (market status, including `GOLIVE`) and `private` (your orders and positions).
- **Rate limits.** Token buckets per subaccount and per management key. At the Base tier the refill rates are 8 Hz for `place`, 16 Hz for `cancel` and `read`, 8 Hz for `account`, 32 Hz for `stream` and 4 Hz for `history`. Tiers multiply these by monthly volume, and an edge filter also limits each IP. Over the limit you get a 429 with `Retry-After`.

Novig's OpenAPI also carries a Public tag, described as catalog reads without a signature, cached at the edge. Read the spec to see which routes it covers. Placing orders always needs the signed, verified account.

## 2. Novig's free daily CSVs

Novig publishes two anonymized files for every trading day at [data.novig.com](https://docs.novig.com/public-data/overview.md), each covering midnight to midnight Eastern and published around 5 a.m. ET the next morning:

- `trades.csv`: every executed trade, one row per side.
- `markets.csv`: one row per market per day with `date`, `marketId`, `reportTicker`, `openInterest`, `dailyVolume`, `open`, `high`, `low`, `close` and `status`. Prices are cents to one decimal, so a close of 47.5 is a probability of 0.475.
- `index.json`: the manifest. On 12 Nov 2026 it listed trades from 3 Aug 2026 and markets from 4 Aug 2026, through 11 Nov 2026.

Rows identify no trader, wallet or order, and they carry no player or team names: a market is an ID plus a product family such as `MLB-SPREAD`. If a day's trades fail validation, Novig withholds that trades file and still publishes the markets file.

## 3. novigapi.com

novigapi.com is an independent read-only Novig market data API. You need a novigapi key, not a Novig account, and there is no signing or location check. It adds what the two official sources leave out for readers:

- Player and team names joined to every market.
- Intraday line history from our own snapshots, on top of the CSV backfill from 3 Aug 2026.
- Fair prices, line moves, closing line value, OHLC and the order book, from `/markets`, `/orderbook/{id}`, `/line-history`, `/fair-price`, `/line-moves`, `/clv` and more.
- Webhooks for line moves over a threshold, steam, market open and settle, and a stream at `wss://stream.novigapi.com/v1/stream`.
- An MCP server at `https://novigapi.com/api/mcp` with tools for markets, props, line history, fair price and devig.

Freshness: REST data on paid plans is at most about 10 seconds old, and the stream pushes changes within 5 to 30 seconds. It cannot place orders.

novigapi.com plans, checked 12 Nov 2026

| Plan | Price | Credits a month | Requests a minute | Stream |
| --- | --- | --- | --- | --- |
| Free | $0 | 100 | 20 | 1 connection, delayed 300 s |
| Developer | $49/mo | 10,000 | 60 | 3 live connections |
| Production | $149/mo | 50,000 | 120 | 10 live connections, signed webhooks |
| Scale | $499/mo | 250,000 | 180 | 15 live connections, signed webhooks |


A one-time $9 top-up adds 1,000 credits that never expire. There are no automatic overage charges.

```bash
curl -s "https://novigapi.com/api/v1/markets?league=NFL&limit=5" \
  -H "Authorization: Bearer nv_..."
```

## 4. Odds feeds that carry Novig

General odds feeds listing Novig, checked 12 Nov 2026

| Provider | How it lists Novig | Entry price | Best for |
| --- | --- | --- | --- |
| OpticOdds | Novig page beside 100+ books | Not published | Enterprise platforms |
| SportsGameOdds | bookmakerID novig, with fairOdds | Free Amateur tier | Comparing Novig with sportsbooks |
| OddsPapi | novig.us, live odds flagged | Free tier | Wide book coverage |
| SharpAPI | Novig on any paid plan | $79/mo Hobby | +EV and no-vig fields |
| TheRundown | Affiliate ID 30 | Free; Starter $49/mo | Lines and props beside 25+ books |
| PredictionData | Novig among 200+ books and markets | Book a demo | Unified prediction-market data |


These feeds treat Novig as one column among many. That is ideal for price shopping, but none of their Novig pages advertises Novig open interest or a full trade tape. Compare them in detail on [Novig API alternatives](https://novigapi.com/compare/novig-api-alternatives).

## Common mistakes

- **Mixing Paper and Production keys.** A key works only where it was created; Production rejects a Paper key with `api key not found`.
- **Overstating fees 100 times.** Novig's fee docs warn that the API `qty` field is in minimal units, so contracts = qty / 100 before you apply 0.06 x P x (1 - P).
- **Assuming fixed CSV columns.** Novig says it may add columns, so read the header row.
- **Ignoring GOLIVE.** Every `GOLIVE` on the lifecycle channel voids resting orders on that event, and it is also when game-market fees start.

## Which one to use

If you need X, use Y (checked 12 Nov 2026)

| If you need | Use |
| --- | --- |
| To place or cancel orders | Official Novig API (docs.novig.com) |
| Your own fills, positions and balances | Official Novig API |
| Every Novig trade, free, once a day | data.novig.com CSVs |
| Novig prices with player and team names, no Novig account | novigapi.com |
| Intraday Novig line history or line-move alerts | novigapi.com |
| No-vig fair prices from Novig's book | novigapi.com, or the [no-vig calculator](https://novigapi.com/no-vig-calculator) by hand |
| Novig beside 25 to 300 sportsbooks | An odds feed: SportsGameOdds, OddsPapi, TheRundown, SharpAPI, OpticOdds or PredictionData |
| Novig data inside an AI agent | novigapi.com MCP server |


## Questions

### Does Novig have an API?

Yes. Novig documents a signed REST and WebSocket trading API at docs.novig.com. Production keys need a Novig account, identity checks and a location check; Paper is play money without the location check (checked 12 Nov 2026).

### Is there a Novig API without an account?

For reading, yes. Novig's daily CSVs at data.novig.com need no account, and its OpenAPI tags some catalog reads as public. novigapi.com needs only a novigapi key, not a Novig account. Trading always needs a verified Novig account (checked 12 Nov 2026).

### Does Novig have historical data?

Novig's free CSVs list trades from 3 Aug 2026 and market snapshots from 4 Aug 2026, one file per day, with no names (manifest checked 12 Nov 2026). novigapi.com adds intraday line history from its own snapshots.

### What are Novig's API rate limits?

Novig meters each subaccount and management key with token buckets. At the Base tier, refill rates are 8 Hz to place, 16 Hz to cancel or read, 8 Hz for account routes, 32 Hz for stream and 4 Hz for history; higher tiers multiply them (checked 12 Nov 2026).

### Is novigapi.com the official Novig API?

No. novigapi.com is independent and read-only. Novig's official API is at docs.novig.com and is the only way to trade on Novig.

## Sources

- [Novig docs: API overview](https://docs.novig.com/index.md)
- [Novig docs: Environments](https://docs.novig.com/api/environments.md)
- [Novig docs: Throttling](https://docs.novig.com/api/throttling.md)
- [Novig docs: Get the geolocation status](https://docs.novig.com/api-reference/accounts/get-the-geolocation-status.md)
- [Novig docs: llms.txt index](https://docs.novig.com/llms.txt)
- [Novig Help Center: Eligibility & Legality](https://support.novig.com/en/articles/16194031-eligibility-legality)
- [Novig docs: Exchange Data](https://docs.novig.com/public-data/overview.md)
- [Novig docs: Markets CSV](https://docs.novig.com/public-data/markets.md)
- [data.novig.com manifest (index.json)](https://data.novig.com/reporting/trade-data/index.json)
- [OpticOdds: Novig page](https://opticodds.com/sportsbooks/novig-api)
- [SportsGameOdds: Novig bookmaker page](https://sportsgameodds.com/bookmakers/novig-odds-api)
- [OddsPapi: Novig US page](https://oddspapi.io/sportsbooks/novig-us)
- [SharpAPI: Novig page](https://sharpapi.io/sportsbooks/novig-odds-api)
- [TheRundown: Novig page](https://therundown.io/novig-odds-api)
- [PredictionData: Novig page](https://predictiondata.io/us/api-data/novig)

---

Get a free API key: https://novigapi.com/sign-up . Docs: https://novigapi.com/docs . MCP: https://novigapi.com/api/mcp . Operated by Stunning Couches LLC. Independent. Not affiliated with, endorsed by or sponsored by Novig.