Skip to main content
GET
/
api
/
v1
/
market
/
gainers
Market Gainers
curl --request GET \
  --url https://stocks-dev.up.railway.app/api/v1/market/gainers
{
  "gainers": [
    {
      "ticker": "<string>",
      "changes": 123,
      "price": "<string>",
      "changesPercentage": "<string>",
      "companyName": "<string>"
    }
  ]
}

​
Overview

Retrieve the top performing stocks with the highest percentage gains for the current trading day. This endpoint provides real-time market data to identify trending and high-momentum stocks.
Data is updated in real-time during market hours and shows after-hours performance when markets are closed.

​
Parameters

This endpoint requires no parameters and returns the top market gainers.

​
Response

​
gainers
array
Array of top gaining stocks

​
Examples

curl "https://stocks-dev.up.railway.app/api/v1/market/gainers"

​
Response Example

{
  "gainers": [
    {
      "ticker": "JEM",
      "changes": 0.57,
      "price": "6.3",
      "changesPercentage": "9.94764",
      "companyName": "707 Cayman Holdings Limited Ordinary Shares"
    },
    {
      "ticker": "TIPT",
      "changes": 2.23,
      "price": "24.72",
      "changesPercentage": "9.91552",
      "companyName": "Tiptree Inc."
    },
    {
      "ticker": "GDXD",
      "changes": 1.89,
      "price": "21.05",
      "changesPercentage": "9.86849",
      "companyName": "MicroSectors Gold Miners -3X Inverse Leveraged ETN"
    }
  ]
}

​
MCP Protocol Usage

For AI agents using the Model Context Protocol: 
{
  "method": "tools/call",
  "params": {
    "name": "fmp_get_market_gainers",
    "arguments": {
      "random_string": "dummy"
    }
  }
}
The random_string parameter is required due to MCP protocol requirements but can be any value.

​
Use Cases

Identify high-momentum stocks for potential day trading opportunities.
Analyze market trends and sector rotation by examining top gainers.
Cross-reference gainers with news events to understand market drivers.
Use as a starting point for further fundamental or technical analysis.

​
Rate Limits

PlanRequests/DayRequests/Minute
Free2505
Starter1,00020
Professional10,000100

Market Losers

Get the biggest market losers of the day

Most Active

Stocks with highest trading volume

Sector Performance

Performance by market sector

Stock Screener

Custom stock screening with filters

​
Error Responses

{
  "error": "Market data temporarily unavailable",
  "detail": "Please try again in a few moments"
}

{
  "error": "Rate limit exceeded",
  "detail": "Too many requests. Please try again later.",
  "retry_after": 60
}

​
Market Hours

Market Hours: 9:30 AM - 4:00 PM ET (Monday-Friday)
Pre-Market: 4:00 AM - 9:30 AM ET
After-Hours: 4:00 PM - 8:00 PM ET
Data reflects the most recent trading session and includes after-hours movements when markets are closed.