> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# polygon-io

> Financial market data

**Server path:** `/polygon-io` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                            | Description                                                              |
| --------------------------------------------------------------- | ------------------------------------------------------------------------ |
| [`polygon_get_stock_quote`](#polygon_get_stock_quote)           | Get the latest quote for a stock ticker                                  |
| [`polygon_get_stock_bars`](#polygon_get_stock_bars)             | Get historical stock price bars (OHLCV data)                             |
| [`polygon_get_market_status`](#polygon_get_market_status)       | Get current market status and trading hours                              |
| [`polygon_get_ticker_details`](#polygon_get_ticker_details)     | Get detailed information about a ticker                                  |
| [`polygon_search_tickers`](#polygon_search_tickers)             | Search for tickers by name or symbol                                     |
| [`polygon_get_daily_open_close`](#polygon_get_daily_open_close) | Get the open, high, low, and close prices for a stock on a specific date |
| [`polygon_get_previous_close`](#polygon_get_previous_close)     | Get the previous trading day's close price for a ticker                  |
| [`polygon_get_trades`](#polygon_get_trades)                     | Get recent trades for a ticker                                           |
| [`polygon_get_crypto_quote`](#polygon_get_crypto_quote)         | Get the latest quote for a cryptocurrency pair                           |
| [`polygon_get_crypto_bars`](#polygon_get_crypto_bars)           | Get historical cryptocurrency price bars                                 |
| [`polygon_get_forex_quote`](#polygon_get_forex_quote)           | Get the latest quote for a forex currency pair                           |
| [`polygon_get_forex_bars`](#polygon_get_forex_bars)             | Get historical forex price bars                                          |
| [`polygon_get_market_holidays`](#polygon_get_market_holidays)   | Get upcoming market holidays                                             |
| [`polygon_get_exchanges`](#polygon_get_exchanges)               | List all exchanges supported by Polygon                                  |
| [`polygon_get_conditions`](#polygon_get_conditions)             | Get the mapping of condition codes used in trade and quote data          |
| [`polygon_get_dividends`](#polygon_get_dividends)               | Get dividend information for a ticker                                    |
| [`polygon_get_stock_splits`](#polygon_get_stock_splits)         | Get stock split information for a ticker                                 |
| [`polygon_get_financials`](#polygon_get_financials)             | Get financial data for a ticker                                          |

***

## polygon\_get\_stock\_quote

Get the latest quote for a stock ticker

**Parameters:**

| Parameter | Type   | Required | Default | Description                            |
| --------- | ------ | -------- | ------- | -------------------------------------- |
| `ticker`  | string | Yes      | —       | Stock ticker symbol (e.g., AAPL, MSFT) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "ticker": {
        "type": "string",
        "description": "Stock ticker symbol (e.g., AAPL, MSFT)"
      }
    },
    "required": [
      "PCID",
      "ticker"
    ]
  }
  ```
</Expandable>

***

## polygon\_get\_stock\_bars

Get historical stock price bars (OHLCV data)

**Parameters:**

| Parameter    | Type    | Required | Default | Description                                |
| ------------ | ------- | -------- | ------- | ------------------------------------------ |
| `ticker`     | string  | Yes      | —       | Stock ticker symbol                        |
| `multiplier` | number  | No       | `1`     | Size of the timespan multiplier            |
| `timespan`   | string  | No       | `"day"` | Size of the time window                    |
| `from`       | string  | Yes      | —       | Start date (YYYY-MM-DD format)             |
| `to`         | string  | Yes      | —       | End date (YYYY-MM-DD format)               |
| `adjusted`   | boolean | No       | `true`  | Whether to adjust for splits and dividends |
| `sort`       | string  | No       | `"asc"` | Sort order                                 |
| `limit`      | number  | No       | `5000`  | Maximum number of results                  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "ticker": {
        "type": "string",
        "description": "Stock ticker symbol"
      },
      "multiplier": {
        "type": "number",
        "default": 1,
        "description": "Size of the timespan multiplier"
      },
      "timespan": {
        "type": "string",
        "enum": [
          "minute",
          "hour",
          "day",
          "week",
          "month",
          "quarter",
          "year"
        ],
        "default": "day",
        "description": "Size of the time window"
      },
      "from": {
        "type": "string",
        "description": "Start date (YYYY-MM-DD format)"
      },
      "to": {
        "type": "string",
        "description": "End date (YYYY-MM-DD format)"
      },
      "adjusted": {
        "type": "boolean",
        "default": true,
        "description": "Whether to adjust for splits and dividends"
      },
      "sort": {
        "type": "string",
        "enum": [
          "asc",
          "desc"
        ],
        "default": "asc",
        "description": "Sort order"
      },
      "limit": {
        "type": "number",
        "default": 5000,
        "description": "Maximum number of results"
      }
    },
    "required": [
      "PCID",
      "ticker",
      "from",
      "to"
    ]
  }
  ```
</Expandable>

***

## polygon\_get\_market\_status

Get current market status and trading hours

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## polygon\_get\_ticker\_details

Get detailed information about a ticker

**Parameters:**

| Parameter | Type   | Required | Default | Description                                     |
| --------- | ------ | -------- | ------- | ----------------------------------------------- |
| `ticker`  | string | Yes      | —       | Stock ticker symbol                             |
| `date`    | string | No       | —       | Date for historical details (YYYY-MM-DD format) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "ticker": {
        "type": "string",
        "description": "Stock ticker symbol"
      },
      "date": {
        "type": "string",
        "description": "Date for historical details (YYYY-MM-DD format)"
      }
    },
    "required": [
      "PCID",
      "ticker"
    ]
  }
  ```
</Expandable>

***

## polygon\_search\_tickers

Search for tickers by name or symbol

**Parameters:**

| Parameter | Type    | Required | Default    | Description                                  |
| --------- | ------- | -------- | ---------- | -------------------------------------------- |
| `search`  | string  | Yes      | —          | Search query (company name or ticker symbol) |
| `type`    | string  | No       | —          | Type of security to search for               |
| `market`  | string  | No       | `"stocks"` | Market to search in                          |
| `active`  | boolean | No       | `true`     | Filter for active tickers only               |
| `limit`   | number  | No       | `10`       | Maximum number of results                    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "search": {
        "type": "string",
        "description": "Search query (company name or ticker symbol)"
      },
      "type": {
        "type": "string",
        "enum": [
          "CS",
          "ETF",
          "ETN",
          "FUND",
          "WARRANT"
        ],
        "description": "Type of security to search for"
      },
      "market": {
        "type": "string",
        "enum": [
          "stocks",
          "crypto",
          "fx"
        ],
        "default": "stocks",
        "description": "Market to search in"
      },
      "active": {
        "type": "boolean",
        "default": true,
        "description": "Filter for active tickers only"
      },
      "limit": {
        "type": "number",
        "default": 10,
        "description": "Maximum number of results"
      }
    },
    "required": [
      "PCID",
      "search"
    ]
  }
  ```
</Expandable>

***

## polygon\_get\_daily\_open\_close

Get the open, high, low, and close prices for a stock on a specific date

**Parameters:**

| Parameter  | Type    | Required | Default | Description                                |
| ---------- | ------- | -------- | ------- | ------------------------------------------ |
| `ticker`   | string  | Yes      | —       | Stock ticker symbol                        |
| `date`     | string  | Yes      | —       | Date (YYYY-MM-DD format)                   |
| `adjusted` | boolean | No       | `true`  | Whether to adjust for splits and dividends |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "ticker": {
        "type": "string",
        "description": "Stock ticker symbol"
      },
      "date": {
        "type": "string",
        "description": "Date (YYYY-MM-DD format)"
      },
      "adjusted": {
        "type": "boolean",
        "default": true,
        "description": "Whether to adjust for splits and dividends"
      }
    },
    "required": [
      "PCID",
      "ticker",
      "date"
    ]
  }
  ```
</Expandable>

***

## polygon\_get\_previous\_close

Get the previous trading day's close price for a ticker

**Parameters:**

| Parameter  | Type    | Required | Default | Description                                |
| ---------- | ------- | -------- | ------- | ------------------------------------------ |
| `ticker`   | string  | Yes      | —       | Stock ticker symbol                        |
| `adjusted` | boolean | No       | `true`  | Whether to adjust for splits and dividends |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "ticker": {
        "type": "string",
        "description": "Stock ticker symbol"
      },
      "adjusted": {
        "type": "boolean",
        "default": true,
        "description": "Whether to adjust for splits and dividends"
      }
    },
    "required": [
      "PCID",
      "ticker"
    ]
  }
  ```
</Expandable>

***

## polygon\_get\_trades

Get recent trades for a ticker

**Parameters:**

| Parameter   | Type   | Required | Default       | Description                               |
| ----------- | ------ | -------- | ------------- | ----------------------------------------- |
| `ticker`    | string | Yes      | —             | Stock ticker symbol                       |
| `timestamp` | string | No       | —             | Timestamp to get trades from (ISO format) |
| `order`     | string | No       | `"desc"`      | Sort order                                |
| `limit`     | number | No       | `10`          | Maximum number of results                 |
| `sort`      | string | No       | `"timestamp"` | Field to sort by                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "ticker": {
        "type": "string",
        "description": "Stock ticker symbol"
      },
      "timestamp": {
        "type": "string",
        "description": "Timestamp to get trades from (ISO format)"
      },
      "order": {
        "type": "string",
        "enum": [
          "asc",
          "desc"
        ],
        "default": "desc",
        "description": "Sort order"
      },
      "limit": {
        "type": "number",
        "default": 10,
        "description": "Maximum number of results"
      },
      "sort": {
        "type": "string",
        "default": "timestamp",
        "description": "Field to sort by"
      }
    },
    "required": [
      "PCID",
      "ticker"
    ]
  }
  ```
</Expandable>

***

## polygon\_get\_crypto\_quote

Get the latest quote for a cryptocurrency pair

**Parameters:**

| Parameter | Type   | Required | Default | Description                    |
| --------- | ------ | -------- | ------- | ------------------------------ |
| `from`    | string | Yes      | —       | From currency (e.g., BTC, ETH) |
| `to`      | string | Yes      | —       | To currency (e.g., USD, EUR)   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "from": {
        "type": "string",
        "description": "From currency (e.g., BTC, ETH)"
      },
      "to": {
        "type": "string",
        "description": "To currency (e.g., USD, EUR)"
      }
    },
    "required": [
      "PCID",
      "from",
      "to"
    ]
  }
  ```
</Expandable>

***

## polygon\_get\_crypto\_bars

Get historical cryptocurrency price bars

**Parameters:**

| Parameter    | Type   | Required | Default | Description                     |
| ------------ | ------ | -------- | ------- | ------------------------------- |
| `from`       | string | Yes      | —       | From currency (e.g., BTC, ETH)  |
| `to`         | string | Yes      | —       | To currency (e.g., USD, EUR)    |
| `multiplier` | number | No       | `1`     | Size of the timespan multiplier |
| `timespan`   | string | No       | `"day"` | Size of the time window         |
| `from_date`  | string | Yes      | —       | Start date (YYYY-MM-DD format)  |
| `to_date`    | string | Yes      | —       | End date (YYYY-MM-DD format)    |
| `sort`       | string | No       | `"asc"` | Sort order                      |
| `limit`      | number | No       | `5000`  | Maximum number of results       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "from": {
        "type": "string",
        "description": "From currency (e.g., BTC, ETH)"
      },
      "to": {
        "type": "string",
        "description": "To currency (e.g., USD, EUR)"
      },
      "multiplier": {
        "type": "number",
        "default": 1,
        "description": "Size of the timespan multiplier"
      },
      "timespan": {
        "type": "string",
        "enum": [
          "minute",
          "hour",
          "day",
          "week",
          "month"
        ],
        "default": "day",
        "description": "Size of the time window"
      },
      "from_date": {
        "type": "string",
        "description": "Start date (YYYY-MM-DD format)"
      },
      "to_date": {
        "type": "string",
        "description": "End date (YYYY-MM-DD format)"
      },
      "sort": {
        "type": "string",
        "enum": [
          "asc",
          "desc"
        ],
        "default": "asc",
        "description": "Sort order"
      },
      "limit": {
        "type": "number",
        "default": 5000,
        "description": "Maximum number of results"
      }
    },
    "required": [
      "PCID",
      "from",
      "to",
      "from_date",
      "to_date"
    ]
  }
  ```
</Expandable>

***

## polygon\_get\_forex\_quote

Get the latest quote for a forex currency pair

**Parameters:**

| Parameter | Type   | Required | Default | Description                    |
| --------- | ------ | -------- | ------- | ------------------------------ |
| `from`    | string | Yes      | —       | From currency (e.g., USD, EUR) |
| `to`      | string | Yes      | —       | To currency (e.g., EUR, GBP)   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "from": {
        "type": "string",
        "description": "From currency (e.g., USD, EUR)"
      },
      "to": {
        "type": "string",
        "description": "To currency (e.g., EUR, GBP)"
      }
    },
    "required": [
      "PCID",
      "from",
      "to"
    ]
  }
  ```
</Expandable>

***

## polygon\_get\_forex\_bars

Get historical forex price bars

**Parameters:**

| Parameter    | Type   | Required | Default | Description                     |
| ------------ | ------ | -------- | ------- | ------------------------------- |
| `from`       | string | Yes      | —       | From currency (e.g., USD, EUR)  |
| `to`         | string | Yes      | —       | To currency (e.g., EUR, GBP)    |
| `multiplier` | number | No       | `1`     | Size of the timespan multiplier |
| `timespan`   | string | No       | `"day"` | Size of the time window         |
| `from_date`  | string | Yes      | —       | Start date (YYYY-MM-DD format)  |
| `to_date`    | string | Yes      | —       | End date (YYYY-MM-DD format)    |
| `sort`       | string | No       | `"asc"` | Sort order                      |
| `limit`      | number | No       | `5000`  | Maximum number of results       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "from": {
        "type": "string",
        "description": "From currency (e.g., USD, EUR)"
      },
      "to": {
        "type": "string",
        "description": "To currency (e.g., EUR, GBP)"
      },
      "multiplier": {
        "type": "number",
        "default": 1,
        "description": "Size of the timespan multiplier"
      },
      "timespan": {
        "type": "string",
        "enum": [
          "minute",
          "hour",
          "day",
          "week",
          "month"
        ],
        "default": "day",
        "description": "Size of the time window"
      },
      "from_date": {
        "type": "string",
        "description": "Start date (YYYY-MM-DD format)"
      },
      "to_date": {
        "type": "string",
        "description": "End date (YYYY-MM-DD format)"
      },
      "sort": {
        "type": "string",
        "enum": [
          "asc",
          "desc"
        ],
        "default": "asc",
        "description": "Sort order"
      },
      "limit": {
        "type": "number",
        "default": 5000,
        "description": "Maximum number of results"
      }
    },
    "required": [
      "PCID",
      "from",
      "to",
      "from_date",
      "to_date"
    ]
  }
  ```
</Expandable>

***

## polygon\_get\_market\_holidays

Get upcoming market holidays

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## polygon\_get\_exchanges

List all exchanges supported by Polygon

**Parameters:**

| Parameter     | Type   | Required | Default | Description           |
| ------------- | ------ | -------- | ------- | --------------------- |
| `asset_class` | string | No       | —       | Filter by asset class |
| `locale`      | string | No       | —       | Filter by locale      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "asset_class": {
        "type": "string",
        "enum": [
          "stocks",
          "options",
          "crypto",
          "fx"
        ],
        "description": "Filter by asset class"
      },
      "locale": {
        "type": "string",
        "enum": [
          "us",
          "global"
        ],
        "description": "Filter by locale"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## polygon\_get\_conditions

Get the mapping of condition codes used in trade and quote data

**Parameters:**

| Parameter     | Type   | Required | Default | Description           |
| ------------- | ------ | -------- | ------- | --------------------- |
| `asset_class` | string | No       | —       | Filter by asset class |
| `data_type`   | string | No       | —       | Filter by data type   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "asset_class": {
        "type": "string",
        "enum": [
          "stocks",
          "options",
          "crypto",
          "fx"
        ],
        "description": "Filter by asset class"
      },
      "data_type": {
        "type": "string",
        "enum": [
          "trade",
          "quote"
        ],
        "description": "Filter by data type"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## polygon\_get\_dividends

Get dividend information for a ticker

**Parameters:**

| Parameter          | Type   | Required | Default | Description                             |
| ------------------ | ------ | -------- | ------- | --------------------------------------- |
| `ticker`           | string | Yes      | —       | Stock ticker symbol                     |
| `ex_dividend_date` | string | No       | —       | Filter by ex-dividend date (YYYY-MM-DD) |
| `record_date`      | string | No       | —       | Filter by record date (YYYY-MM-DD)      |
| `declaration_date` | string | No       | —       | Filter by declaration date (YYYY-MM-DD) |
| `pay_date`         | string | No       | —       | Filter by pay date (YYYY-MM-DD)         |
| `frequency`        | number | No       | —       | Filter by dividend frequency            |
| `limit`            | number | No       | `10`    | Maximum number of results               |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "ticker": {
        "type": "string",
        "description": "Stock ticker symbol"
      },
      "ex_dividend_date": {
        "type": "string",
        "description": "Filter by ex-dividend date (YYYY-MM-DD)"
      },
      "record_date": {
        "type": "string",
        "description": "Filter by record date (YYYY-MM-DD)"
      },
      "declaration_date": {
        "type": "string",
        "description": "Filter by declaration date (YYYY-MM-DD)"
      },
      "pay_date": {
        "type": "string",
        "description": "Filter by pay date (YYYY-MM-DD)"
      },
      "frequency": {
        "type": "number",
        "description": "Filter by dividend frequency"
      },
      "limit": {
        "type": "number",
        "default": 10,
        "description": "Maximum number of results"
      }
    },
    "required": [
      "PCID",
      "ticker"
    ]
  }
  ```
</Expandable>

***

## polygon\_get\_stock\_splits

Get stock split information for a ticker

**Parameters:**

| Parameter        | Type    | Required | Default | Description                           |
| ---------------- | ------- | -------- | ------- | ------------------------------------- |
| `ticker`         | string  | Yes      | —       | Stock ticker symbol                   |
| `execution_date` | string  | No       | —       | Filter by execution date (YYYY-MM-DD) |
| `reverse_split`  | boolean | No       | —       | Filter for reverse splits             |
| `limit`          | number  | No       | `10`    | Maximum number of results             |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "ticker": {
        "type": "string",
        "description": "Stock ticker symbol"
      },
      "execution_date": {
        "type": "string",
        "description": "Filter by execution date (YYYY-MM-DD)"
      },
      "reverse_split": {
        "type": "boolean",
        "description": "Filter for reverse splits"
      },
      "limit": {
        "type": "number",
        "default": 10,
        "description": "Maximum number of results"
      }
    },
    "required": [
      "PCID",
      "ticker"
    ]
  }
  ```
</Expandable>

***

## polygon\_get\_financials

Get financial data for a ticker

**Parameters:**

| Parameter               | Type    | Required | Default | Description                                  |
| ----------------------- | ------- | -------- | ------- | -------------------------------------------- |
| `ticker`                | string  | Yes      | —       | Stock ticker symbol                          |
| `reporting_period`      | string  | No       | —       | Filter by reporting period (YYYY-MM-DD)      |
| `period_of_report_date` | string  | No       | —       | Filter by period of report date (YYYY-MM-DD) |
| `timeframe`             | string  | No       | —       | Filter by timeframe                          |
| `include_sources`       | boolean | No       | `false` | Include source URLs                          |
| `limit`                 | number  | No       | `10`    | Maximum number of results                    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "ticker": {
        "type": "string",
        "description": "Stock ticker symbol"
      },
      "reporting_period": {
        "type": "string",
        "description": "Filter by reporting period (YYYY-MM-DD)"
      },
      "period_of_report_date": {
        "type": "string",
        "description": "Filter by period of report date (YYYY-MM-DD)"
      },
      "timeframe": {
        "type": "string",
        "enum": [
          "annual",
          "quarterly"
        ],
        "description": "Filter by timeframe"
      },
      "include_sources": {
        "type": "boolean",
        "default": false,
        "description": "Include source URLs"
      },
      "limit": {
        "type": "number",
        "default": 10,
        "description": "Maximum number of results"
      }
    },
    "required": [
      "PCID",
      "ticker"
    ]
  }
  ```
</Expandable>
