Endpoints

Launch Score API endpoints
MethodPathDescriptionCacheLimit
GET/api/score/{mint}Full Launch Score JSON: overall / launch / tradeability, module breakdown, flags, recommendations.5 min (public)60/min per IP
GET/api/score/{mint}/historyHistorical snapshots (up to 60 points). Falls back to current snapshot if none stored.5 min (public)60/min per IP
GET/api/score/{mint}/tradeabilityTradeability score, label, and detail breakdown.5 min (public)60/min per IP
GET/api/badge/{mint}Embeddable SVG badge (360×132) with overall/launch/tradeability + attribution.5 min (public)120/min per IP
GET/embed/score/{mint}HTML iframe widget — dark mini-card with backlink. Zero JS. Frame-friendly.5 min (public)shared with page cache

Score JSON

Full breakdown for one mint. Fields marked in breakdown.launch and breakdown.tradeability sum to the module scores shown on the score page.

curl -s "https://makemeacoin.xyz/api/score/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" | jq

# Response
{
  "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "name": "Bonk",
  "symbol": "BONK",
  "overallScore": 74,
  "launchScore": 68,
  "tradeabilityScore": 80,
  "riskLevel": "medium",
  "status": "ok",
  "lastUpdated": "2026-07-05T10:12:00.000Z",
  "summary": "Public launch check for BONK.",
  "breakdown": {
    "launch": { "mint_authority": 12, "freeze_authority": 12, "supply": 8, "liquidity": 20, "holders": 16 },
    "tradeability": { "route": 30, "slippage": 25, "liquidity": 25 }
  },
  "flags": [],
  "recommendations": []
}

Score History

Historical snapshots — up to 60 points, oldest first. Useful for change-detection bots.

curl -s "https://makemeacoin.xyz/api/score/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/history"

# Response
{
  "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "points": [
    { "timestamp": "2026-07-01T00:00:00.000Z", "overallScore": 72, "launchScore": 66, "tradeabilityScore": 78, "riskLevel": "medium" },
    { "timestamp": "2026-07-05T10:12:00.000Z", "overallScore": 74, "launchScore": 68, "tradeabilityScore": 80, "riskLevel": "medium" }
  ],
  "movement": null
}

Tradeability Detail

Sub-score for how easily a token can actually be bought/sold — route availability, slippage ladder, liquidity.

curl -s "https://makemeacoin.xyz/api/score/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/tradeability"

# Response
{
  "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "symbol": "BONK",
  "tradeabilityScore": 80,
  "tradeabilityLabel": "Good",
  "lastUpdated": "2026-07-05T10:12:00.000Z",
  "detail": { "volume24hUsd": 12345678, "topHolderPct": 12.4 },
  "modules": [
    { "id": "route", "label": "Buy route", "earned": 30, "max": 30 }
  ]
}

Embeddable Badge

Drop the badge on your project page, GitHub README, or Telegram-connected site. Every embed carries a backlink to /score/{mint}.

<!-- HTML (any site) -->
<a href="https://makemeacoin.xyz/score/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" target="_blank" rel="noopener">
  <img src="https://makemeacoin.xyz/api/badge/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
       alt="MMAC Launch Score" width="360" height="120" />
</a>

<!-- Markdown (GitHub README) -->
[![MMAC Launch Score](https://makemeacoin.xyz/api/badge/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263)](https://makemeacoin.xyz/score/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263)

<!-- iframe (strict CSP or ad-blocked images) -->
<iframe src="https://makemeacoin.xyz/embed/score/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
        width="360" height="140" frameborder="0" scrolling="no"
        title="MMAC Launch Score" style="border:0"></iframe>

Prefer the HTML tab on any score page for a one-click copy of the exact snippet for that mint.

Errors

  • 400 — missing / malformed mint address.
  • 404 — mint not found on-chain.
  • 429 — rate limited. Respect Retry-After.
  • 500 — transient upstream RPC failure; retry with backoff.
Try the Score productRead scoring methodology