Resolve account display names + verification status in bulk (max 50)

{ nftokenId, account, action: "add"|"remove" }

Point-in-time XRP + token holdings valued in XRP at a historical ledger (resolve time to ledger via /ledger/at first)

Check ledger objects with live funding status for cashable checks

Search accounts by display name / X profile

Wallet activity analysis and profiling (20 credits)

Distinct trade sourceTags with trader counts and volume totals

Required for key management and account operations

Currently active token boosts (admin only)

Quote price for boosting an NFT collection (slug also accepts "<issuer>:<taxon>")

Initiate Stripe-paid NFT collection boost

Check Stripe checkout status for NFT boost

{ fromCurrency, toCurrency, fromAmount, address, refundAddress? }

Paginated holder richlist with acquisition tracking

Top 24h buyers and sellers by holder balance delta

Historical exchange rates by timestamps (XRP base)

Daily OMCF-filtered marketcap (same as homepage gMarketcap) back to 2021-09-26

Bulk account-to-rank lookup within the holder richlist

One account's stake in a token — balance, share of supply and rank, without building the holder list

Batch sparklines for multiple tokens (cached 30s)

Zero-balance trustlines (dust/airdrop accounts; precomputed bot accounts excluded)

Creator activity filtered by recipient address

Whale social-proof trade events — top holders of major tokens, smart money, named accounts, whale-sized and fresh-wallet trades on this token

Embeddable candlestick chart (HTML iframe)

Embeddable token safety-score badge (HTML iframe)

Create new API key (1 active key on free tier, 5 on paid tiers)

Revoke API key (first call revokes; calling again on a revoked key permanently deletes it)

Subscription details and available upgrades

Available API tiers with live XRP pricing

{ wallet, type: "credits"|"tier", package?: "starter|standard|bulk|mega", tier?: "developer|business|professional", billing?: "monthly|yearly" }

Verify XRP payment and apply credits/tier

{ wallet, type, package?, tier?, billing? }

Invoice detail for a payment (sequential INV-YYYY-NNNNN number assigned on first fetch)

{ currencyCode, tokenSupply, ammXrpAmount, name, origin, user, antiSnipe?, imageData?, domain?, description?, telegram?, twitter?, userCheckAmount?, platformRetentionPercent?, ammTradingFee?, bundleRecipients?[] }

Calculate required XRP funding (400 on invalid params)

User launch history with total count (requires X-Api-Key)

Token launches by wallet with total count

Vesting schedule for a launched token (response includes truncated flag when escrow list is incomplete)

Resolve a datetime to the last ledger closed at or before it (binary search)

AMM LP positions with impermanent loss analysis

Agent-friendly search across X/Twitter mentions with full-text + filters. Returns enriched tweets with token name, spam/impostor flags.

Global social feed with trending tokens, top authors, activity chart, and impostor list

Per-token mention feed with stats, top mentioners, and activity chart

X Space hosts with full history and inferred schedule (days/hour UTC). Returns all known space hosts sorted by most recent activity.

OpenAPI 3.0 spec for the mentions endpoints (agent/MCP discoverable)

Full timeline of tracked influencer tweets (not just token matches)

Live X/Twitter search via scraper (503 if scraper unavailable)

Grok-generated XRPL insight topics with sentiment

Latest X profile snapshot + change history for a handle

Resolve a collection from its XLS-20 on-chain identity (issuer account + taxon) to the full collection object incl. slug/cid. Every {slug} param on /nft/* endpoints ALSO accepts this identity directly as "<issuer>:<taxon>" (e.g. /nft/collections/rLyr...:1234/history)

Collection metrics snapshot (floor + deltas, volumes, sales, owners, listings)

NFTs/collections owned with portfolio value

NFT offers owned + incoming buy/sell offers (top 500 newest owned NFTs scanned; incomingOffersTruncated flag; fraud/fraudType detection)

Global NFT market stats (same source as /nft/global-metrics)

Holder distribution by tier (whales/orcas/dolphins/fish/shrimp)

NFT collection rotations by collection id

NFT-scam insights snapshot — totals (XRP/token drained, NFTs flagged, scam wallets), monthly timeline, top scammers/victims, tokens drained with XRP values, recent drain feed, and scamIssuersList (flat array of every flagged-issuer address for client-side filtering). For per-NFT checks, use GET /nft/:nftId — it already returns scam + scamType.

Listed-price distribution vs floor (buckets at 1x/1.25x/1.5x/2x/3x/5x/10x floor), floor/median/avg/max

Daily listed-count history merged with floor/volume/sales

Mint counts over time with cumulative total

Batch floor sparklines for multiple collections

Distinct NFT marketplaces with trader counts

Pin NFT media to platform IPFS node (resolves hash from NFT URI if only NFTokenID given)

Daily report dates with metadata, newest first

Aggregated trading stats grouped by platform key (numeric SourceTag, or canonical name for memo-identified platforms like SPYDEX)

Top tokens traded via a single platform; summary covers ALL tokens for the platform/period, not just returned rows

{ currencyCode, name, origin, tokenSupply, goalXrp, softCapXrp, durationHours, tradingFee, creatorPct?, creatorVestDays?, imageData?, description?, twitter?, telegram?, website? }

Create a presale (issuer + sale wallets are provisioned server-side)

Join — returns the conditional EscrowCreate to sign

Finalize after deadline/goal: capture escrows, deliver claim Checks, seed AMM, blackhole wallets

Presale status (public view; refreshes claim states on success)

Per-buyer claim (CheckCash) or refund (EscrowCancel) transaction to sign

Get promotion pool info (status, amounts, expiry)

Claim earned promotion rewards (paid in XRP)

Four independent layers apply to every request; the strictest one wins. All 429 responses carry Retry-After plus X-RateLimit-Limit/-Remaining/-Reset headers and a JSON body with retryAfter.

Referral earnings breakdown for an address

Referral fee history; response includes asReferrerTotal/asRecruitTotal for paging

Resolve a referral code to validity/owner

THE canonical scam blocklist: top-level addresses[] is the deduped union of every blocked account (drainers, dust/token spam, phishing, impersonation, fake airdrops, NFT-scam issuers). Check a Destination/counterparty against it BEFORE a user signs. Real-time, never cached (Cache-Control: no-store) — poll every ~5s. Per-category sections (nftPhishing, paymentDrain) are additive metadata and may overlap; addresses is deduped.

Tokens issued by one named issuer. issuer is required — this endpoint lists an issuer's tokens, it does not classify them. For a scam verdict use /scams/addresses or /scams/check/{account}.

Check if account is a known scam. is_scam is true ONLY for accounts on the verified blocklist or confirmed scam NFT issuers — never inferred from an account's token names or token count. Also returns first_seen/age_seconds/new_account (advisory counterparty freshness, independent of is_scam)

Dry-run transaction preview (400 on invalid tx input); sender_after = simulated sender position {balance, reserve, spendable}, null when no sender AccountRoot change

Lookup a submitted XRPL transaction by hash

NFT image/thumbnail (original format, CSP-sandboxed for SVG)

XRPL.to API

display ticker/name

Token distribution analysis from creator wallet (precomputed)

All {id} parameters accept any of these formats:

Token risk assessment (score 1-10, lower = safer)

Single token by id (see tokenFields for the token object dictionary)

Search tokens, NFTs, collections, and accounts. limit max 100; offset clamped so offset+limit <= 100

{ user?, domain?, whitepaper?, description?, social?, tags? (max 15; origin/launchpad tags admin-only), linkedCollections? (max 10) }

Update token metadata. 3s per-token write cooldown.

{ imageData: base64 PNG/JPEG/GIF/WebP (max ~650KB decoded) }

Upload token logo image. 3s per-token write cooldown.

Per-account token rotation flow (XRP bought/sold per token in window)

{ source_account, destination_token, destination_value?, source_value?, source_token?, slippage? }

Get swap quote with routing / path finding (successor to POST /account/path-find). Exact-output via destination_value, or exact-input via source_value

Tweet verifications for a token (md5) or NFT collection (slug)

{ md5 (token md5 or NFT slug), tweetUrl, account, type?: token|nft }

Verify a promotional tweet and credit the wallet. 5-min cooldown per account, 3 tokens/day per Twitter author, one tweet per token.

Human-readable transaction explanation (10 credits)

User tiers with pricing (member, vip, nova, diamond, verified)

Full account doc split into editable editorial fields vs read-only ledger/derived state, plus the manualFields lock list, the lockedByChain list (fields tx derives from the ledger) and a derived block (decoded on-chain Domain, attributed domain, desc kind)

{ name?, desc?, domain?, twitter?, adminVerified?, verifiedLogo?, verifiedTagRequired? }

Edit editorial fields. Each written field is added to manualFields so the owning background service skips it (tokendata + grok-whale-labeler honour this) — null/empty unsets. Raw ledger fields and scam flags are not editable; `domain` returns 409 when the account sets an on-chain Domain, because tx re-derives it from the ledger.

{ imageData: base64 (PNG/JPEG/GIF/WebP, ~650KB) }

Upload an account logo; served self-hosted at GET /api/account-thumb/{address}

Admin-set account logo image bytes (404 when unset)

Batch-resolve admin-verified destination identity (name, logo, tagRequired). Only verified accounts are returned — absence means unknown, which is the safety signal.

{ name (1-60), logo (image id), tagRequired? }

Set verified destination identity (admin only — never user-settable)

Get your own wallet labels — private data, owner-authenticated

Update username (VIP+ required to change an existing one; tier field is admin-only)

Only actively-watched wallet labels — private data, owner-authenticated

{ wallet, label (1-50 chars), watching? }

Create/update a wallet label (per-tier cap; 402 when limit reached)

Toggle live-watch on a label (per-tier watcher cap)

Create XRP invoice for user tier (expires 30 min)

Verify tier XRP payment (scans fee collector; expired invoices honored if exact payment exists)

{ gifterAddress, recipientAddress, tier }

Service health check with per-service latency

OpenAPI 3.1 spec for the whole API (270+ paths)

This documentation (JSON). Browsers (Accept: text/html) are redirected to the human-readable docs.

Check Stripe verification payment status; fulfills if webhook was missed

Create XRP invoice for token/collection verification

Multi-token market sync (handshake first, token data via updates)

Token holder richlist streaming (id = token md5)

Live account activity feed (parsed tx events)

Raw account transaction stream (same shape as GET /account/tx)

Creator activity stream (identifier = token md5 or creator address)

Complete XRPL API reference. Access XRP Ledger token prices, DEX trading data, NFT analytics, and 310 endpoints. Free public API with WebSocket support.

XRPL API Documentation: XRP Ledger Token & NFT Data API | XRPL.to

Complete reference for the XRPL.to public REST and WebSocket API. Token prices, DEX data, NFT analytics, and more.

XRPL.to API

Base URL

Start Building

Quick Start

Rate Limits

API Reference

Quick Start Example