BourseAPI
EN
Menu
Radar
Pricing
Developers / API

Congress. Insiders. Trump.
Every trade, one API.

Point-in-time stock trades of politicians and executives with the Conviction Score, 13F funds, lobbying, federal contracts and 48 more datasets, mapped to CUSIP, ISIN and FIGI. JSON, CSV and Parquet, webhooks, a Python package and a public status page.

Bourse pipeline Cleansing · CUSIP, ISIN, FIGI · Conviction Score (ML) Point-in-time timestamps on every record SEC EDGARHouse & SenateOGE 278-TKNF / ESPIBaFinAMFFCA NSMUSAspending REST API · JSONWebhooks · n8n, MakeAmazon S3 · ParquetPython · bourse-quantMCP · AI agentsOpenAPI 3.1

Regulatory filings & government data SEC EDGAR U.S. House U.S. Senate OGE Senate LDA USAspending FEC KNF BaFin AMF FCA

Alternative data & sentiment CNBC Reddit (r/wallstreetbets) Polymarket Google Trends Wikimedia

Congress discloses trades 45 days late. Insiders file in two. The President files hundreds of scanned pages. We read all of it, match every row to a ticker and hand it to you clean, the same day.

Three kinds of edge.
One key.

Your first request
in a minute.

  1. Get a key. Sign in and open Settings → API key. It is free.
  2. Send it as Authorization: Bearer bk_… or X-API-Key.
  3. Call any endpoint. JSON by default, format=csv when you want a spreadsheet.
curl -H "Authorization: Bearer $BOURSE_KEY" \
  "https://api.bourse.pl/v1/trump-trades/NVDA"

curl -H "Authorization: Bearer $BOURSE_KEY" \
  "https://api.bourse.pl/v1/house?from=2026-01-01&sort=-disclosure_date&format=csv" > house.csv
pip install bourse-quant

import bourse                        # BOURSE_KEY in the environment
df = bourse.get_insider_trades("NVDA")          # pandas DataFrame
top = bourse.get_conviction(min_score=90)       # Conviction Score
risk = bourse.stress_test({"AAPL": 40, "MSFT": 30, "TLT": 30})
const r = await fetch("https://api.bourse.pl/v1/insider-clusters?days=30", {
  headers: { Authorization: `Bearer ${process.env.BOURSE_KEY}` },
});
const { data, next } = await r.json();
console.table(data);
200 OK · application/json
{
  "dataset": "insiders",
  "ticker": "NVDA",
  "count": 1,
  "next": null,
  "data": [
    { "ticker": "NVDA", "insider_name": "...", "transaction_code": "P",
      "total_value": 1250000, "transaction_date": "2026-11-07",
      "conviction_score": 94,
      "filed_at_source_timestamp": "2026-11-10T21:04:05Z",
      "processed_by_bourse_timestamp": "2026-11-10T21:31:40Z",
      "cik": "0001045810", "cusip": "67066G104",
      "isin": "US67066G1040", "figi": "BBG000BBJQV0" }
  ]
}

Built the way
you would build it.

One ticker, one path

/v1/{dataset}/{TICKER} on every dataset with tickers, and /v1/ticker/NVDA for everything at once.

JSON or CSV

Add format=csv to any request and open it in Excel or Google Sheets.

Sort, pick, filter

sort=-amount, fields=ticker,date and ranges like min_employees=500.

Paging that just works

Every response has a next link and a Link header.

OpenAPI 3.1

openapi.json for Postman, Insomnia and code generators.

Point-in-time timestamps

Every record has filed_at_source_timestamp and processed_by_bourse_timestamp, so backtests see only what was public at the time.

Identifiers on every row

Rows with a ticker carry cik, cusip, isin and figi. Join to your security master without a lookup table.

Python package

pip install bourse-quant: pagination, retries and pandas DataFrames, so bourse.get_insider_trades("NVDA") is one line.

Bulk history

API Pro: nightly CSV and NDJSON files. Enterprise: Parquet files on Amazon S3 with pre-signed URLs.

Never cached

Data responses are sent with Cache-Control: no-store: no edge cache between you and the database.

Usage you can see

/v1/usage, X-RateLimit-Remaining-Day and, on Pay-as-you-go, the cost of the month so far.

Five endpoints with an edge.
86 in the docs.

Base URL https://api.bourse.pl/v1. These are the feeds nobody else packages this way; the full reference with every field, filter and example lives at docs.bourse.pl.

Plug it into everything.
AI assistants, automations, Python.

MCP server for Claude, ChatGPT and Cursor

Let your AI assistant query Bourse directly. Add a custom connector (remote MCP server) with this URL and your key:

https://api.bourse.pl/mcp?key=bk_your_key

Or send the key as Authorization: Bearer bk_…. Tools: list_datasets, query_dataset, ticker_profile, run_analytics, get_strategy, account_usage. Ask things like “Which insiders bought NVDA this month?” Same limits as your plan.

Webhooks: event-driven trading

Trigger algorithmic trades or route signals to Zapier, n8n or Make. Premium and API Pro: add up to 5 HTTPS endpoints in the app (Settings → Webhooks). Every 5 minutes we POST new Congress, insider, Trump, Cabinet and Form 144 filings, optionally only for your tickers. Every payload is signed with HMAC-SHA256:

Bourse-Signature: t=1762790400,v1=<hex>
Bourse-Event-ID: dlv_3f9a1c2e7b4d5a6f8e0c1b2a
# v1 = HMAC-SHA256(secret, "<t>." + raw_body)

Every delivery carries a unique Bourse-Event-ID header, and every event inside has a stable id. Use them as idempotency keys: a retried delivery has the same IDs, so you never act on the same filing twice. Verify in Python with bourse.verify_webhook(secret, header, body).

Python: bourse-quant

The official package on PyPI. It pages through results, retries on 429 and 5xx, and returns pandas DataFrames:

pip install bourse-quant

import bourse
df = bourse.get_insider_trades("NVDA")
congress = bourse.get_congress_trades(ticker="LMT", since="2025-01-01")
files = bourse.download_bulk("congress", format="parquet")   # Enterprise

Async client included (bourse.AsyncClient). Installs through PyPI, so it works behind corporate proxies such as JFrog Artifactory or Nexus.

Bulk history: Parquet, CSV, NDJSON

Backtest before you go live. Every night each dataset is written to whole-history files: Parquet (Snappy, loads into pandas or Polars in seconds), gzipped CSV and NDJSON. API Pro downloads them through pre-signed links valid for one hour; Enterprise gets the same files from Amazon S3. For a filtered slice, /v1/bulk/{dataset}?async=true starts an export job and returns a job_id at once.

curl -H "Authorization: Bearer $BOURSE_KEY" "https://api.bourse.pl/v1/exports"
# {"data": [{"dataset": "congress", "format": "parquet",
#   "url": "https://...s3.amazonaws.com/bulk/congress/congress-000.parquet?X-Amz-..."}]}
Status and SLA

Uptime is measured every 5 minutes for the REST API, the MCP server, the website, the database and the data pipelines, and published with 90 days of history at status.bourse.pl. Enterprise includes a 99.9% monthly uptime commitment with service credits (SLA terms).

curl https://api.bourse.pl/status
RapidAPI and AWS Marketplace

Prefer one bill? Bourse is listed on RapidAPI (free BASIC plan: 50 requests per 30 days, delayed data) and the Bourse Agent is sold through AWS Marketplace. Same data, same field names.

Free to start.
Pro when it is your business.

Free key$0
  • 1,000 requests a day, 2 per second
  • Event data delayed 48 hours
  • JSON, CSV, OpenAPI, Python package
  • Personal, non-commercial use
Get your free key
Pay-as-you-go$20 / month + $1 per 1,000 requests
  • The $20 base fee keeps your keys active
  • Live data, no delay, 10 requests per second
  • Commercial license
  • Metered billing via Stripe, usage in your panel
Start pay-as-you-go
API Pro$499 / month
  • Includes 7.5M requests a month (a $7,500 value on Pay-as-you-go)
  • 250,000 a day, up to 10 per second
  • Nightly bulk files: Parquet, CSV, NDJSON
  • Stress-test API, webhooks, 10 keys
  • Commercial license, invoice with VAT ID
See API Pro
Enterprise$1,000 / month
  • 1,000,000 requests a day, 25 per second
  • Full history in Parquet on Amazon S3
  • 99.9% uptime SLA with service credits
  • Everything in API Pro, priority support
Talk to us

Prices in U.S. dollars. Over a limit you get HTTP 429. Errors look like {"error": {"code": "...", "message": "..."}}. Need a custom feed or Snowflake delivery? Write to us.

Questions developers ask.

Is the Bourse API free?

There is a free key with 1,000 requests a day for personal use; event data on the free plan is delayed by 48 hours. For live data and commercial use choose Pay-as-you-go ($20 a month plus $1 per 1,000 requests), API Pro ($499 a month) or Enterprise ($1,000 a month with Parquet history on S3 and a 99.9% uptime SLA). All prices are in U.S. dollars.

How do I know when a filing became public?

Every record has filed_at_source_timestamp (when the SEC, the House, the Senate or another source published it; null when the source gives no time) and processed_by_bourse_timestamp (when Bourse stored it). Filter on these to avoid look-ahead bias in backtests.

Do records include CUSIP, ISIN and FIGI?

Yes. Every record with a ticker carries cik, cusip, isin and figi. CIK comes from the SEC, CUSIP from Form 13F filings, ISIN is computed from the CUSIP and FIGI comes from OpenFIGI. /v1/symbology looks up one security by any of these identifiers.

What is the Bourse Conviction Score?

A 0-100 rank of every open-market insider purchase from a gradient-boosted model trained on Bourse Form 4 data: role, size, change in holdings, clusters of insiders, distance from the 52-week low and recent selling. /v1/conviction returns the score with the reasons. It is a statistical ranking, not advice.

Is there a status page and an SLA?

Yes. status.bourse.pl shows measured uptime and latency for the API, the MCP server, the website, the database and the data pipelines, with 90 days of history. Enterprise includes a 99.9% monthly uptime SLA with service credits.

Can I use the data in my product, fund or newsletter?

Yes, with API Pro: it includes a commercial license to use and redistribute the data in your own products, with credit to Bourse. Free and Premium keys are for personal use. Need a custom feed or delivery to S3 or Snowflake? Write to us.

Does Bourse work with Claude, ChatGPT or Cursor?

Yes. Add https://api.bourse.pl/mcp?key=bk_your_key as a remote MCP server (custom connector) and your assistant can query every dataset, ticker profile and strategy.

Do you have webhooks?

Yes, for Premium and API Pro. New Congress, insider, Trump, Cabinet and Form 144 filings are POSTed to your HTTPS endpoint every 5 minutes, signed with HMAC-SHA256. Works with n8n, Zapier and Make.

How do I get an API key?

Click “Get your free key”, sign in or create a free account, and the app opens Settings → API key. Generate the key and copy it: for security it is shown only once.

What data does the Bourse API cover?

57 API datasets (the app shows the most popular ones) and 25 analytics endpoints: Congress, Senate and House stock trades, President Trump’s 278-T transactions, SEC Form 4 insider trades, 13F holdings, 13D/G stakes, lobbying and the revolving door, government contracts, WARN layoffs, Jim Cramer and CNBC picks, Google Trends, Wikipedia views, WallStreetBets, short interest, prediction markets, analyst ratings, earnings, dividends, macro data, news and backtested strategies.

Is there a Congress trading API and an insider trading API?

Yes. /v1/congress, /v1/senate and /v1/house return STOCK Act disclosures with price at trade and performance since; /v1/insiders returns Form 4 purchases and sales and /v1/insider-clusters finds companies where several insiders buy at once.

Can I get Trump’s stock trades and Jim Cramer’s picks?

/v1/trump-trades lists the President’s transactions from his OGE 278-T reports and /v1/trump-portfolio estimates his portfolio. /v1/tv-picks has Jim Cramer’s Mad Money calls and CNBC final trades, and /v1/cramer-scorecard shows how they performed against SPY.

Can I download CSV?

Add format=csv to any dataset or analytics request. Premium keys download up to 10,000 rows directly from /v1/bulk/{dataset}, or up to 50,000 with async=true: the API returns a job_id at once and a pre-signed download link when the file is ready.

Is there an OpenAPI spec or SDK?

The OpenAPI 3.1 spec is at api.bourse.pl/v1/openapi.json (no key needed) and the reference with webhooks is at docs.bourse.pl. The Python package installs with pip install bourse-quant.

Where does the data come from?

Public sources: SEC EDGAR, House and Senate disclosures, the Office of Government Ethics, the Senate Lobbying Disclosure Act database, USAspending, FEC, state WARN notices (via WARN Feed, CC BY 4.0), CNBC, Google Trends and Wikimedia. Please credit Bourse (bourse.pl) when you publish it. It is not investment advice.

Stop scraping PDFs.
Start shipping.