`aggregates`

Pack: polygon-io · Endpoint: https://gateway.pipeworx.io/polygon-io/mcp

Polygon.io OHLC price bars for a US stock ticker — 1 minute through quarterly granularity. Returns timestamped open/high/low/close + volume + VWAP. Use for charting equities, intraday analysis, backtesting historical prices.

Parameters

Name	Type	Required
`ticker`	string	yes
`multiplier`	number	yes
`timespan`	string	yes
`from`	string	yes
`to`	string	yes
`adjusted`	boolean	no
`sort`	string	no
`limit`	number	no

Example call

Arguments

{
  "ticker": "AAPL",
  "multiplier": 1,
  "timespan": "day",
  "from": "2024-01-01",
  "to": "2024-01-31"
}

curl

curl -X POST https://gateway.pipeworx.io/polygon-io/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"aggregates","arguments":{"ticker":"AAPL","multiplier":1,"timespan":"day","from":"2024-01-01","to":"2024-01-31"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('aggregates', {
  "ticker": "AAPL",
  "multiplier": 1,
  "timespan": "day",
  "from": "2024-01-01",
  "to": "2024-01-31"
});

More examples

{
  "ticker": "TSLA",
  "multiplier": 15,
  "timespan": "minute",
  "from": "2024-01-15",
  "to": "2024-01-16",
  "limit": 100
}

Response shape

Field	Type	Description
`ticker`	string	Ticker symbol
`status`	string	API response status
`adjusted`	boolean	Whether data is adjusted
`results`	array	OHLC bar data
`count`	number	Number of results
`next_url`	string	Next page URL if available

Full JSON Schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Ticker symbol"
    },
    "status": {
      "type": "string",
      "description": "API response status"
    },
    "adjusted": {
      "type": "boolean",
      "description": "Whether data is adjusted"
    },
    "results": {
      "type": "array",
      "description": "OHLC bar data",
      "items": {
        "type": "object",
        "properties": {
          "c": {
            "type": "number",
            "description": "Close price"
          },
          "h": {
            "type": "number",
            "description": "High price"
          },
          "l": {
            "type": "number",
            "description": "Low price"
          },
          "o": {
            "type": "number",
            "description": "Open price"
          },
          "v": {
            "type": "number",
            "description": "Volume"
          },
          "vw": {
            "type": "number",
            "description": "Volume weighted average"
          },
          "t": {
            "type": "number",
            "description": "Timestamp"
          },
          "n": {
            "type": "number",
            "description": "Number of transactions"
          }
        }
      }
    },
    "count": {
      "type": "number",
      "description": "Number of results"
    },
    "next_url": {
      "type": "string",
      "description": "Next page URL if available"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "polygon-io": {
      "url": "https://gateway.pipeworx.io/polygon-io/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

aggregates