{"uid":"cap_Yelv2HXZtR0-caSPSMUl9","slug":"momentum-score-api-for-base-tokens-82a0cea8","name":"Momentum Score API for Base Tokens","description":"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.","url":"https://momentum-score.restockalarm.workers.dev/v1/momentum?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 contract address on Base (0x + 40 hex). If omitted, the AERO example is returned with example=true; an invalid address is 400."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"base","token":{"name":"Aerodrome","symbol":"AERO","is_stablecoin":false},"cached":false,"method":"…","address":"0x940181a94a35a4569e4529a3cdfb74e38fd98631","sources":["https://api.dexscreener.com/…"],"momentum":55,"components":{"social":{"level":"ukendt","source":null,"level_en":"unknown","sentence":"Ingen social/nyhedsdata"},"volume_24h_usd":3200000,"price_change_window":"24h","volume_vs_liquidity":2.1,"price_change_24h_pct":-5.9},"confidence":"høj","disclaimer":"Not investment advice. Momentum is computed from on-chain pool data and public DEX endpoints only; it says nothing about whether a token is safe to buy.","confidence_en":"high","signals_measured_list":["volume_24h_usd","volume_vs_liquidity","price_change_24h_pct"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_z1QaOWg4ArHRcgvJR4Y-Q","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a 0–100 momentum score for any ERC-20 token on Base, computed from 24h volume, volume-to-liquidity ratio, and 24h price change using DEX and on-chain pool data.","exampleAgentPrompt":"What's the current momentum score for the AERO token at 0x940181a94a35a4569e4529a3cdfb74e38fd98631 on Base — how's its 24h volume, price change, and volume-to-liquidity ratio looking?","exampleUseCases":[{"title":"Pre-trade momentum check for Base token","prompt":"Before I swap into this Base token at 0x4200000000000000000000000000000000000006, can you pull its momentum score and tell me if it has strong 24h volume and positive price movement?"},{"title":"DeFi portfolio momentum monitoring","prompt":"Check the momentum scores for these three Base tokens — 0x940181a94a35a4569e4529a3cdfb74e38fd98631, 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913, and 0x4ed4e862860bed51a9570b96d89af5e1b0efefed — and flag any with a score above 70."},{"title":"Automated token screener alert","prompt":"I want to find Base tokens that are trending right now — can you score this new token at 0x0578d8a44db98b23bf096a382e016e29a5ce0ffe for momentum and tell me if it's worth watching based on its volume versus liquidity?"}],"resultDescription":"A JSON object containing the momentum score (0–100), component signals (24h USD volume, volume-to-liquidity ratio, 24h price change percentage), confidence level (e.g. 'high'), token metadata (name, symbol, stablecoin flag), whether the result was cached, and a disclaimer. Optionally includes social signal level if available.","failureModes":["Invalid or malformed address (not 0x + 40 hex) returns HTTP 400","Token address not found on Base DEX data sources may return low confidence or incomplete components","Network or upstream DEX API unavailability may cause errors or stale data","Payment failure via x402 (insufficient USDC balance or wrong chain) blocks the response"],"whenToPreferThis":"Use this endpoint when you need a quick, quantified momentum signal for a specific Base ERC-20 token based on real DEX trading data — particularly when you want a single composite score rather than raw DEX metrics. Prefer this over generic DEX APIs when you need a pre-computed, normalized 0–100 score that combines volume, liquidity, and price change into one number, paid per-call with no subscription required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T06:39:46.823Z","isFirstParty":false,"canonicalSlug":"momentum-score-api-for-base-tokens-82a0cea8"}