Recent Reports By Trader

curl --request GET \
  --url https://api.unusualwhales.com/api/congress/congress-trader \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.unusualwhales.com/api/congress/congress-trader', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.unusualwhales.com/api/congress/congress-trader",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.unusualwhales.com/api/congress/congress-trader"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.unusualwhales.com/api/congress/congress-trader")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "amounts": "$15,001 - $50,000",
      "filed_at_date": "2023-02-13T00:00:00.000Z",
      "is_active": true,
      "issuer": "not-disclosed",
      "member_type": "house",
      "name": "Stephen Cohen",
      "notes": "Subholding Of: Stephens Advantage Account Description: FT UNIT 10479 PFD mutual-fund 32500",
      "politician_id": "18f9fc95-4661-444e-99f5-99d3778e0c31",
      "reporter": "Stephen C.",
      "ticker": "FHWVOX",
      "transaction_date": "2023-02-06T00:00:00.000Z",
      "txn_type": "Buy"
    },
    {
      "amounts": "$1,000 - $15,000",
      "filed_at_date": "2023-02-13T00:00:00.000Z",
      "is_active": false,
      "issuer": "joint",
      "member_type": "house",
      "name": "Deborah Ross",
      "notes": "Subholding Of: Fidelity Brokerage Account stock 8000",
      "politician_id": "5b1e3f4a-2d3c-4e5f-8a6b-7c8d9e0f1a2b",
      "reporter": "Debby Ross",
      "ticker": "MSFT",
      "transaction_date": "2023-02-01T00:00:00.000Z",
      "txn_type": "Sell"
    }
  ]
}

{
  "code": "authentication_required",
  "documentation_url": "https://api.unusualwhales.com/docs",
  "expected_format": "uuid",
  "message": "The API token provided is not in the expected format. Unusual Whales API tokens are UUIDs, such as 123e4567-e89b-12d3-a456-426614174000.",
  "reason": "malformed_token",
  "request_id": "GNI_YTC1CRnw2LACGBvE",
  "retryable": false,
  "support_email": "[email protected]",
  "token_url": "https://unusualwhales.com/dashboard/api"
}

{
  "code": "payment_required",
  "documentation_url": "https://api.unusualwhales.com/docs",
  "message": "This API token is paused because the payment for your API subscription failed. Update your card at https://unusualwhales.com/settings. The same token works again once a payment succeeds.",
  "reason": "payment_failed",
  "request_id": "GNI_YTC1CRnw2LACGBvE",
  "retryable": false,
  "support_email": "[email protected]",
  "token_url": "https://unusualwhales.com/dashboard/api"
}

{
  "code": "missing_access",
  "documentation_url": "https://api.unusualwhales.com/docs",
  "message": "The API token provided is valid but is not permitted to access this route.",
  "reason": "route_not_permitted",
  "request_id": "GNI_YTC1CRnw2LACGBvE",
  "retryable": false,
  "support_email": "[email protected]",
  "token_url": "https://unusualwhales.com/dashboard/api"
}

{
  "msg": "Invalid path input: MSFT12 (valid example: AAPL) - Invalid query input(s): date=2023-02-140 (valid example: date=2024-01-18)",
  "path": "/api/darkpool/MSFT12",
  "query": "date=2023-02-140",
  "url": "localhost:4000/api/darkpool/MSFT12?date=2023-02-140"
}

Something went wrong

congress

Recent Reports By Trader

Returns the recent reports by the given congress member.

Trades are sorted by transaction date, newest first, and split into pages of limit trades. Use page to request a page. The response includes page, the page returned, and total_pages, the number of pages for the given filters and limit. Date range filtering: use date for upper bound and date_from for lower bound. To query a single day, set both to the same date (e.g. ?date_from=2025-06-15&date=2025-06-15).

GET

api

congress

congress-trader

Recent Reports By Trader

curl --request GET \
  --url https://api.unusualwhales.com/api/congress/congress-trader \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.unusualwhales.com/api/congress/congress-trader', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.unusualwhales.com/api/congress/congress-trader",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.unusualwhales.com/api/congress/congress-trader"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.unusualwhales.com/api/congress/congress-trader")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "amounts": "$15,001 - $50,000",
      "filed_at_date": "2023-02-13T00:00:00.000Z",
      "is_active": true,
      "issuer": "not-disclosed",
      "member_type": "house",
      "name": "Stephen Cohen",
      "notes": "Subholding Of: Stephens Advantage Account Description: FT UNIT 10479 PFD mutual-fund 32500",
      "politician_id": "18f9fc95-4661-444e-99f5-99d3778e0c31",
      "reporter": "Stephen C.",
      "ticker": "FHWVOX",
      "transaction_date": "2023-02-06T00:00:00.000Z",
      "txn_type": "Buy"
    },
    {
      "amounts": "$1,000 - $15,000",
      "filed_at_date": "2023-02-13T00:00:00.000Z",
      "is_active": false,
      "issuer": "joint",
      "member_type": "house",
      "name": "Deborah Ross",
      "notes": "Subholding Of: Fidelity Brokerage Account stock 8000",
      "politician_id": "5b1e3f4a-2d3c-4e5f-8a6b-7c8d9e0f1a2b",
      "reporter": "Debby Ross",
      "ticker": "MSFT",
      "transaction_date": "2023-02-01T00:00:00.000Z",
      "txn_type": "Sell"
    }
  ]
}

{
  "code": "authentication_required",
  "documentation_url": "https://api.unusualwhales.com/docs",
  "expected_format": "uuid",
  "message": "The API token provided is not in the expected format. Unusual Whales API tokens are UUIDs, such as 123e4567-e89b-12d3-a456-426614174000.",
  "reason": "malformed_token",
  "request_id": "GNI_YTC1CRnw2LACGBvE",
  "retryable": false,
  "support_email": "[email protected]",
  "token_url": "https://unusualwhales.com/dashboard/api"
}

{
  "code": "payment_required",
  "documentation_url": "https://api.unusualwhales.com/docs",
  "message": "This API token is paused because the payment for your API subscription failed. Update your card at https://unusualwhales.com/settings. The same token works again once a payment succeeds.",
  "reason": "payment_failed",
  "request_id": "GNI_YTC1CRnw2LACGBvE",
  "retryable": false,
  "support_email": "[email protected]",
  "token_url": "https://unusualwhales.com/dashboard/api"
}

{
  "code": "missing_access",
  "documentation_url": "https://api.unusualwhales.com/docs",
  "message": "The API token provided is valid but is not permitted to access this route.",
  "reason": "route_not_permitted",
  "request_id": "GNI_YTC1CRnw2LACGBvE",
  "retryable": false,
  "support_email": "[email protected]",
  "token_url": "https://unusualwhales.com/dashboard/api"
}

{
  "msg": "Invalid path input: MSFT12 (valid example: AAPL) - Invalid query input(s): date=2023-02-140 (valid example: date=2024-01-18)",
  "path": "/api/darkpool/MSFT12",
  "query": "date=2023-02-140",
  "url": "localhost:4000/api/darkpool/MSFT12?date=2023-02-140"
}

Something went wrong

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit

integer

default:100

How many items to return. Default: 100. Max: 500. Min: 1.

Required range: 1 <= x <= 500

Example:

10

date

string

A trading date in the format of YYYY-MM-DD. This is optional and by default the last trading date.

Example:

"2024-01-18T00:00:00.000Z"

ticker

string | null

Optional ticker symbol to filter results

Example:

"IOVA"

page

integer

Page number, starting at 1. Use with limit. Default: 1. Page number (use with limit). Starts on page 0.

Example:

1

name

string

default:Nancy Pelosi

The full name of a congress member. Cannot contain digits/numbers. Spaces and characters may need to be URI encoded, e.g. Adam Kinzinger -> Adam%20Kinzinger.

Example:

"Adam Kinzinger"

date_from

string

A trading date in the format of YYYY-MM-DD. This is optional and by default the last trading date.

Example:

"2024-01-18T00:00:00.000Z"

Response

A senate stock

amounts

string

The reported amount range of the transaction.

Example:

"$1,000 - $15,000"

filed_at_date

string

The filing date as ISO date.

Example:

"2023-12-13T00:00:00.000Z"

is_active

string

Is the politician an active member.

Example:

"G000585"

issuer

string

The person who executed the transaction.

Example:

"spouse"

member_type

boolean

The type of person who executed the transaction.

Example:

true

name

string

The Standardized name of the reporter (if found).

Example:

"Stephen Cohen"

notes

string

Notes of the filing.

Example:

"Subholding Of: Stephens Advantage Account Description: FT UNIT 10479 PFD mutual-fund 32500"

politician_id

string

The Politician's ID that you'd like to filter by.

Example:

"18f9fc95-4661-444e-99f5-99d3778e0c31"

reporter

string

The person who reported the transaction (as written in filling).

Example:

"Stephen Cohen"

ticker

string

The stock ticker.

Example:

"AAPL"

transaction_date

string

The transaction date as ISO date.

Example:

"2023-12-06T00:00:00.000Z"

txn_type

enum<string>

The transaction type.

Available options:

Buy,

Sell (partial),

Purchase,

Sale (Partial),

Receive,

Sale (Full),

Sell (PARTIAL),

Sell,

Exchange

Example:

"Sell"

Docs

Endpoints

Recent Reports By Trader

Authorizations

Query Parameters

Response