---
title: "Get security details for a specific ticker with up to date information from the last 24 hours"
method: GET
path: "/security_details"
---

# Get security details for a specific ticker with up to date information from the last 24 hours

`GET /security_details`

## Request

- Base URL: `https://portfoliopilot.com/api/gpt`
- URL: `https://portfoliopilot.com/api/gpt/security_details`
- Auth: none declared
- TypeScript: <https://skmtc.dev/portfoliopilot/apis/portfoliopilot-plugin/docs/security_details/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `ticker` string, required
- `include_news_and_ai_sentiment` boolean

## Response `200`

OK

- SecurityDetailsResponse: Response object containing security details for a specific ticker
  - `security_details` SecurityDetails
    - `ticker` string
    - `series_type` string
    - `volatility` number
    - `sharpe_ratio` number
    - `beta` number: The beta of the security (relative co-movement to the market as a whole)
    - `listed_exchange` string
    - `issue_type` string
    - `price` number
    - `revenue_per_share` number
    - `earnings_per_share` number
    - `dividend_per_share` number
    - `trading_volume_10_day` number
    - `trading_volume_30_day` number
    - `put_call_ratio` number
    - `enterprise_value` number
    - `revenue` number
    - `revenue_per_employee` number
    - `profit_margin` number
    - `debt_to_equity` number
    - `growth_factor` number: The relative exposure of the security to changing macro growth conditions
    - `inflation_factor` number: The relative exposure of the security to changing macro inflation conditions
    - `liquidity_factor` number: The relative exposure of the security to changing macro liquidity conditions
    - `commodities_factor` number: The relative exposure of the security to changing macro commodities factor
    - `credit_factor` number: The relative exposure of the security to changing macro credit conditions
    - `interest_rates_factor` number: The relative exposure of the security to changing macro interest rate conditions
    - `next_earnings_date_factor` string
    - `next_dividend_date` string
    - `ex_dividend_date` string
    - `related_securities` string[]
    - `news` NewsArticle[]: A list of news articles related to the security
      - `date` string
      - `headline` string
      - `source` string
      - `url` string
      - `summary` string
      - `image_url` string
      - `api_source` string
      - `language` string
      - `author` string
      - `has_paywall` boolean
      - `category` string
      - `relevance` string
      - `sentiment` string
    - `ai_sentiment` number: The AI-calculated news sentiment weighted by relevance
    - `description` string: A description of the security
    - `sector` string
    - `industry` string
    - `website` string
    - `employees` integer
    - `market_cap` number
    - `investing_method` string
    - `diversified` string
    - `expense_ratio` number
    - `asset_class` string
    - `sector_exposures` SectorExposure[]: A list of sector exposures for the security
      - `series_name` string
      - `weight` number: The weight of the sector series in the fund
    - `country_exposures` CountryExposure[]: A list of country exposures for the security
      - `series_name` string: The name of the country series
      - `weight` number: The weight of the country series in the fund
    - `holding_exposures` HoldingExposure[]: A list of holding exposures for the security
      - `series_name` string
      - `weight` number: The weight of the holding series in the fund
    - `more_info` string: url to the PortfolioPilot Security Explorer page providing more information (create link)

## Other responses

- `400`: Bad Request
- `405`: Method not allowed (e.g. GET request type is not supported, use POST method instead)

## Changes

- **2025-01-28** `e2d1ba050ae9`: 3 breaking, 11 warning, 9 info
  - the `security_details/ex_dividend_date` response's property format changed from `date` to no format for status `200`
  - the `security_details/news/items/date` response's property format changed from `date` to no format for status `200`
  - the `security_details/next_dividend_date` response's property format changed from `date` to no format for status `200`
  - deleted the `query` request parameter `include_ai_sentiment`
  - …19 more

[Operation history](https://skmtc.dev/portfoliopilot/apis/portfoliopilot-plugin/changes/security_details/get.md)

---

[API](https://skmtc.dev/portfoliopilot/apis/portfoliopilot-plugin.md) - [All operations](https://skmtc.dev/portfoliopilot/apis/portfoliopilot-plugin/llms.txt) - [OpenAPI document](https://skmtc.dev/portfoliopilot/apis/portfoliopilot-plugin/revisions/7ed0083c9099?raw)