# SwapHunt Momentum Rank

> SwapHunt Momentum Rank is a paid API for AI agents from x402.swaphunt.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Returns a ranked leaderboard of top and bottom performing coins by return over a chosen period (24h, 7d, or 30d), surfacing rotation candidates.

## Facts

- Endpoint: GET https://x402.swaphunt.dev/v1/market/momentum-rank
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/swaphunt-momentum-rank-ba2a29c0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ErCAS3jKdEgatebXoGd8w

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability swaphunt-momentum-rank-ba2a29c0
```

Example prompt: Show me the top and bottom 15 crypto coins ranked by momentum over the last 7 days, quoted in USDT — I'm looking for rotation candidates.

## When to prefer this

Use this endpoint when you need a fast, ranked snapshot of which coins are outperforming or underperforming over a given window — ideal for momentum screening and sector rotation decisions. Prefer over full fundamentals endpoints when you only need relative performance ranking, not detailed token data.

## Known failure modes

- Invalid period value (not 24h, 7d, or 30d) returns a 400 error
- Limit out of range (must be 1-20) returns a validation error
- Unsupported quote currency returns an error
- Payment not sent or insufficient USDC triggers 402 Payment Required
- Service unavailable or upstream data feed issue returns 5xx

## How this service works

Top and bottom momentum coins ranked by return over the chosen period — a leaderboard of what's running and what's bleeding. Use to surface rotation candidates. Returns ranked movers, not full fundamentals.

## Output

A ranked leaderboard of coins sorted by return over the specified period, including top gainers and bottom losers with their percentage returns, intended to identify momentum and rotation opportunities. Does not include full fundamentals.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "default": 10,
       "description": "Number of coins to return (1-20)"
      },
      "quote": {
       "type": "string",
       "default": "USDT",
       "description": "Quote currency (USDT, USDC, EUR)"
      },
      "period": {
       "type": "string",
       "default": "24h",
       "description": "Period (24h, 7d, 30d)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/swaphunt-momentum-rank-ba2a29c0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.swaphunt.dev](https://www.zero.xyz/host/x402.swaphunt.dev/llms.txt)