# momentum-score

> Momentum Score API for Base tokens: 0-100 score from 24 h volume, volume vs liquidity and 24 h price change, from DEX data and on-chain pool reads. $0.02 per call via x402 (USDC on Base or Polygon). Not investment advice.

- Base URL: https://momentum-score.restockalarm.workers.dev
- Pay per call via x402: USDC on Base (eip155:8453) or Polygon PoS (eip155:137), payTo 0x7B97303d62517eA9E26D1E1b199Eac42a487F430
- Free demo: 5 calls/day per IP under /demo/...
- Card alternative: X-API-Key header, 4 credits per call. Credit packs (all APIs): 250 calls $1.25 https://space-command-kits-shop.fourthwall.com/products/api-credits-250-calls | 1000 calls $5 https://space-command-kits-shop.fourthwall.com/products/api-credits-1000-calls | 5000 calls $15 https://space-command-kits-shop.fourthwall.com/products/api-credits-5000-calls; claim key https://api-keys.restockalarm.workers.dev/claim
- No address: GET without address answers for the AERO example (0x940181a94A35A4569E4529A3CDfB74e38FD98631) with example=true and a note; an invalid address is still 400
- Errors: 400 bad input, 404 no contract, 422 no data, 503 + Retry-After = a core field could not be measured right now (not charged: x402 not settled, API-key credits refunded)
- Core fields: volume_24h_usd and price_change_24h_pct (except stablecoins: for those, momentum is null and only identity/price is required). volume comes from DexScreener/GeckoTerminal h24 when they answer, else Swap events in the largest pools. Swap window starts at ~20 min (600 blocks); if fewer than 30 valued swaps, it expands to ~2 h then ~6 h via parallel getLogs chunks, as long as the total answer stays under ~2 s. The window is always stated. price_change: aggregator h24, else slot0/getReserves now vs a historical block (24 h → 6 h → 2 h). Temporary holes → 503 + Retry-After, not charged. social is NOT a core field.
- Output (API v2.0.0): enum values are canonical English (low/medium/high, ok/warning/unknown, no_data …); ?lang=da returns the previous Danish values. *_en mirror fields are deprecated (removal in v3).
- OpenAPI: https://momentum-score.restockalarm.workers.dev/openapi.json
- Manifest: https://momentum-score.restockalarm.workers.dev/.well-known/x402.json

## Endpoints
- GET https://momentum-score.restockalarm.workers.dev/v1/momentum?address={address} — $0.02 — Momentum score for an ERC-20 token on Base: 0-100 from 24 h volume, volume vs liquidity and 24 h price change, with direction up/down/flat and a one-line explanation

## Related
- https://token-verdict.restockalarm.workers.dev — One-call verdict: all 4 checks + English conclusion (Base, $0.05)
- https://token-risk.restockalarm.workers.dev — Token risk score (Base)
- https://rug-check.restockalarm.workers.dev — Rug-pull detector (Base)
- https://holder-check.restockalarm.workers.dev — Holder analysis (Base)
- Token Safety suite: https://product-katalog.restockalarm.workers.dev/token-safety
- MCP server (same tools incl. token_verdict; x402 $0.02, verdict $0.05): https://token-safety-mcp.restockalarm.workers.dev/mcp
- Catalog: https://product-katalog.restockalarm.workers.dev/llms.txt