Free API · Risk + Verified

Integrate Risk & Verification Into Your App

Add XRPL token risk scores and Rhyzlo Verified status to any wallet, DEX, or dApp. The REST API is free — create a free key for full data access at 10,000 requests/day, or embed the keyless SVG badge and risk score anywhere.

XRPL Your App

Get started

Connect your wallet

API keys are bound to your XRPL wallet — Xaman, GemWallet, Crossmark, or Joey.

Generate an API key

Sign a one-time message (no transaction, no fee) and create your first key.

Copy an example request

Send your key as the X-API-Key header for 10,000 req/day. The SVG badge and risk score stay keyless at 1,000 req/day per IP.

Monitor usage

Requests per day, per key, with limits and history in the Usage tab.

API Keys

Generate & manage keys

Trustline Widget

Embeddable trustline flow

Full Docs

API reference & guides

Token Trust

For DEXs

GET

/api/v1/tokens/:issuer/:currency/trust

Risk score and Rhyzlo Verified status for a token in a single keyed call — the drop-in primitive for DEXs and wallets. Risk is non-blocking by default (returns a pending status on a cache miss and computes in the background); pass ?wait=true to block on a cold compute.

Request

bash
curl https://api.rhyzlo.com/api/v1/tokens/rsoLo2S1kiGeCcn6hCUXVrCpGMWLrRrLZz/USD/trust \
  -H "X-API-Key: rhy_your_key_here"

Response

json
{
  "success": true,
  "data": {
    "issuer": "rsoLo2S1kiGeCcn6hCUXVrCpGMWLrRrLZz",
    "currency": "USD",
    "risk": { "score": 10, "level": "minimal", "status": "ready" },
    "certification": { "verified": true, "claimed": true, "teamClaimed": false }
  }
}

Risk Score API

GET

/api/v1/tokens/:issuer/risk?currency=XXX

Returns a 0–100 risk score with individual risk factors and trust signals for any XRPL token issuer. Keyless at 1,000/day per IP — add a key for 10,000/day.

Request

bash
curl https://api.rhyzlo.com/api/v1/tokens/rsoLo2S1kiGeCcn6hCUXVrCpGMWLrRrLZz/risk?currency=USD

Response

json
{
  "success": true,
  "data": {
    "issuer": "rsoLo2S1kiGeCcn6hCUXVrCpGMWLrRrLZz",
    "currency": "USD",
    "score": 10,
    "level": "minimal",
    "summary": "This token shows positive signals. Always do your own research.",
    "riskFactors": [],
    "trustSignals": [
      { "signal": "verified_domain", "weight": -15, "description": "Domain ownership verified" },
      { "signal": "widely_adopted", "weight": -15, "description": "Over 400 holders" },
      { "signal": "long_history", "weight": -5, "description": "Established account" },
      { "signal": "has_amm_pool", "weight": -5, "description": "Active AMM liquidity pool" }
    ],
    "warnings": [],
    "maxScore": 100,
    "isTrustedIssuer": false,
    "isLaunchpadToken": false,
    "launchpadPlatform": null,
    "dataCompleteness": {
      "level": "high",
      "checkedSignals": 6,
      "totalPossible": 8,
      "missingData": []
    },
    "assessedAt": "2026-03-15T10:38:29.861Z"
  }
}

SVG Badge

Auto-updates hourly

/api/v1/badge/:issuer?currency=XXX

A shields.io-style SVG image showing the live risk score. Embed it as an <img> tag anywhere — READMEs, dashboards, token pages. Cached for 1 hour.

Preview:

html
<!-- SVG Badge — auto-updates hourly -->
<a href="https://rhyzlo.com/token/rISSUER?currency=USD">
  <img
    src="https://api.rhyzlo.com/api/v1/badge/rISSUER?currency=USD"
    alt="Rhyzlo Risk Score"
  />
</a>

Risk Badge Script

~4KB

A lightweight script that renders an inline risk score display. Fetches the live score and shows it with “Risk Score by Rhyzlo” attribution and a link to the full report. Supports dark/light themes and three sizes (sm, md, lg).

Preview:

25low riskRisk Score by Rhyzlo

html
<!-- Risk Badge Script — lightweight inline display -->
<script src="https://rhyzlo.com/risk-badge.js"></script>
<div class="rhyzlo-risk-badge"
     data-issuer="rISSUER"
     data-currency="USD"
     data-theme="dark">
</div>

data-theme

“dark” (default) or “light”

data-size

“sm”, “md” (default), or “lg”

data-currency

Optional. 3-char code or hex.

Attribution Required

All free integrations must display “Risk Score by Rhyzlo” with a link to the full report on rhyzlo.com. The SVG badge and risk badge script include attribution automatically. For raw API usage, add the attribution to your UI.

html
<a href="https://rhyzlo.com/token/{issuer}?currency={currency}" target="_blank" rel="noopener">
  Risk Score by Rhyzlo
</a>

Rate Limits

Tier	Daily Limit	Price	API Key	Attribution
Public embeds	1,000 / day per IP	Free	Not required (badge + score)	Required
API key	10,000 / day	Free	Yes (free, instant)	Required
Need more?	Custom	Free	hello@rhyzlo.com	Required