# GET /v1/xrpl/stablecoin/{asset}

Is this XRPL issued currency the canonical stablecoin it claims to be?

## Purpose

Answers from a closed registry of canonical stablecoins, each entry taken from the issuer's own documentation. `canonical` is true only for a registry asset, and `registry_entry` then names the issuer and links its own documentation. `posture` is the issuer's controls read live on the latest validated ledger (`global_freeze`, `allow_clawback`, `require_auth`, `no_freeze` and `transfer_fee_pct`) and compared with a dated snapshot: `posture_matches_registry` says whether every fact still matches, and `posture_differences` lists each one that changed as `<field>_changed`. A registry issuer whose account is missing answers `posture: null` with `issuer_not_found`, still 200. `impersonation_risk` is computed from the request alone, with no upstream call: it is true when the currency code is a registry code but the issuer is not its canonical issuer, and `canonical_issuer` then names that issuer. No regulatory or licensing status is returned, and a canonical answer is not an endorsement of the token.

## When to use

Before accepting or quoting a stablecoin: to check the asset is the canonical one and that its issuer facts have not changed since the snapshot.

## When not to use

To read supply or balances (use `/v1/xrpl/token/{asset}` or `/v1/xrpl/account/{address}/lines`), or as a regulatory or licensing check: none is served.

## Parameters

| Name | In | Required | Description | Constraints | Example |
|---|---|---|---|---|---|
| `asset` | path | yes | XRPL issued currency as `CODE.issuer`. `XRP`, or `CODE.issuer`: `CODE` is a 3-character standard code or 40 hexadecimal digits, and `issuer` is a classic XRPL address. Standard codes are case-sensitive: `usd` and `USD` are different tokens, so send the exact code. A standard code uses letters, digits or `?!@#$%^&*<>(){}[]\|` and is never `XRP`; percent-encode the symbols in a URL (for example `%3F` for `?`). A 40-hex code is read in any case, and the 40-hex form of a standard code means that code. | An issued asset, never `XRP`. `XRP`, or `CODE.issuer`: `CODE` is a 3-character standard code or 40 hexadecimal digits, and `issuer` is a classic XRPL address. Standard codes are case-sensitive: `usd` and `USD` are different tokens, so send the exact code. A standard code uses letters, digits or `?!@#$%^&*<>(){}[]\|` and is never `XRP`; percent-encode the symbols in a URL (for example `%3F` for `?`). A 40-hex code is read in any case, and the 40-hex form of a standard code means that code. | `4555524F50000000000000000000000000000000.rMkEuRii9w9uBMQDnWV5AA43gvYZR9JxVK` |

## Request example

```sh
curl -s "https://api.criptonlabs.com/v1/xrpl/stablecoin/4555524F50000000000000000000000000000000.rMkEuRii9w9uBMQDnWV5AA43gvYZR9JxVK"
```

## Response example (200)

```json
{
  "canonical": true,
  "registry_entry": {
    "symbol": "EURØP",
    "peg": "EUR",
    "issuer_name": "Schuman Financial",
    "source_url": "https://schuman.io/smart-contracts"
  },
  "posture": {
    "global_freeze": false,
    "allow_clawback": true,
    "require_auth": false,
    "no_freeze": false,
    "transfer_fee_pct": "0"
  },
  "posture_matches_registry": true,
  "posture_differences": [],
  "snapshot_date": "2026-11-11",
  "impersonation_risk": false,
  "canonical_issuer": null,
  "meta": {
    "ledger_index": 108303733,
    "as_of": "2026-11-13T12:53:50.035Z",
    "age_seconds": 0,
    "cache": "miss",
    "stale": false
  }
}
```

## Errors

- 400 [invalid-parameters](https://api.criptonlabs.com/errors/invalid-parameters.md)
- 400 [bad-request](https://api.criptonlabs.com/errors/bad-request.md)
- 429 [rate-limited](https://api.criptonlabs.com/errors/rate-limited.md)
- 503 [upstream-unavailable](https://api.criptonlabs.com/errors/upstream-unavailable.md)

## Caching

Fresh for 10 seconds; on upstream failure the last good value is served for up to 120 seconds (`meta.stale` is `true`), then the service answers 503. See the [freshness guide](https://api.criptonlabs.com/docs/guides/freshness.md).

## Rate limit

Tier `cheap`. See the [rate-limits guide](https://api.criptonlabs.com/docs/guides/rate-limits.md).

## MCP tool

The MCP tool `xrpl_stablecoin` returns the same data. See the [MCP quickstart](https://api.criptonlabs.com/docs/guides/mcp-quickstart.md).
