Path Parameters
| Name | Type | Example | Description |
|---|---|---|---|
| symbol | string | AAPL | Stock ticker. |
Query Parameters
| Name | Type | Example | Description |
|---|---|---|---|
| action | string | sell,reduce | Optional action filter. Supported values: sell, buy, reduce, add. Multiple values can be combined with commas, such as sell,reduce. |
Auth
headers: { 'Authorization': 'Replace with your API token' }
Examples
fetch('https://api.gurufocus.com/data/stocks/AAPL/guru-trades?action=sell%2Creduce', { method: 'GET', headers: { 'Authorization': 'Replace with your API token' }})
Responses
Successful response. The exact payload fields depend on this endpoint.
Example Body (Field Reference)
[ { "class": "com", "guru_name": "Baillie Gifford", "guru_id": 446, "change": -6.69, "action": "Reduce", "comment": "Reduce -6.69%", "current_shares": 663344, "portdate": "2025-12-31", "position": 0.15 }, { "class": "equity", "guru_name": "Mario Gabelli", "guru_id": 136, "change": -2.71, "action": "Reduce", "comment": "Reduce -2.71%", "current_shares": 113912, "portdate": "2025-12-31", "position": 0.3 }, { "class": "com", "guru_name": "Murray Stahl", "guru_id": 58, "change": -5.55, "action": "Reduce", "comment": "Reduce -5.55%", "current_shares": 6939, "portdate": "2025-12-31", "position": 0.03 }, { "class": "com", "guru_name": "Tom Russo", "guru_id": 62, "change": -0.53, "action": "Reduce", "comment": "Reduce -0.53%", "current_shares": 4674, "portdate": "2025-12-31", "position": 0.01 }, { "class": "com", "guru_name": "Renaissance Technologies", "guru_id": 111, "change": -10000, "action": "Sell", "comment": "Sold Out", "current_shares": 0, "portdate": "2025-12-31", "position": 0 }, { "class": "com", "guru_name": "Sarah Ketterer", "guru_id": 73, "change": -3.13, "action": "Reduce", "comment": "Reduce -3.13%", "current_shares": 898, "portdate": "2025-12-31", "position": 0 }, { "class": "com", "guru_name": "Ray Dalio", "guru_id": 147, "change": -16.04, "action": "Reduce", "comment": "Reduce -16.04%", "current_shares": 289471, "portdate": "2025-12-31", "position": 0.29 }, { "class": "com", "guru_name": "Lee Ainslie", "guru_id": 89, "change": -10000, "action": "Sell", "comment": "Sold Out", "current_shares": 0, "portdate": "2025-12-31", "position": 0 }, { "class": "com", "guru_name": "Duan Yongping", "guru_id": 6679, "change": -7.09, "action": "Reduce", "comment": "Reduce -7.09%", "current_shares": 32358508, "portdate": "2025-12-31", "position": 50.3 }, { "class": "com", "guru_name": "Jeff Auxier", "guru_id": 106, "change": -0.51, "action": "Reduce", "comment": "Reduce -0.51%", "current_shares": 28809, "portdate": "2025-12-31", "position": 1.1 }, { "class": "com", "guru_name": "David Rolfe", "guru_id": 154, "change": -14.36, "action": "Reduce", "comment": "Reduce -14.36%", "current_shares": 142920, "portdate": "2025-12-31", "position": 7.26 }, { "class": "com", "guru_name": "Warren Buffett", "guru_id": 7, "change": -4.32, "action": "Reduce", "comment": "Reduce -4.32%", "current_shares": 227917810, "portdate": "2025-12-31", "position": 22.6 }, { "class": "com", "guru_name": "Elfun Trusts", "guru_id": 103, "change": -3.85, "action": "Reduce", "comment": "Reduce -3.85%", "current_shares": 1135518, "portdate": "2025-12-31", "position": 6.85 }, { "class": "com", "guru_name": "Scott Black", "guru_id": 151, "change": -0.52, "action": "Reduce", "comment": "Reduce -0.52%", "current_shares": 8082, "portdate": "2026-03-31", "position": 2.45 }, { "class": "corp", "guru_name": "Harbor Capital Appreciation Fund", "guru_id": 100, "change": -8.26, "action": "Reduce", "comment": "Reduce -8.26%", "current_shares": 6113161, "portdate": "2026-01-31", "position": 6.14 }]
Introduction
The GuruFocus Guru Trades Dataset returns guru holding change records for a given stock. The dataset is sourced from 140+ premium gurus and reflects the most recent trading quarter available for each stock, using the latest reported portdate.
Each row shows which guru changed their position, how the action is classified, the latest comment on the trade, the guru's remaining share count, the portfolio reporting date, and the stock's position weight within the guru's portfolio.
Use the optional action query parameter to filter the result set to one or more action types, such as buy, sell, reduce, or add.
What's Included
The Guru Trades Dataset includes:
- Latest quarter snapshot
Results are drawn from the latest available trading quarter only, based on the most recentportdate. - Guru identity
Guru name and GuruFocus guru ID for each reported trade record. - Trade classification
Action and comment fields that describe whether a guru bought, sold, reduced, added to, or exited a position. - Holdings context
Current shares after the reported portfolio update, the asset class of the position, and the stock's position weight in the guru's disclosed portfolio. - Portfolio date
The reporting period date associated with the disclosed guru position. - Action filtering
Optionalactionquery parameter with support for comma-separated combinations such assell,buyorreduce,add.
Action Filter
The action query parameter accepts:
sellbuyreduceadd
You can pass a single action or a comma-separated combination:
action=sellaction=buy,addaction=sell,reduce
Special Change Values
The change field uses special sentinel values in some cases:
-10000means sold out10000means new buy- Any other value represents the percentage change in the guru's position.
Data Coverage
This dataset is designed for stocks with available guru portfolio disclosures from 140+ premium gurus. For each stock, the response is based on the latest available trading quarter, defined by the most recent reported portdate.
Use Cases
This dataset is ideal for:
- Investment platforms surfacing guru conviction and position changes on stock pages
- Research teams tracking guru accumulation, reductions, exits, and new positions
- Quantitative workflows converting guru action data into ownership or sentiment signals
- Portfolio intelligence tools comparing guru behavior across reporting periods
Extend Your Capabilities
Combine the Guru Trades Dataset with other GuruFocus stock datasets:
- Profile Dataset - Company identity and current market context
- Ranking Dataset - GF Score, GF Value, and proprietary ranking signals
- News Dataset - Commentary and market context around guru activity
- Insider Trades Dataset - Internal insider activity alongside external guru positioning
All stock datasets follow a consistent structure and are accessible through unified API endpoints.
Response Reference
The response is an array of objects with these fields:
| Display Name | Field Name | Data Type |
|---|---|---|
| Asset Class | class | string |
| Guru Name | guru_name | string |
| Guru ID | guru_id | number |
| Change | change | number |
| Action | action | string |
| Comment | comment | string |
| Current Shares | current_shares | number |
| Portfolio Date | portdate | date |
| Position | position | number |
change Interpretation
| Value | Meaning |
|---|---|
-10000 | Sold Out |
10000 | New Buy |
Any other numeric value represents the percentage change in the guru's position.
position Interpretation
The position field represents the stock's portfolio weight within the guru's disclosed holdings for the reported portdate.
Example
[
{
"class": "com",
"guru_name": "Renaissance Technologies",
"guru_id": 111,
"change": -10000,
"action": "Sell",
"comment": "Sold Out",
"current_shares": 0,
"portdate": "2025-12-31",
"position": 0
},
{
"class": "com",
"guru_name": "Lee Ainslie",
"guru_id": 89,
"change": -10000,
"action": "Sell",
"comment": "Sold Out",
"current_shares": 0,
"portdate": "2025-12-31",
"position": 0
}
]