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": [
      {
        "rp_entity_id": "D8442A",
        "target_identifier_id": "AAPL",
        "name": "Apple Inc.",
        "active": true,
        "current": 150,
        "previous": 120,
        "change": 30,
        "change_percent": 25
      }
    ],
    "puts": [
      {
        "rp_entity_id": "D8442A",
        "target_identifier_id": "AAPL",
        "name": "Apple Inc.",
        "active": true,
        "current": 150,
        "previous": 120,
        "change": 30,
        "change_percent": 25
      }
    ],
    "new_positions": [
      {
        "rp_entity_id": "D8442A",
        "target_identifier_id": "AAPL",
        "name": "Apple Inc.",
        "active": true,
        "current": 150,
        "previous": 120,
        "change": 30,
        "change_percent": 25
      }
    ],
    "closed_positions": [
      {
        "rp_entity_id": "D8442A",
        "target_identifier_id": "AAPL",
        "name": "Apple Inc.",
        "active": true,
        "current": 150,
        "previous": 120,
        "change": 30,
        "change_percent": 25
      }
    ],
    "increased_positions": [
      {
        "rp_entity_id": "D8442A",
        "target_identifier_id": "AAPL",
        "name": "Apple Inc.",
        "active": true,
        "current": 150,
        "previous": 120,
        "change": 30,
        "change_percent": 25
      }
    ],
    "reduced_positions": [
      {
        "rp_entity_id": "D8442A",
        "target_identifier_id": "AAPL",
        "name": "Apple Inc.",
        "active": true,
        "current": 150,
        "previous": 120,
        "change": 30,
        "change_percent": 25
      }
    ],
    "holding_in_top": [
      {
        "rp_entity_id": "D8442A",
        "target_identifier_id": "AAPL",
        "name": "Apple Inc.",
        "active": true,
        "current": 150,
        "previous": 120,
        "change": 30,
        "change_percent": 25
      }
    ],
    "net_calls": [
      {
        "rp_entity_id": "D8442A",
        "target_identifier_id": "AAPL",
        "name": "Apple Inc.",
        "active": true,
        "net_calls": 5000,
        "calls": 10000,
        "puts": 5000
      }
    ],
    "net_puts": [
      {
        "rp_entity_id": "D8442A",
        "target_identifier_id": "AAPL",
        "name": "Apple Inc.",
        "active": true,
        "net_puts": 3000,
        "calls": 5000,
        "puts": 8000
      }
    ],
    "net_new_positions": [
      {
        "rp_entity_id": "D8442A",
        "target_identifier_id": "AAPL",
        "name": "Apple Inc.",
        "active": true,
        "net_new_positions": 25,
        "new_positions": 50,
        "closed_positions": 25
      }
    ],
    "net_closed_positions": [
      {
        "rp_entity_id": "D8442A",
        "target_identifier_id": "AAPL",
        "name": "Apple Inc.",
        "active": true,
        "net_closed_positions": 15,
        "new_positions": 20,
        "closed_positions": 35
      }
    ],
    "net_increased_positions": [
      {
        "rp_entity_id": "D8442A",
        "target_identifier_id": "AAPL",
        "name": "Apple Inc.",
        "active": true,
        "net_increased_positions": 40,
        "increased_positions": 60,
        "reduced_positions": 20
      }
    ],
    "net_reduced_positions": [
      {
        "rp_entity_id": "D8442A",
        "target_identifier_id": "AAPL",
        "name": "Apple Inc.",
        "active": true,
        "net_reduced_positions": 30,
        "increased_positions": 40,
        "reduced_positions": 70
      }
    ]
  },
  "errors": [
    {
      "message": "<string>"
    }
  ],
  "metadata": {
    "reporting_year": 2025,
    "reporting_quarter": 1,
    "filters_applied": {},
    "sort_dir": "desc",
    "mapping": {
      "stock": {
        "4A6F00": "GOOGL",
        "D8442A": "AAPL"
      }
    }
  }
}

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. Enum for security type values.

Available options:
stock,
etf
Examples:

"stock"

​
market_cap
enum<string> | null

The market cap of securities to retrieve. Returns all market caps if not specified. Enum for market capitalization values.

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

"large_cap"

​
sort_dir
string
default:desc

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

Examples:

"desc"

Response

Successful Response

Main response for fund trends aggregated endpoint.

​
results
object
required

Container with all fund trends data.

​
metadata
object
required

Metadata for fund trends response.

​
errors
ErrorDetail · object[] | null