GET/politicians/transactions
Query Parameters
| Name | Type | Example | Description |
|---|---|---|---|
| asset_type | string | Common_Stock | Asset class filter. Use values such as Common_Stock or All. |
| page | number | 1 | Page number. Default is 1. |
| id | number | 7 | Optional politician ID filter from /politicians. |
| sort | string | transaction_date | Sort field. Default is transaction_date. |
| order | string | desc | Sort order: asc or desc. Default is desc. |
Auth
headers: { 'Authorization': 'Replace with your API token' }
Examples
fetch('https://api.gurufocus.com/data/politicians/transactions?asset_type=Common_Stock&page=1&id=7&sort=transaction_date&order=desc', { method: 'GET', headers: { 'Authorization': 'Replace with your API token' }})
Responses
Successful response. The exact payload fields depend on this endpoint.
Example Body (Field Reference)
No response body is documented for this status.
Introduction
Returns paginated politician trading transactions across the GuruFocus politician dataset.
You can query the full feed or narrow the response to one politician by passing an id from /politicians.
Query Parameters
| Display Name | Field Name | Type | Required | Description |
|---|---|---|---|---|
| Asset Type | asset_type | string | No | Asset class filter. Example: Common_Stock or All. |
| Page | page | number | No | Page number to fetch. Default is 1. |
| Politician ID | id | number | No | Filter transactions to a single politician ID from /politicians. |
| Sort | sort | string | No | Sort field. Default is transaction_date. |
| Order | order | string | No | Sort direction. Use asc or desc. Default is desc. |
Response Notes
The response includes pagination metadata and a data array of transaction records.
Top-level response fields:
countcurrentPagelastPagetotaldata
Each transaction item can include:
- Politician identity fields such as
id,full_name,position,state, andparty - Stock reference fields such as
stockid,symbol,company,exchange, andindustry - Transaction details such as
class,trans_type,amount,transaction_date, anddisclosure_date - Option metadata such as
option_type,strike_price, andexpiration_datewhen applicable
Response Reference
| Display Name | Field Name | Type |
|---|---|---|
| Count | count | number |
| Current Page | currentPage | number |
| Last Page | lastPage | number |
| Total | total | number |
| Data | data | array |
Transaction Item
| Display Name | Field Name | Type |
|---|---|---|
| Politician ID | id | number |
| Full Name | full_name | string |
| Official Name | official_full | string |
| Position | position | string |
| State | state | string |
| Party | party | string |
| Symbol | symbol | string |
| Company | company | string |
| Exchange | exchange | string |
| Industry | industry | string |
| Asset Class | class | string |
| Stock ID | stockid | string |
| Transaction Type | trans_type | string |
| Amount | amount | string |
| Transaction Date | transaction_date | string |
| Disclosure Date | disclosure_date | string |
| Option Type | option_type | string |
| Strike Price | strike_price | string |
| Expiration Date | expiration_date | string |
Common Workflow
- Call
/politiciansto get politician IDs. - Call
/politicians/transactions?id={id}to fetch one politician's trading history. - Use
asset_type=Allif you want to include non-common-stock records.