---
title: "Fund Position Signals"
method: POST
path: "/v1/holdings/funds/trends/"
tags: ["Fund Holdings"]
---

# Fund Position Signals

`POST /v1/holdings/funds/trends/`

Retrieve a strategic overview of top stocks based on aggregated position changes by hedge funds, utilizing data from the most recent SEC 13F filings. This endpoint provides a detailed overview of fund activities, capturing changes across calls, puts, new positions, closures, and net adjustments. It highlights where hedge funds are intensifying their focus, reducing exposure, or completely shifting their investment strategies, helping users identify trends and strategic moves in the market.

## Request body

- PublicGetFundTrendsQuery — Schema for the request to the fund trends public API.
  - `type` 'stock' | 'etf' — Enum for security type values.
  - `market_cap` 'mega_cap' | 'large_cap' | 'mid_cap' | 'small_cap' | 'micro_cap' — Enum for market capitalization values.
  - `sort_dir` string — The order to sort the results by. One of 'asc' or 'desc'.

## Response `200`

Successful Response

- PublicFundTrendsResponse — Main response for fund trends aggregated endpoint.
  - `results` PublicFundTrendsResults, required — Container with all fund trends data.
    - `calls` PublicPositionChangeItem[] — Calls trend data
      - `rp_entity_id` string, nullable — RavenPack entity ID
      - `target_identifier_id` string, required — Ticker symbol
      - `name` string, required — Company name
      - `active` boolean, required — Whether the company is active
      - `current` integer, required — Current number of funds
      - `previous` integer, required — Previous number of funds
      - `change` integer, required — Change in number of funds
      - `change_percent` number, nullable — Percentage change
    - `puts` PublicPositionChangeItem[] — Puts trend data
      - `rp_entity_id` string, nullable — RavenPack entity ID
      - `target_identifier_id` string, required — Ticker symbol
      - `name` string, required — Company name
      - `active` boolean, required — Whether the company is active
      - `current` integer, required — Current number of funds
      - `previous` integer, required — Previous number of funds
      - `change` integer, required — Change in number of funds
      - `change_percent` number, nullable — Percentage change
    - `new_positions` PublicPositionChangeItem[] — New positions trend data
      - `rp_entity_id` string, nullable — RavenPack entity ID
      - `target_identifier_id` string, required — Ticker symbol
      - `name` string, required — Company name
      - `active` boolean, required — Whether the company is active
      - `current` integer, required — Current number of funds
      - `previous` integer, required — Previous number of funds
      - `change` integer, required — Change in number of funds
      - `change_percent` number, nullable — Percentage change
    - `closed_positions` PublicPositionChangeItem[] — Closed positions trend data
      - `rp_entity_id` string, nullable — RavenPack entity ID
      - `target_identifier_id` string, required — Ticker symbol
      - `name` string, required — Company name
      - `active` boolean, required — Whether the company is active
      - `current` integer, required — Current number of funds
      - `previous` integer, required — Previous number of funds
      - `change` integer, required — Change in number of funds
      - `change_percent` number, nullable — Percentage change
    - `increased_positions` PublicPositionChangeItem[] — Increased positions trend data
      - `rp_entity_id` string, nullable — RavenPack entity ID
      - `target_identifier_id` string, required — Ticker symbol
      - `name` string, required — Company name
      - `active` boolean, required — Whether the company is active
      - `current` integer, required — Current number of funds
      - `previous` integer, required — Previous number of funds
      - `change` integer, required — Change in number of funds
      - `change_percent` number, nullable — Percentage change
    - `reduced_positions` PublicPositionChangeItem[] — Reduced positions trend data
      - `rp_entity_id` string, nullable — RavenPack entity ID
      - `target_identifier_id` string, required — Ticker symbol
      - `name` string, required — Company name
      - `active` boolean, required — Whether the company is active
      - `current` integer, required — Current number of funds
      - `previous` integer, required — Previous number of funds
      - `change` integer, required — Change in number of funds
      - `change_percent` number, nullable — Percentage change
    - `holding_in_top` PublicPositionChangeItem[] — Holding in top 10 trend data
      - `rp_entity_id` string, nullable — RavenPack entity ID
      - `target_identifier_id` string, required — Ticker symbol
      - `name` string, required — Company name
      - `active` boolean, required — Whether the company is active
      - `current` integer, required — Current number of funds
      - `previous` integer, required — Previous number of funds
      - `change` integer, required — Change in number of funds
      - `change_percent` number, nullable — Percentage change
    - `net_calls` PublicNetCallsItem[] — Net calls trend data
      - `rp_entity_id` string, nullable — RavenPack entity ID
      - `target_identifier_id` string, required — Ticker symbol
      - `name` string, required — Company name
      - `active` boolean, required — Whether the company is active
      - `net_calls` integer, required — Net calls amount
      - `calls` integer, required — Total calls amount
      - `puts` integer, required — Total puts amount
    - `net_puts` PublicNetPutsItem[] — Net puts trend data
      - `rp_entity_id` string, nullable — RavenPack entity ID
      - `target_identifier_id` string, required — Ticker symbol
      - `name` string, required — Company name
      - `active` boolean, required — Whether the company is active
      - `net_puts` integer, required — Net puts amount
      - `calls` integer, required — Total calls amount
      - `puts` integer, required — Total puts amount
    - `net_new_positions` PublicNetNewPositionsItem[] — Net new positions trend data
      - `rp_entity_id` string, nullable — RavenPack entity ID
      - `target_identifier_id` string, required — Ticker symbol
      - `name` string, required — Company name
      - `active` boolean, required — Whether the company is active
      - `net_new_positions` integer, required — Net new positions count
      - `new_positions` integer, required — Number of new positions
      - `closed_positions` integer, required — Number of closed positions
    - `net_closed_positions` PublicNetClosedPositionsItem[] — Net closed positions trend data
      - `rp_entity_id` string, nullable — RavenPack entity ID
      - `target_identifier_id` string, required — Ticker symbol
      - `name` string, required — Company name
      - `active` boolean, required — Whether the company is active
      - `net_closed_positions` integer, required — Net closed positions count
      - `new_positions` integer, required — Number of new positions
      - `closed_positions` integer, required — Number of closed positions
    - `net_increased_positions` PublicNetIncreasedPositionsItem[] — Net increased positions trend data
      - `rp_entity_id` string, nullable — RavenPack entity ID
      - `target_identifier_id` string, required — Ticker symbol
      - `name` string, required — Company name
      - `active` boolean, required — Whether the company is active
      - `net_increased_positions` integer, required — Net increased positions count
      - `increased_positions` integer, required — Number of increased positions
      - `reduced_positions` integer, required — Number of reduced positions
    - `net_reduced_positions` PublicNetReducedPositionsItem[] — Net reduced positions trend data
      - `rp_entity_id` string, nullable — RavenPack entity ID
      - `target_identifier_id` string, required — Ticker symbol
      - `name` string, required — Company name
      - `active` boolean, required — Whether the company is active
      - `net_reduced_positions` integer, required — Net reduced positions count
      - `increased_positions` integer, required — Number of increased positions
      - `reduced_positions` integer, required — Number of reduced positions
  - `errors` ErrorDetail[], nullable
    - `message` string, nullable
  - `metadata` PublicFundTrendsMetadata, required — Metadata for fund trends response.
    - `reporting_year` integer, nullable — Reporting year
    - `reporting_quarter` integer, nullable — Reporting quarter
    - `filters_applied` object — Applied filters
    - `sort_dir` string, required — Sort direction used
    - `mapping` HoldingsMapping — Mapping of RP entity IDs to Wall St Rank symbols used.
      - `fund` object, nullable
      - `stock` object, nullable

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/revisions/18082de268c4/schema)