Gainers & Losers

Track the top performing and worst performing tokens across different timeframes.

Endpoints

Endpoint	Description	Price
GET /api/market/gainers	Top gainers	$0.01
GET /api/market/losers	Top losers	$0.01
GET /api/market/movers	Combined movers	$0.01
GET /api/market/gainers/{chain}	Chain-specific gainers	$0.01

---

GET /api/market/gainers

Get tokens with the highest price increase.

Request

curl https://api.web3identity.com/api/market/gainers

Response

{
  "gainers": [
    {
      "rank": 1,
      "symbol": "PEPE",
      "name": "Pepe",
      "contract": "0x6982508145454Ce325dDbE47a25d4ec3d2311933",
      "chain": "ethereum",
      "price": 0.00001234,
      "change1h": 5.67,
      "change24h": 45.67,
      "change7d": 123.45,
      "volume24h": 234567890,
      "marketCap": 5200000000,
      "high24h": 0.00001350,
      "low24h": 0.00000850
    },
    {
      "rank": 2,
      "symbol": "WIF",
      "name": "dogwifhat",
      "chain": "solana",
      "price": 2.34,
      "change24h": 34.56,
      "volume24h": 567890123,
      "marketCap": 2340000000
    }
  ],
  "period": "24h",
  "updatedAt": "2026-02-08T04:30:00Z",
  "count": 20
}

Query Parameters

Param	Type	Default	Description
limit	number	20	Max results (1-100)
period	string	24h	1h, 24h, 7d, 30d
minMarketCap	number	1000000	Min market cap USD
minVolume	number	100000	Min 24h volume USD
chain	string	all	Filter by chain

SDK

const gainers = await client.getGainers({
  period: '24h',
  limit: 10,
  minMarketCap: 10000000
});

---

GET /api/market/losers

Get tokens with the largest price decrease.

Request

curl "https://api.web3identity.com/api/market/losers?period=24h&limit=20"

Response

{
  "losers": [
    {
      "rank": 1,
      "symbol": "BADCOIN",
      "name": "Bad Coin",
      "chain": "ethereum",
      "price": 0.0001234,
      "change24h": -45.67,
      "change7d": -78.90,
      "volume24h": 12345678,
      "marketCap": 5000000,
      "reason": "whale_dump"
    },
    {
      "rank": 2,
      "symbol": "RUGPULL",
      "name": "Rug Pull Token",
      "chain": "base",
      "price": 0.00001,
      "change24h": -89.12,
      "volume24h": 234567,
      "marketCap": 100000,
      "reason": "liquidity_removed"
    }
  ],
  "period": "24h",
  "count": 20
}

---

GET /api/market/movers

Get both gainers and losers in one request.

Request

curl "https://api.web3identity.com/api/market/movers?limit=10"

Response

{
  "gainers": [
    {
      "rank": 1,
      "symbol": "PEPE",
      "change24h": 45.67,
      "price": 0.00001234
    },
    {
      "rank": 2,
      "symbol": "WIF",
      "change24h": 34.56,
      "price": 2.34
    }
  ],
  "losers": [
    {
      "rank": 1,
      "symbol": "BADCOIN",
      "change24h": -45.67,
      "price": 0.0001234
    }
  ],
  "period": "24h",
  "updatedAt": "2026-02-08T04:30:00Z"
}

---

GET /api/market/gainers/{chain}

Get top gainers for a specific blockchain.

Supported Chains

• ethereum
• base
• arbitrum
• optimism
• polygon
• solana
• avalanche
• bsc

Request

curl "https://api.web3identity.com/api/market/gainers/base?period=24h"

Response

{
  "chain": "base",
  "chainId": 8453,
  "gainers": [
    {
      "rank": 1,
      "symbol": "BRETT",
      "name": "Brett",
      "contract": "0x532f27101965dd16442E59d40670FaF5eBB142E4",
      "price": 0.15,
      "change24h": 56.78,
      "volume24h": 45678900,
      "dexVolume": 23456789,
      "holders": 125000
    }
  ],
  "period": "24h",
  "count": 20
}

---

Category Movers

GET /api/market/movers/{category}

Get movers within a specific category.

# Meme coin movers
curl https://api.web3identity.com/api/market/movers/meme

# DeFi movers
curl https://api.web3identity.com/api/market/movers/defi

# AI token movers
curl https://api.web3identity.com/api/market/movers/ai

Available Categories

Category	Description
meme	Meme coins
defi	DeFi protocols
ai	AI-related tokens
gaming	Gaming/metaverse
l1	Layer 1 chains
l2	Layer 2 tokens
stablecoin	Stablecoins (peg deviation)
nft	NFT-related tokens

---

Historical Movers

GET /api/market/movers/historical

Get historical top movers for a specific date.

curl "https://api.web3identity.com/api/market/movers/historical?date=2026-02-07"

{
  "date": "2026-02-07",
  "gainers": [
    {
      "symbol": "EXAMPLE",
      "change24h": 234.56,
      "openPrice": 0.001,
      "closePrice": 0.00334
    }
  ],
  "losers": [
    {
      "symbol": "FALLEN",
      "change24h": -67.89,
      "openPrice": 0.10,
      "closePrice": 0.032
    }
  ]
}

---

Market Summary

GET /api/market/summary

Get overall market performance summary.

curl https://api.web3identity.com/api/market/summary

{
  "summary": {
    "totalMarketCap": 2850000000000,
    "totalVolume24h": 125000000000,
    "btcDominance": 52.3,
    "ethDominance": 16.8,
    "marketChange24h": 2.45
  },
  "sentiment": "bullish",
  "fearGreedIndex": 72,
  "topMover": {
    "gainer": { "symbol": "PEPE", "change24h": 45.67 },
    "loser": { "symbol": "BADCOIN", "change24h": -45.67 }
  },
  "timestamp": "2026-02-08T04:30:00Z"
}

---

SDK Examples

JavaScript

import { Web3IdentityClient } from '@web3identity/sdk';

const client = new Web3IdentityClient();

// Get 24h gainers
const gainers = await client.getGainers({
  period: '24h',
  limit: 20,
  minMarketCap: 1000000
});

// Get losers on Base
const baselosers = await client.getLosers({
  chain: 'base',
  period: '24h'
});

// Get combined movers
const movers = await client.getMovers({
  limit: 10,
  category: 'meme'
});

// Market summary
const summary = await client.getMarketSummary();

Python

from web3identity import Client

client = Client()

# Get gainers
gainers = client.get_gainers(period='24h', limit=20)

# Get movers by category
defi_movers = client.get_movers(category='defi')

cURL with Filters

# High cap gainers only
curl "https://api.web3identity.com/api/market/gainers?minMarketCap=100000000&limit=10"

# Weekly losers with volume filter
curl "https://api.web3identity.com/api/market/losers?period=7d&minVolume=1000000"

# Solana movers
curl "https://api.web3identity.com/api/market/movers?chain=solana&limit=20"

---

Errors

Code	HTTP	Description
INVALID_PERIOD	400	Period must be 1h, 24h, 7d, or 30d
INVALID_CHAIN	400	Chain not supported
NO_DATA	404	No market data available
HISTORICAL_LIMIT	400	Historical data limited to 90 days

---

Related Endpoints

• Token Prices — Price lookups
• Trending Tokens — Trending tokens
• Token Analysis — Security checks