Skip to content
Documentation

Integration Guide

How to add Rhyzlo to your site or use the API directly.

Quick Start

The easiest way to add trustline creation to your website is with our embeddable widget.

1. Add the script

<script src="https://rhyzlo.com/widget.js"></script>

2. Add the widget container

<div id="trustline-widget"
     data-issuer="YOUR_ISSUER_ADDRESS"
     data-currency="YOUR_CURRENCY_CODE">
</div>

3. Customize (optional)

<div id="trustline-widget"
     data-issuer="rXXXX..."
     data-currency="USD"
     data-theme="dark"
     data-button-text="Add USD Trustline">
</div>
API Reference

For advanced integrations, use our REST API directly.

GET
/api/v1/tokens/{issuer}/{currency}

Get token information including account data, domain, and credentials.

Response:

{
  "success": true,
  "data": {
    "issuer": "rXXXX...",
    "currency": "USD",
    "account": {
      "address": "rXXXX...",
      "balance": "50000000",
      "flags": 8388608,
      "ownerCount": 12
    },
    "domain": "example.com",
    "transferRate": 0,
    "tokenType": "trustline",
    "credentialSummary": { ... }
  }
}
GET
/api/v1/tokens/{issuer}/risk?currency=XXX

Get risk assessment for a token issuer. Returns a 0–100 score with risk factors and trust signals.

Response:

{
  "success": true,
  "data": {
    "issuer": "rXXXX...",
    "currency": "USD",
    "score": 10,
    "level": "minimal",
    "summary": "This token shows positive signals.",
    "riskFactors": [
      { "factor": "no_email", "weight": 5, "description": "...", "severity": "low" }
    ],
    "trustSignals": [
      { "signal": "verified_domain", "weight": -15, "description": "..." }
    ],
    "warnings": [],
    "maxScore": 100,
    "isTrustedIssuer": false,
    "isLaunchpadToken": false,
    "launchpadPlatform": null,
    "dataCompleteness": {
      "level": "high",
      "checkedSignals": 6,
      "totalPossible": 8,
      "missingData": []
    },
    "assessedAt": "2026-03-15T..."
  }
}
GET
/api/v1/credentials/{address}

Get on-chain credentials (XLS-70) for an account.

Response:

{
  "success": true,
  "data": {
    "address": "rXXXX...",
    "credentials": [...],
    "hasTrustedCredentials": true
  }
}
Widget Options
AttributeTypeDefaultDescription
data-issuerstringrequiredXRPL issuer address
data-currencystringrequiredCurrency code (3-char or hex)
data-theme"dark" | "light""dark"Widget color theme
data-button-textstring"Add Trustline"Button label text
FAQ

How does trustline creation work?

Trustline creation is completely free. Users connect their wallet (Xaman, GemWallet, Crossmark, or Joey), review the token's risk assessment, and sign the TrustSet transaction directly from their wallet.

Is it safe?

Yes. We never ask for secret keys or seed phrases. The TrustSet transaction we generate only authorizes a trustline. It cannot move funds from the user's wallet.

What if something goes wrong?

If you encounter any issues with trustline creation or the widget, contact us at hello@rhyzlo.com for assistance.

Can I customize the widget appearance?

Currently we support dark and light themes. For custom branding or white-label solutions, please contact us at hello@rhyzlo.com.