# CoinMarketCap API: List gainers and losers > Lists the largest price rises and falls among CoinMarketCap's top 100 coins with over $50,000 in 24-hour volume, for a chosen period. Unofficial. Not affiliated with or endorsed by CoinMarketCap. - Page: https://fous.com/methods/coinmarketcap.com/list-gainers-and-losers - Method: `coinmarketcap.com/list_gainers_and_losers`, version 1 - Website: coinmarketcap.com - Returns: direction, name, symbol, rank, price, change percent, 24h volume, link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `period` | string | no | `"last_24_hours"` | Price change period, for example last_7_days. One of "last_24_hours", "last_7_days", "last_30_days". Default "last_24_hours". | | `direction` | string | no | `"both"` | Which movers to list, for example both. One of "gainers", "losers", "both". Default "both". | | `max_results` | integer | no | `20` | Maximum coins per direction, for example 20. Default 20. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "period": "last_24_hours", "direction": "both", "max_results": 20 } ``` Its output: ```json { "movers": [ { "link": "https://coinmarketcap.com/currencies/polkadot-new/", "name": "Polkadot", "rank": 44, "symbol": "DOT", "direction": "Gainer", "price_usd": 1.187439047230054, "change_percent": 7.08214617, "volume_24h_usd": 147696940.48598027 }, { "link": "https://coinmarketcap.com/currencies/dash/", "name": "Dash", "rank": 75, "symbol": "DASH", "direction": "Gainer", "price_usd": 54.17480096963489, "change_percent": 6.48428568, "volume_24h_usd": 116037131.63992655 }, { "link": "https://coinmarketcap.com/currencies/cosmos/", "name": "Cosmos", "rank": 66, "symbol": "ATOM", "direction": "Gainer", "price_usd": 1.8114728185807658, "change_percent": 6.1865522, "volume_24h_usd": 49094775.5388867 } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"coinmarketcap.com/list_gainers_and_losers","input":{"period":"last_24_hours","direction":"both","max_results":20}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Which cryptocurrencies gained the most over the last 7 days among the top 100 coins? - Show me the biggest losers in the past 30 days, up to 15 coins, with their current prices and 24h volume. - What coins jumped the most in the last 24 hours on coinmarketcap.com? List both gainers and losers. - I need the top 10 gainers over the past month with their ranks and percent change. - Give me a list of the steepest price drops in the last 24 hours, limited to 25 results, including each coin's symbol and link. ## Input schema ```json { "type": "object", "required": [], "properties": { "period": { "enum": [ "last_24_hours", "last_7_days", "last_30_days" ], "type": "string", "default": "last_24_hours", "description": "Price change period, for example last_7_days." }, "direction": { "enum": [ "gainers", "losers", "both" ], "type": "string", "default": "both", "description": "Which movers to list, for example both." }, "max_results": { "type": "integer", "default": 20, "maximum": 30, "minimum": 1, "description": "Maximum coins per direction, for example 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "movers" ], "properties": { "movers": { "type": "array", "items": { "type": "object", "required": [ "direction", "name", "symbol", "rank", "price_usd", "change_percent", "volume_24h_usd", "link" ], "properties": { "link": { "type": "string" }, "name": { "type": "string" }, "rank": { "type": [ "integer", "null" ] }, "symbol": { "type": "string" }, "direction": { "enum": [ "Gainer", "Loser" ], "type": "string" }, "price_usd": { "type": [ "number", "null" ] }, "change_percent": { "type": [ "number", "null" ] }, "volume_24h_usd": { "type": [ "number", "null" ] } } }, "description": "Gainers from largest rise, followed by losers from largest fall." } } } ``` ## See more - [CoinMarketCap API: List top coins by market cap](https://fous.com/methods/coinmarketcap.com/list-top-coins.md): Lists the largest cryptocurrencies on CoinMarketCap ranked by market cap. Each coin comes with its price, changes, volume and supply in the chosen currency. - [CoinMarketCap API: Get coin price](https://fous.com/methods/coinmarketcap.com/get-coin-price.md): Gets a cryptocurrency's price, changes, supply, market cap, volume and all-time high in a chosen currency. If a name or symbol is shared, returns the coin with the largest market cap. - [CoinMarketCap API: Get Fear and Greed Index](https://fous.com/methods/coinmarketcap.com/get-fear-and-greed-index.md): Returns the current crypto Fear and Greed Index with yesterday, last week and last month comparisons, plus total crypto market size, BTC and ETH dominance from CoinMarketCap. - [Google API: List Google Finance market movers](https://fous.com/methods/google.com/list-market-movers.md): Lists today's leading gainers, losers or most active stocks in Google Finance display order, with price, change, percent change and currency; the public page shows up to four stocks per list. - [Yahoo API: List market movers](https://fous.com/methods/finance.yahoo.com/list-market-movers.md): Lists Yahoo Finance's top gainers, top losers, most active stocks, or regional trending tickers in Yahoo's order, with price, change, volume and market cap. - [CoinGecko API: Get coin price history](https://fous.com/methods/coingecko.com/get-coin-price-history.md): Gets a coin's daily prices and price change over the last 7, 30, 90 or 365 days, with UTC dates. Today's price may change. - [MSN API: List market movers](https://fous.com/methods/msn.com/list-market-movers.md): Lists MSN Money's current leading stock gainers, losers, or most-active shares in a selected market, in MSN's order. Lists may contain fewer than 50 stocks and prices may be delayed. - [CoinGecko API: List trending coins](https://fous.com/methods/coingecko.com/list-trending-coins.md): Lists up to 15 of the most-searched coins on CoinGecko in trending order, with price and 24-hour change in the chosen currency. Non-USD prices may be unavailable for some coins. - [All CoinMarketCap methods](https://fous.com/methods/coinmarketcap.com.md)