API Documentation

Access senator trades and congressional stock activity with data updated as promptly as possible through our API.

Introduction

The Senator Stocks API allows users to track real-time congressional trades, providing transparency on stock movements among government officials.

Base URL

https://congresswatchlist.com

Authentication

API requests require authentication using your API key. Include it in the request header:

Authorization: ApiKey YOUR_API_KEY

Congress Members API

Endpoint

GET /api/congress-members/

Response Example

                            {
                                "id": 1,
                                "first_name": "John",
                                "last_name": "Doe",
                                "party": "Democrat",
                                "description": "Serving in Congress since 2010.",
                                "wiki_url": "https://en.wikipedia.org/wiki/John_Doe"
                            }

Rate Limits

To ensure fair use, our API enforces the following limits:

Per-Minute Limit

GET /api/endpoint/ - Maximum of 10 requests per minute

Daily Limit

GET /api/endpoint/ - Maximum of 100 requests per day

Trades API

Endpoint

GET /api/trades/

Response Example

                                {
                                    "id": 1,
                                    "congress_member": {
                                        "id": 1,
                                        "first_name": "John",
                                        "last_name": "Doe"
                                    },
                                    "stock_name": "Tesla Inc.",
                                    "ticker_symbol": "TSLA",
                                    "trade_type": "Purchase",
                                    "trade_amount": "10000.00",
                                    "trade_date": "2025-02-01"
                                }