Narwhal API vs Polymarket API

Narwhal gives Kalshi and Polymarket odds one schema for economic releases, central bank decisions, metals and energy. Polymarket separates metadata, activity and trading across three REST hosts. Choose Narwhal for shared venue data, or Polymarket for direct venue integration.

Decision

Choose Narwhal for supported economic and commodity odds from both venues through REST and MCP. Choose Polymarket API for direct Polymarket reads, order books and order management.

At a glance

Narwhal normalizes supported topics across two venues; Polymarket API serves Polymarket directly. Narwhal API is owned and operated by Nusantara Ventures, LLC.

RequirementNarwhal APIPolymarket API
Free tier✓ 5,000 requests/month✓ Public reads; no authentication
Cheapest paid planBasic: $59/month; $590/year availableNot published
Update speedFree: previous day's close; Basic/Pro: livePublic WebSocket market channel
HistoryFree: 12 months; Basic: 5 years; available records onlyCLOB price points; no volume per bar
CoverageKalshi/Polymarket: economics, central banks, metals, energyPolymarket only
InterfacesREST, MCP; Basic/Pro: WebSocketThree REST hosts and public WebSocket
SDKs✓ Official Python and TypeScript SDKs✓ TypeScript and Python
Commercial use on free tier✓ Commercial apps; resale needs EnterpriseNot compared on this page

Price at your usage

Prices refer to public reads; order management requires wallet-derived credentials.

Requests per monthNarwhal APIPolymarket API
1,000Free: $0/monthPublic API: $0
10,000Basic: $59/monthPublic API: $0
100,000Basic: $59/monthPublic API: $0

Switch in a few minutes

List prediction topics

Polymarket API

# Change: URL
curl --get \
  "https://gamma-api.polymarket.com/events" \
  --data-urlencode "limit=25"

Narwhal API

# Change: URL and key
curl \
  "https://api.narwhalapi.com/v1/predictions/topics" \
  -H "Authorization: Bearer YOUR_API_KEY"

Why teams switch

Start building for free

Narwhal Free includes 5,000 successful requests each month and permits commercial apps. Use that allowance for a dashboard, scheduled data fetches or an agent integration. Move to Basic for 100,000 monthly requests as usage grows, with the same account and authentication.

Connect your app and your agent

REST and hosted MCP reach the same data through one account. Your application can fetch JSON while an agent uses the hosted tools, with every successful call counted once against the shared allowance. One quota makes the combined workload straightforward to budget.

Read both venues consistently

Narwhal gives Kalshi and Polymarket one schema for economic releases, central bank decisions, metals and energy. Events use scalar, binary, extremes and timing shapes and name their official resolution source. Economic events link to the Narwhal endpoint publishing the actual value. Odds history supports intervals from 1 minute to daily.

When they are the better pick

Polymarket API suits applications focused on direct Polymarket access and order management. Gamma handles events, markets and metadata; Data covers positions and activity; CLOB covers prices, order books and trading. Reads across all three hosts are public without authentication. Order management needs wallet-derived credentials. A public WebSocket market channel and official TypeScript and Python SDKs support integration. CLOB price history returns points without volume per bar, and Gamma encodes several fields as JSON strings.

Questions

Is there a free Polymarket API alternative?

Yes. Narwhal Free includes 5,000 successful requests per month, commercial app use and both REST and hosted MCP access. Free returns the previous day's close for prediction odds; Basic and Pro provide live odds and WebSocket streaming.

What changes when reading both prediction venues?

Polymarket splits data across Gamma, Data and CLOB. Gamma returns outcome labels, prices and token IDs as JSON-encoded strings, so callers must parse those fields. Narwhal gives Kalshi and Polymarket one schema for its 57 supported topics, with history intervals of 1 minute, 5 minutes, hourly and daily.

What changes in my application?

Replace the request URL and authentication, then map the JSON response into your application's fields. The examples use standard fetch in JavaScript and requests in Python, so integration fits an ordinary HTTP client. Keep your key on the server and carry the response's units, dates and missing values into your display or calculations.

What happens at Narwhal's monthly limit?

The shared cap applies to successful REST and MCP requests together. There are no automatic overage charges. Basic includes 100,000 monthly requests; quotas reset each month even when you pay yearly.

Test Narwhal with the same job

Check the published coverage, inspect the response contract, and make a first request before choosing a provider.