Skip to main content
POST
/
v1
/
holdings
/
funds
/
trends
Fund Position Signals
curl --request POST \
  --url https://api.bigdata.com/v1/holdings/funds/trends/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "type": "stock",
  "market_cap": "large_cap",
  "sort_dir": "desc"
}
'
{
  "results": {
    "calls": [
      {
        "target_identifier_id": "<string>",
        "name": "<string>",
        "active": true,
        "current": 123,
        "previous": 123,
        "change": 123,
        "rp_entity_id": "D8442A",
        "change_percent": 25
      }
    ],
    "puts": [
      {
        "target_identifier_id": "<string>",
        "name": "<string>",
        "active": true,
        "current": 123,
        "previous": 123,
        "change": 123,
        "rp_entity_id": "D8442A",
        "change_percent": 25
      }
    ],
    "new_positions": [
      {
        "target_identifier_id": "<string>",
        "name": "<string>",
        "active": true,
        "current": 123,
        "previous": 123,
        "change": 123,
        "rp_entity_id": "D8442A",
        "change_percent": 25
      }
    ],
    "closed_positions": [
      {
        "target_identifier_id": "<string>",
        "name": "<string>",
        "active": true,
        "current": 123,
        "previous": 123,
        "change": 123,
        "rp_entity_id": "D8442A",
        "change_percent": 25
      }
    ],
    "increased_positions": [
      {
        "target_identifier_id": "<string>",
        "name": "<string>",
        "active": true,
        "current": 123,
        "previous": 123,
        "change": 123,
        "rp_entity_id": "D8442A",
        "change_percent": 25
      }
    ],
    "reduced_positions": [
      {
        "target_identifier_id": "<string>",
        "name": "<string>",
        "active": true,
        "current": 123,
        "previous": 123,
        "change": 123,
        "rp_entity_id": "D8442A",
        "change_percent": 25
      }
    ],
    "holding_in_top": [
      {
        "target_identifier_id": "<string>",
        "name": "<string>",
        "active": true,
        "current": 123,
        "previous": 123,
        "change": 123,
        "rp_entity_id": "D8442A",
        "change_percent": 25
      }
    ],
    "net_calls": [
      {
        "target_identifier_id": "<string>",
        "name": "<string>",
        "active": true,
        "net_calls": 123,
        "calls": 123,
        "puts": 123,
        "rp_entity_id": "D8442A"
      }
    ],
    "net_puts": [
      {
        "target_identifier_id": "<string>",
        "name": "<string>",
        "active": true,
        "net_puts": 123,
        "calls": 123,
        "puts": 123,
        "rp_entity_id": "D8442A"
      }
    ],
    "net_new_positions": [
      {
        "target_identifier_id": "<string>",
        "name": "<string>",
        "active": true,
        "net_new_positions": 123,
        "new_positions": 123,
        "closed_positions": 123,
        "rp_entity_id": "D8442A"
      }
    ],
    "net_closed_positions": [
      {
        "target_identifier_id": "<string>",
        "name": "<string>",
        "active": true,
        "net_closed_positions": 123,
        "new_positions": 123,
        "closed_positions": 123,
        "rp_entity_id": "D8442A"
      }
    ],
    "net_increased_positions": [
      {
        "target_identifier_id": "<string>",
        "name": "<string>",
        "active": true,
        "net_increased_positions": 123,
        "increased_positions": 123,
        "reduced_positions": 123,
        "rp_entity_id": "D8442A"
      }
    ],
    "net_reduced_positions": [
      {
        "target_identifier_id": "<string>",
        "name": "<string>",
        "active": true,
        "net_reduced_positions": 123,
        "increased_positions": 123,
        "reduced_positions": 123,
        "rp_entity_id": "D8442A"
      }
    ]
  },
  "metadata": {
    "sort_dir": "<string>",
    "reporting_year": 2025,
    "reporting_quarter": 1,
    "filters_applied": {},
    "mapping": {
      "stock": {
        "4A6F00": "GOOGL",
        "D8442A": "AAPL"
      }
    }
  },
  "errors": [
    {
      "message": "<string>"
    }
  ]
}

Authorizations

​
X-API-KEY
string
header
required

Body

application/json

Schema for the request to the fund trends public API.

​
type
enum<string> | null

The type of securities to retrieve. One of 'stock' or 'etf'. Returns all types if not specified.

Available options:
stock,
etf
Example:

"stock"

​
market_cap
enum<string> | null

The market cap of securities to retrieve. Returns all market caps if not specified.

Available options:
mega_cap,
large_cap,
mid_cap,
small_cap,
micro_cap
Example:

"large_cap"

​
sort_dir
string
default:desc

The order to sort the results by. One of 'asc' or 'desc'.

Example:

"desc"

Response

Successful Response

Main response for fund trends aggregated endpoint.

​
results
PublicFundTrendsResults · object
required

Container with all fund trends data.

​
metadata
PublicFundTrendsMetadata · object
required

Metadata for fund trends response.

​
errors
ErrorDetail · object[] | null