---
name: "xpay-financial-modeling-prep-getpositionssummary"
description: "The Positions Summary API provides a comprehensive snapshot of institutional holdings for a specific stock symbol. It tracks key metrics like the number of investors holding the stock, changes in the number of shares, total investment value, and ownership percentages over time."
version: "1.0.0"
price: "$0.01/call"
provider: "Financial Modeling Prep"
---

# GetPositionsSummary

The Positions Summary API provides a comprehensive snapshot of institutional holdings for a specific stock symbol. It tracks key metrics like the number of investors holding the stock, changes in the number of shares, total investment value, and ownership percentages over time.

**Provider:** Financial Modeling Prep
**Price:** $0.01/call
**Pricing model:** Flat rate per call

## When to Use

Use this tool when you need to the positions summary api provides a comprehensive snapshot of institutional holdings for a specific stock symbol. it tracks key metrics like the number of investors holding the stock, changes in the number of shares, total investment value, and ownership percentages over time.. This is part of the Financial Modeling Prep provider on xpay✦.

## MCP Connection

Connect to xpay✦ to access this tool (and 252+ others):

```json
{
  "mcpServers": {
    "xpay": {
      "url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
    }
  }
}
```

For Claude Code:
```bash
claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
```

## How to Execute

Use the xpay✦ meta-tools to run this tool:

1. **`xpay_details`** — Get full input schema: `xpay_details("financial-modeling-prep/getPositionsSummary")`
2. **`xpay_run`** — Execute: `xpay_run("financial-modeling-prep/getPositionsSummary", { ...inputs })`

## Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `symbol` | string | Yes | Stock symbol |
| `year` | string,number | Yes | Year of filing |
| `quarter` | string,number | Yes | Quarter of filing (1-4) |

## Pricing

- **Cost:** $0.01/call
- **Balance check:** Use `xpay_balance` to check remaining credits
- Get your API key at [xpay.tools](https://xpay.tools/account/settings/api-keys/) — $5 free credits included

## Related Skills

- [Financial Modeling Prep (all tools)](https://xpay.tools/skills/financial-modeling-prep/SKILL.md) — 253 tools
- [SearchSymbol](https://xpay.tools/skills/financial-modeling-prep/searchsymbol/SKILL.md) — $0.01/call
- [SearchName](https://xpay.tools/skills/financial-modeling-prep/searchname/SKILL.md) — $0.01/call
- [SearchCIK](https://xpay.tools/skills/financial-modeling-prep/searchcik/SKILL.md) — $0.01/call
- [SearchCUSIP](https://xpay.tools/skills/financial-modeling-prep/searchcusip/SKILL.md) — $0.01/call
- [SearchISIN](https://xpay.tools/skills/financial-modeling-prep/searchisin/SKILL.md) — $0.01/call

## Links

- Tool page: https://xpay.tools/financial-modeling-prep/getpositionssummary/
- Provider: https://xpay.tools/financial-modeling-prep/
- All tools: https://xpay.tools/explore