POST
/v1/search
Search tokens, NFTs, collections, and accounts. limit max 100; offset clamped so offset+limit <= 100
AuthNone — works without a key
Request
POST
https://api.xrpl.to/v1/searchBody
Body fieldsas documented
{ search, offset?, limit? }
curl -X POST 'https://api.xrpl.to/v1/search' \
-H 'Content-Type: application/json' \
-d '{ "search": "rlusd", "limit": 5 }'Response
200Example response14 ms · just now · 17 KB · 545 lines
https://api.xrpl.to/v1/search{ "success": true, "took": 13, "tokens": [ { "_id": "0dd550278b74cb6690fdae351e8e0df3", "trustlines": 98086, "holders": 67329, "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De", "currency": "524C555344000000000000000000000000000000", "name": "RLUSD", "md5": "0dd550278b74cb6690fdae351e8e0df3", "slug": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De-524C555344000000000000000000000000000000", "ext": "png", "dateon": 1723248000000, "date": "2024-08-10", "kyc": true, "verified": 1, "hashicon": false, "exch": 0.6960637599166128, "usd": "1.0012181122640558515", "marketcap": 721387699.0072485, "p24h": -0.0278850113829449, "pro24h": -3.851793453960639, "social": { "twitter": "ripple" }, "tags": [ "Stablecoin", "Ripple", "XRPL", "Trending", "United States" ], "user": "Ripple", "domain": "ripple.com", "tvl": 3284632.559432, "AMM": "rhWTXC2m2gGGA9WozUaoMm6kLAVPb1tcS3", "vol24hxrp": 4717550.398937, "creator": "rJqiMb94hyz41SBTNr2AyPNW8AzELa8nE", "trendingBoost": 0, "trendingBoostExpires": null }, { "_id": "881e6fa45db5ba21c87eb1f1f4bdbefe", "trustlines": 235, "holders": 141, "issuer": "rhmXd7bfUYPgv4CpfCZMnrEkNkz5X6WioS", "currency": "524C555344000000000000000000000000000000", "name": "RLUSD", "md5": "881e6fa45db5ba21c87eb1f1f4bdbefe", "slug": "rhmXd7bfUYPgv4CpfCZMnrEkNkz5X6WioS-524C555344000000000000000000000000000000", "ext": "webp", "dateon": 1731888000000, "date": "2024-11-18", "verified": false, "hashicon": false, "exch": 1.2853092360825306e-8, "usd": "1.874753051847e-8", "marketcap": 1249.257395427485, "p24h": -4.01525639174694e-10, "pro24h": -3.029326376472663, "domain": "ripple.com", "social": { "twitter": "Ripple" }, "user": "Ripple USD Stable Coin", "tags": [ "FirstLedger", "Memes", "United States", "Dip" ], "tvl": 791.565714, "AMM": "roFFuvmPytzdNR3Xhk8ckJF6qAzQL7fTg", "vol24hxrp": 13.254618, "creator": "rGH93PfE2tpqDmY7gbGRq1oMoVtaum17BP" }, { "_id": "078d4605c070b84d09aa7919baa2db5a", "trustlines": 1411, "holders": 1205, "issuer": "rhWTXC2m2gGGA9WozUaoMm6kLAVPb1tcS3", "currency": "03B245BE580EC4F4386A751C084489EC4B514A2F", "name": "LP XRP/RLUSD", "md5": "078d4605c070b84d09aa7919baa2db5a", "slug": "rhWTXC2m2gGGA9WozUaoMm6kLAVPb1tcS3-03B245BE580EC4F4386A751C084489EC4B514A2F", "ext": "webp", "dateon": 1738309599457, "date": "2025-01-30", "kyc": false, "verified": false, "hashicon": true, "marketcap": 3279138.83694, "p24h": 0, "pro24h": 0, "exch": 0.0019561705273860577, "usd": "1.106877232799194053", "AMM": null, "creator": "rPSvcmNAvc6DAZYX2w5WM4bcnLKSxyt8VY", "lpOMCF": true, "pairMd5": "0dd550278b74cb6690fdae351e8e0df3" }, { "_id": "5000bcd4507b06c98b7c9b29cc3f002a", "trustlines": 2261, "holders": 81, "issuer": "rLUSDfDxGQ28Dn3ZtRSTzuqfzBaacRmNm8", "currency": "524C555344000000000000000000000000000000", "name": "RLUSD", "md5": "5000bcd4507b06c98b7c9b29cc3f002a", "slug": "rLUSDfDxGQ28Dn3ZtRSTzuqfzBaacRmNm8-524C555344000000000000000000000000000000", "ext": "webp", "dateon": 1722556800000, "date": "2024-08-02", "kyc": false, "verified": false, "hashicon": false, "exch": 0.0011866617811035931, "usd": "0.0015356450204835574277", "marketcap": 35606.95366518012, "p24h": 0, "pro24h": 0, "tags": [ "Scam", "XRPL", "Overbought" ], "tvl": 327.713612, "AMM": "raouvYQ28Rr556naUBtqLgzNpYqWYA4Fjw", "vol24hxrp": 0, "domain": "ripple.com", "creator": "rippLE4uy7r898MzuHTeTe7sPfuUDafLB" }, { "_id": "9496050ffea63b7dc772cf76ad789132", "trustlines": 465, "holders": 241, "issuer": "rGovFdpM9LHE5U6DJVR3mLcpAMAxTJffWH", "currency": "524C555344000000000000000000000000000000", "name": "RLUSD", "md5": "9496050ffea63b7dc772cf76ad789132", "slug": "rGovFdpM9LHE5U6DJVR3mLcpAMAxTJffWH-524C555344000000000000000000000000000000", "ext": "webp", "dateon": 1733011200000, "date": "2024-12-01", "verified": false, "hashicon": false, "exch": 5.305980678203564e-12, "usd": "6.8648198446117625857e-12", "marketcap": 4159.228234237113, "p24h": 0, "pro24h": 0, "social": { "twitter": "RippleUSDollar" }, "user": "RLUSD", "tags": [ "FirstLedger", "Memes" ], "tvl": 1259.204308, "AMM": "rpBJWcaQYyiHvbqbfxM2FNRrDxRzxYHxTe", "vol24hxrp": 0, "creator": "rnp7ZHURfLVcjKTE3gcCJmsWrGeucXaW26", "domain": "uszvwtdzbprq4pih39fd.toml.firstledger.net" } ], "collections": [ { "_id": "177fbbcadcaa496881f1987695e43a1c", "uuid": "177fbbcadcaa496881f1987695e43a1c", "name": "Ripple Art ", "slug": "rlusdbirth", "description": "Hand drawn Art relating to Ripple and XRP ", "account": "rnuXXecrYw5MX6TojAdjqQ8G5kZpMmR21Q", "issuer": "rnuXXecrYw5MX6TojAdjqQ8G5kZpMmR21Q", "taxon": 12, "type": "normal", "origin": "xrp.cafe", "verified": false, "created": 1734519442000, "time": 1778500150000, "logoImage": "483b07cfc0430be046ad187bfc869561", "twitter": "LorenHandArt", "website": "https://t.co/tll2zENIbK", "country": "United Kingdom", "countryCc": "GB", "items": 55, "owners": 18, "tags": [ "Traditional Art", "XRPL Native" ], "rarity": "score", "NFTMinter": "XRPL", "totalNFTsMinted": 318, "floor": 3, "floorATH": 3, "floor24hAgo": 3, "floor7dAgo": 3, "floor30dAgo": 3, "floor90dAgo": 3, "floor1dPercent": 0, "floor7dPercent": 0, "floor30dPercent": 0, "floor90dPercent": 0, "floorHigh24h": 3, "floorLow24h": 3, "listedCount": 2, "offers": 0, "marketcap": { "amount": 165, "currency": "XRP", "issuer": "XRPL" }, "totalVolume": 87.36654 }, { "_id": "75824f3bfc8d4314b01e56fe02240199", "uuid": "75824f3bfc8d4314b01e56fe02240199", "name": "RLUSD Launch - Historic First Transaction", "slug": "rlusd", "description": "This collection marks the historic moment that RLUSD trading went live on the XRP Ledger. The unique 1/1 NFT in this collection represents the very first on-ledger transaction for RLUSD, which was at the top of the limit buy offers in the orderbook so cleared first.\r\nInteresting fact: This transaction valued RLUSD at an astronomical 10,000,000,000,000,000 XRP (that's 10 quadrillion XRP). Not bad f…", "account": "rBfBN6Jt7Hxk5XAA27aL8vzenxXT8zhvzq", "issuer": "rBfBN6Jt7Hxk5XAA27aL8vzenxXT8zhvzq", "taxon": 589, "type": "normal", "origin": "xrp.cafe", "verified": false, "created": 1734477480000, "time": 1774211912000, "logoImage": "c99fa1546c06d70bf4c3ed455ddb363a", "twitter": "ovenbound", "website": "https://www.eolasinnovation.com", "country": "United Kingdom", "countryCc": "GB", "countries24h": [ { "c": "US", "n": 1, "pct": 100 } ], "items": 1, "owners": 1, "tags": [], "rarity": "score", "floor": 15000, "floorATH": 15000, "floor24hAgo": 15000, "floor7dAgo": 15000, "floor30dAgo": 15000, "floor90dAgo": 15000, "floor1dPercent": 0, "floor7dPercent": 0, "floor30dPercent": 0, "floor90dPercent": 0, "floorHigh24h": 15000, "floorLow24h": 15000, "listedCount": 1, "offers": 0, "topOffer": { "issuer": "XRPL", "currency": "XRP", "amount": 5, "nftid": "000861A86EDC4C5CD294D81FA1EBE48AEA422F1026333297C4BE4E73040B2FA3", "buyer": "rLgmVQQW8jcJ23zQDc5QL1qfoHXyba3D51" }, "marketcap": { "amount": 15000, "currency": "XRP", "issuer": "XRPL" }, "totalVolume": 0 }, { "_id": "4f02dca6f5264374b69ae4b6f46f1966", "uuid": "4f02dca6f5264374b69ae4b6f46f1966", "name": "CryptoworldHQ Series - RLUSD", "slug": "cryptoworldhq-series-rlusd", "description": "Welcome to Crypto World, a neon-charged, laugh-out-loud animated series where blockchain titans run the wildest business ops in the crypto universe!", "account": "rN9FkohiLdNPqNTxGR9LNizPrrCiQvfk8H", "issuer": "rN9FkohiLdNPqNTxGR9LNizPrrCiQvfk8H", "taxon": 14, "type": "normal", "origin": "xrp.cafe", "verified": false, "created": 1765425741000, "logoImage": "1765425760910_2a51a504df024acd8e2f1b725f732367.webp", "twitter": "CryptoWorldHQ", "website": "https://cryptoworldhq.com", "country": "United States", "countryCc": "US", "items": 25, "owners": 1, "tags": [], "rarity": "score", "floor": 58.9, "floorATH": 58.9, "floor24hAgo": 58.9, "floor7dAgo": 58.9, "floor30dAgo": 58.9, "floor90dAgo": 58.9, "floor1dPercent": 0, "floor7dPercent": 0, "floor30dPercent": 0, "floor90dPercent": 0, "floorHigh24h": 58.9, "floorLow24h": 58.9, "listedCount": 25, "offers": 0, "marketcap": { "amount": 1472.5, "currency": "XRP", "issuer": "XRPL" }, "totalVolume": 0, "sales24h": 0, "totalSales": 0, "daily_txs": 0 }, { "_id": "43f8b19666a94b5fa36206fadbe0156e", "uuid": "43f8b19666a94b5fa36206fadbe0156e", "name": "Moo Deng Kawaii", "slug": "moo-deng-kawaii", "description": "This special collection is a celebration & testimony of a collaborative action to empower brands, artists, collectors & investors in the digital economy. Strengthening the commitment to build the legacy and value of collectible digital assets within the OpulenceX ecosystem by the artists for holders & collectors. “Baby Moo“ were created with Kawaii art techniques adding more diversity to the ex…", "account": "rN7JhSjQ63FMAgQSb1Z9MDoc1ewdimRZxb", "issuer": "rN7JhSjQ63FMAgQSb1Z9MDoc1ewdimRZxb", "taxon": 0, "type": "normal", "origin": "OpulenceX", "verified": false, "created": 1738547652000, "time": 1775957001000, "logoImage": "1764749801572_72c4978b28ea4a80a93f8adee40a3561.webp", "image": "1769987485494_9e8c9846a52d41f385caec706995fdd5.webp", "twitter": "https://x.com/OpulenceX_NFT", "website": "https://nftmarketplace.opulencex.io/", "countries24h": [ { "c": "US", "n": 6, "pct": 100 } ], "items": 165, "owners": 44, "tags": [], "rarity": "score", "NFTMinter": "rPggP6j56hLemAcgwBWKu3n9iXBF8DHkUq", "totalNFTsMinted": 242, "floor": null, "floorATH": 10.1, "listedCount": 0, "offers": 0, "topOffer": null, "marketcap": { "amount": 1666.5, "currency": "XRP", "issuer": "XRPL" }, "totalVolume": 1262.5, "totalVol24h": 0, "vol24h": 0, "sales24h": 0, "totalSales": 125, "daily_txs": 0, "daily_users": 0, "views24h": 34, "trendingScore": 0, "trendingScore7d": 0 }, { "_id": "5594229fea2f4e4097d8bb908298de7b", "uuid": "5594229fea2f4e4097d8bb908298de7b", "name": "Gopher GoLang", "slug": "gopher-golang", "description": "A unique collection of GoLang Gophers from gopher.xrp golang.xrp gofmt.xrp and their gopher.rlusd golang.rlusd gofmt.rlusd equivalents. Trade $GOPHER on $XRPL by going to https://gopher.xrp.name and set up your Trustline on @xpmarket! Official wallet that launched the $GOPHER token! Ownership of this token will give you exclusive advantages on the future https://gopher.xrp.name dApp coming in 2025…", "account": "rQGQrFFNLH9AEaXxZyiUPWDLhJBbRCMRQR", "issuer": "rQGQrFFNLH9AEaXxZyiUPWDLhJBbRCMRQR", "taxon": 0, "type": "normal", "origin": "xrp.cafe", "verified": false, "created": 1734288661000, "time": 1785186030000, "logoImage": "c5736162d53203d3e3c2d7cefe6e14cf", "twitter": "", "website": "https://gopher.xrp.name/", "items": 37, "owners": 6, "tags": [], "rarity": "score", "NFTMinter": "XRPL", "totalNFTsMinted": 38, "floor": 7, "floorATH": 7, "floor24hAgo": 7, "floor7dAgo": 7, "floor30dAgo": 7, "floor90dAgo": 7, "floor1dPercent": 0, "floor7dPercent": 0, "floor30dPercent": 0, "floor90dPercent": 0, "floorHigh24h": 7, "floorLow24h": 7, "listedCount": 31, "offers": 0, "topOffer": { "issuer": "XRPL", "currency": "XRP", "amount": 1, "nftid": "000880E8FF3458001C935F91F4F49A6A7478643BDD49D0CB6D9BDC84058799E9", "buyer": "rLgmVQQW8jcJ23zQDc5QL1qfoHXyba3D51" }, "marketcap": { "amount": 259, "currency": "XRP", "issuer": "XRPL" }, "totalVolume": 108.34963, "totalVol24h": 0 } ], "nfts": [ { "_id": "00080000348675F10A11EE0E494A4510C7623F7B354DE220C1286A9B05F76100", "account": "rPZcrxJsjHFCULnU5yYyXz8WaVrNQoVMaB", "issuer": "rn8jD7Uixth2uDbSSEjKVfaHiNZkM4Nfyc", "collection": "Collection n8jD7Uix-0", "cslug": "collection-n8jd7uix-0", "name": "RLUSD", "rarity_rank": 180, "total": 183, "files": [ { "thumbnail": { "small": "2d1e7cec35fca0b85ff173aed9668b6as", "medium": "2d1e7cec35fca0b85ff173aed9668b6am", "large": "2d1e7cec35fca0b85ff173aed9668b6al" } } ], "cost": null }, { "_id": "0008271035CF9DF306097EBA1B30FA614C0C37E691ED26980273F17404747ADD", "account": "rnuXXecrYw5MX6TojAdjqQ8G5kZpMmR21Q", "issuer": "rnuXXecrYw5MX6TojAdjqQ8G5kZpMmR21Q", "collection": "Ripple Art ", "cslug": "rlusdbirth", "name": "RLUSD BIRTH #1", "rarity_rank": 1, "total": 55, "files": [ { "thumbnail": { "small": "cc81ead44a296cb6d1e8797dacd9a250s", "medium": "cc81ead44a296cb6d1e8797dacd9a250m", "large": "cc81ead44a296cb6d1e8797dacd9a250l" } } ] }, { "_id": "0008271035CF9DF306097EBA1B30FA614C0C37E691ED26981959C27504747ADE", "account": "rsau5sj4i3fzhpyPmBfPHA8amgddqRK9Wd", "issuer": "rnuXXecrYw5MX6TojAdjqQ8G5kZpMmR21Q", "collection": "Ripple Art ", "cslug": "rlusdbirth", "name": "RLUSD BIRTH #2", "rarity_rank": 2, "total": 55, "files": [ { "thumbnail": { "small": "cc81ead44a296cb6d1e8797dacd9a250s", "medium": "cc81ead44a296cb6d1e8797dacd9a250m", "large": "cc81ead44a296cb6d1e8797dacd9a250l" } } ] }, { "_id": "0008271035CF9DF306097EBA1B30FA614C0C37E691ED2698303F937604747ADF", "account": "rUohDinFGp342JHC1UZhKv7PoDqzSGiMR4", "issuer": "rnuXXecrYw5MX6TojAdjqQ8G5kZpMmR21Q", "collection": "Ripple Art ", "cslug": "rlusdbirth", "name": "RLUSD BIRTH #3", "rarity_rank": 3, "total": 55, "files": [ { "thumbnail": { "small": "cc81ead44a296cb6d1e8797dacd9a250s", "medium": "cc81ead44a296cb6d1e8797dacd9a250m", "large": "cc81ead44a296cb6d1e8797dacd9a250l" } } ], "cost": { "issuer": "XRPL", "currency": "XRP", "amount": 4.5, "dest": "rpx9JThQ2y37FaGeeJP7PXDUVEXY3PHZSC" } }, { "_id": "0008271035CF9DF306097EBA1B30FA614C0C37E691ED26984725647704747AE0", "account": "rsau5sj4i3fzhpyPmBfPHA8amgddqRK9Wd", "issuer": "rnuXXecrYw5MX6TojAdjqQ8G5kZpMmR21Q", "collection": "Ripple Art ", "cslug": "rlusdbirth", "name": "RLUSD BIRTH #4", "rarity_rank": 4, "total": 55, "files": [ { "thumbnail": { "small": "cc81ead44a296cb6d1e8797dacd9a250s", "medium": "cc81ead44a296cb6d1e8797dacd9a250m", "large": "cc81ead44a296cb6d1e8797dacd9a250l" } } ] } ], "order": [ "tokens", "collections", "nfts" ], "account": null, "pagination": { "offset": 0, "limit": 5, "total": 6, "hasMore": true, "maxResults": 100 } }
Long arrays and strings are shortened in the example; Send request for the full answer.
Shapeas documented
{ success, took, tokens[], collections[] (up to 20, best match first; tolerates one typo, missing spaces, initials like "baxc" and extra words like "nft" or "the"), nfts[] (up to 20; identical names in one collection collapse to one row with editions: N; "name #N" queries resolve item N of the named collection), order (result groups strongest match first, e.g. ["nfts","collections","tokens"]), account (always present: account object when search is an r-address, null otherwise), pagination: { offset, limit, total, hasMore, maxResults: 100 } }
What it does
Search tokens, NFTs, collections, and accounts. limit max 100; offset clamped so offset+limit <= 100
Each token comes back with its md5, the id every Token endpoint takes. Go to Token →