When to Use

Use this tool when you need to the earnings surprises bulk api allows users to retrieve bulk data on annual earnings surprises, enabling quick analysis of which companies have beaten, missed, or met their earnings estimates. this api provides actual versus estimated earnings per share (eps) for multiple companies at once, offering valuable insights for investors and analysts.. This is part of the Financial Modeling Prep provider on xpay✦.

MCP Connection

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

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

For Claude Code:

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/getEarningsSurprisesBulk")
2. xpay_run — Execute: xpay_run("financial-modeling-prep/getEarningsSurprisesBulk", { ...inputs })

Input Parameters

Pricing

• Cost: $0.01/call
• Balance check: Use xpay_balance to check remaining credits
• Get your API key at xpay.tools — $5 free credits included

Related Skills

• Financial Modeling Prep (all tools) — 253 tools
• SearchSymbol — $0.01/call
• SearchName — $0.01/call
• SearchCIK — $0.01/call
• SearchCUSIP — $0.01/call
• SearchISIN — $0.01/call

Links

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