Riddle Market API

Client → api.riddlewallet.com / cdn.riddlewallet.com (edge cache) → xrpl.to market index + public XRPL CDN RPC

• Cache: JSON ~90s fresh / 15m stale-on-upstream-429; thumbs long-lived on CDN host
• Suite vs customer: Suite = free. External customers pay for API keys with higher RPM. Free anonymous is rate-limited.
• Compatibility: xrpl.to /v1 — Paths mirror common market reads. Responses are proxied from trusted upstream indexers with edge caching. Write/auth endpoints are not exposed on this public API.

Suite apps are free. Public free tier works without a key; production customers use X-Api-Key. Quote URLs in shells (zsh globs on ?).

# Health
curl -s "https://api.riddlewallet.com/v1/health"

# Your plan / limits (anonymous free shown without key)
curl -s "https://api.riddlewallet.com/v1/me"

# Top tokens by 24h XRP volume
curl "https://api.riddlewallet.com/v1/tokens?limit=10&sortBy=vol24hxrp&sortType=desc"

# Single token + sparkline + OHLC
curl "https://api.riddlewallet.com/v1/token/{md5}"
curl "https://api.riddlewallet.com/v1/sparkline/{md5}?period=24h"
curl "https://api.riddlewallet.com/v1/ohlc/{md5}?interval=1h&limit=72"
curl "https://api.riddlewallet.com/v1/holders/info/{md5}"

# NFT metadata + collections + account inventory
curl "https://api.riddlewallet.com/v1/nft/{NFTokenID}"
curl "https://api.riddlewallet.com/v1/nft/collections?limit=24&sort=vol24h&order=desc"
curl "https://api.riddlewallet.com/v1/nft/account/{rAddress}/nfts"

# Public XRPL JSON-RPC (read-only)
curl "https://api.riddlewallet.com/v1/xrpl?method=account_info&account=r…"

# CDN thumbs (prefer for <img>)
curl -I "https://cdn.riddlewallet.com/thumb/{md5}"
curl -I "https://cdn.riddlewallet.com/nft-thumb/{NFTokenID_or_hash}"
curl -I "https://cdn.riddlewallet.com/nft-collection-thumb/{hash}"

# Full docs
curl -s "https://api.riddlewallet.com/v1/docs"
curl -s "https://api.riddlewallet.com/v1/docs.md"

• Suite (free for us): Riddle suite apps (*.riddlewallet.com Origin/Referer) are free with high limits. Server apps may send X-Riddle-Suite-Key.
• Anonymous free tier: Public free tier works without a key (low RPM). Good for demos; not for production scrapers.
• Customer API key (paid): Paid plans: header X-Api-Key: rk_… or Authorization: Bearer rk_… Contact hello@riddlewallet.com or DevTools API console.
• Upstream (Riddle only): Riddle servers use XRPL_TO_API_KEY only upstream — never sent to clients. Customers hit our cache.
• Client header: X-Api-Key or Authorization: Bearer
• Check your plan: GET https://api.riddlewallet.com/v1/me — suite Origin shows suite plan; send X-Api-Key for paid tiers.

• Free: 30 JSON req/min · 120 media/min (anonymous)
• Bronze: 120 / 600 · $9.99/mo
• Silver: 600 / 3000 · $29.99/mo
• Gold: 3000 / 15000 · $99.99/mo
• Suite: 2000 / 8000 · free for Riddle apps

Cache JSON 30–90s client-side. Always load images from cdn.riddlewallet.com. On 429 see Retry-After and upgrade plans in the body.

Useful response headers: X-Riddle-APIX-Riddle-CacheX-Riddle-SourceX-Riddle-CDNAccess-Control-Allow-Origin

Base URL: https://api.riddlewallet.com/v1 · Style: xrpl.to /v1 · JSON · Markdown

curl -s "https://api.riddlewallet.com/v1/health"

curl -s "https://api.riddlewallet.com/v1/me"

curl -s "https://api.riddlewallet.com/v1/docs"

curl -s "https://api.riddlewallet.com/v1/docs.md"

curl -s "https://api.riddlewallet.com/v1/tokens?limit=10&sortBy=vol24hxrp&sortType=desc"

curl -s "https://api.riddlewallet.com/v1/token/{32-hex-md5}"

curl -s "https://api.riddlewallet.com/v1/sparkline/{md5}?period=24h"

curl -s "https://api.riddlewallet.com/v1/ohlc/{md5}?interval=1h&limit=72"

curl -s "https://api.riddlewallet.com/v1/holders/info/{md5}"

curl -s "https://api.riddlewallet.com/v1/tags"

curl -s "https://api.riddlewallet.com/v1/xrpl?method=account_info&account=r…"

curl -s "https://api.riddlewallet.com/v1/nft/collections?limit=24&sort=vol24h&order=desc"

curl -s "https://api.riddlewallet.com/v1/nft/collections/{slug}"

curl -s "https://api.riddlewallet.com/v1/nft/{64-hex-NFTokenID}"

curl -s "https://api.riddlewallet.com/v1/nft/account/rXXXX…/nfts"

curl -s "https://cdn.riddlewallet.com/thumb/{md5}"

curl -s "https://cdn.riddlewallet.com/nft-thumb/{NFTokenID_or_hash}"

Host: https://cdn.riddlewallet.com · Prefer CDN URLs in <img> tags (long edge cache).

Long-lived edge cache (max-age up to 1d, s-maxage up to 7d) with stale-while-revalidate. Prefer CDN URLs in <img> tags.

CORS: Access-Control-Allow-Origin: * · Types: Typically image/webp; fall through to upstream type

Ledger RPC CDNs used by /v1/xrpl: https://xrplcluster.com · https://s1.ripple.com:51234 · https://s2.ripple.com:51234

<!-- Always use CDN for images -->
<img src="https://cdn.riddlewallet.com/thumb/{md5}" width="32" height="32" alt="" />
<img src="https://cdn.riddlewallet.com/nft-thumb/{NFTokenID}" alt="" loading="lazy" />
<img src="https://cdn.riddlewallet.com/nft-collection-thumb/{hash}" alt="" loading="lazy" />

JavaScript

const API = "https://api.riddlewallet.com/v1";
const CDN = "https://cdn.riddlewallet.com";

// Token screener
const { tokens } = await fetch(
  `${API}/tokens?limit=48&sortBy=vol24hxrp&sortType=desc`
).then((r) => r.json());

// NFT metadata
const nft = await fetch(`${API}/nft/${nftId}`).then((r) => r.json());

// Prefer CDN for images (long edge cache)
const logoUrl = `${CDN}/thumb/${md5}`;
const artUrl = `${CDN}/nft-thumb/${nftId}`;

TypeScript

const API = "https://api.riddlewallet.com/v1" as const;
const CDN = "https://cdn.riddlewallet.com" as const;

type TokensResponse = {
  success?: boolean;
  count?: number;
  tokens?: Array<{ md5?: string; currency?: string; issuer?: string }>;
};

export async function loadTopTokens(limit = 48): Promise<TokensResponse> {
  const res = await fetch(
    `${API}/tokens?limit=${limit}&sortBy=vol24hxrp&sortType=desc`,
    { headers: { Accept: "application/json" } }
  );
  if (!res.ok) throw new Error(`Market API ${res.status}`);
  return res.json();
}

export function tokenLogoUrl(md5: string): string {
  return `${CDN}/thumb/${md5}`;
}

export function nftThumbUrl(idOrHash: string): string {
  return `${CDN}/nft-thumb/${idOrHash}`;
}

React

function TokenLogo({ md5, alt }: { md5: string; alt?: string }) {
  return (
    <img
      src={`https://cdn.riddlewallet.com/thumb/${md5}`}
      alt={alt || ""}
      width={32}
      height={32}
      loading="lazy"
      referrerPolicy="no-referrer"
    />
  );
}

Health-backed links first (verified targets). App shells below.

Paths mirror common market reads. Responses are proxied from trusted upstream indexers with edge caching. Write/auth endpoints are not exposed on this public API.