/v1/search
Search tokens, NFTs, collections, and accounts. limit max 100; offset clamped so offset+limit <= 100
Payload
https://api.xrpl.to/v1/search{ search, offset?, limit? }
curl -X POST 'https://api.xrpl.to/v1/search' \
-H 'Content-Type: application/json' \
-d '{ "search": "rlusd", "limit": 5 }'Response
https://api.xrpl.to/v1/search{ "success": true, "took": 16, "tokens": [ { "_id": "0dd550278b74cb6690fdae351e8e0df3", "trustlines": 103260, "holders": 68205, "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": 1.071231098861469, "usd": "1.0012797081058150743", "marketcap": 823302254.3998277, "p24h": -0.0374841249696792, "pro24h": -3.380861393798973, "social": { "twitter": "ripple" }, "tags": [ "Stablecoin", "Ripple", "XRPL", "United States" ], "user": "Ripple", "domain": "ripple.com", "tvl": 3999264.851834, "AMM": "rhWTXC2m2gGGA9WozUaoMm6kLAVPb1tcS3", "vol24hxrp": 11229119.220272, "creator": "rJqiMb94hyz41SBTNr2AyPNW8AzELa8nE", "trendingBoost": 0, "trendingBoostExpires": null }, { "_id": "5000bcd4507b06c98b7c9b29cc3f002a", "trustlines": 2206, "holders": 85, "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.0005498793471464485, "usd": "0.00051431040157628047878", "marketcap": 10195.726628167637, "p24h": 0.0000116794193973585, "pro24h": 2.1700893655272946, "tags": [ "Scam", "XRPL" ], "tvl": 228.09664199999997, "AMM": "raouvYQ28Rr556naUBtqLgzNpYqWYA4Fjw", "vol24hxrp": 2.8081259999999997, "domain": "ripple.com", "creator": "rippLE4uy7r898MzuHTeTe7sPfuUDafLB" }, { "_id": "078d4605c070b84d09aa7919baa2db5a", "trustlines": 1394, "holders": 1192, "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": 4017822.251464, "p24h": 0, "pro24h": 0, "exch": 0.0024681184681036613, "usd": "0.000037310818000516240538", "AMM": null, "creator": "rPSvcmNAvc6DAZYX2w5WM4bcnLKSxyt8VY", "lpOMCF": true, "pairMd5": "0dd550278b74cb6690fdae351e8e0df3" }, { "_id": "9496050ffea63b7dc772cf76ad789132", "trustlines": 470, "holders": 243, "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.1223983615524375e-12, "usd": "5.022089535997423367e-12", "marketcap": 4015.3225547726815, "p24h": 0, "pro24h": 0, "social": { "twitter": "RippleUSDollar" }, "user": "RLUSD", "tags": [ "FirstLedger", "Memes" ], "tvl": 1237.230528, "AMM": "rpBJWcaQYyiHvbqbfxM2FNRrDxRzxYHxTe", "vol24hxrp": 0, "creator": "rnp7ZHURfLVcjKTE3gcCJmsWrGeucXaW26", "domain": "uszvwtdzbprq4pih39fd.toml.firstledger.net" }, { "_id": "881e6fa45db5ba21c87eb1f1f4bdbefe", "trustlines": 231, "holders": 136, "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.1782699566869786e-8, "usd": "1.1442996559702406771e-8", "marketcap": 1145.2204773604892, "p24h": 0, "pro24h": 0, "domain": "ripple.com", "social": { "twitter": "Ripple" }, "user": "Ripple USD Stable Coin", "tags": [ "FirstLedger", "Memes", "United States" ], "tvl": 757.955466, "AMM": "roFFuvmPytzdNR3Xhk8ckJF6qAzQL7fTg", "vol24hxrp": 0, "creator": "rGH93PfE2tpqDmY7gbGRq1oMoVtaum17BP" } ], "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": 1794639920000, "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": 4, "floorATH": 4, "floorAthPercent": 0, "floor24hAgo": 4, "floor7dAgo": 4, "floor30dAgo": 3, "floor90dAgo": 3, "floor1dPercent": 0, "floor7dPercent": 0, "floor30dPercent": 33.33333333333333, "floor90dPercent": 33.33333333333333, "floorHigh24h": 4, "floorLow24h": 4, "listedCount": 1, "offers": 0, "topOffer": null }, { "_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", "items": 1, "owners": 1, "tags": [], "rarity": "score", "floor": 15000, "floorATH": 15000, "floorAthPercent": 0, "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, "floorAthPercent": 0, "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 }, { "_id": "1c350d0d896b4b7d99e57f95fc5f2db6", "uuid": "1c350d0d896b4b7d99e57f95fc5f2db6", "name": "Los Huevos Locos", "slug": "los-huevos-locos", "description": "First cNFT on XRPL utilizing HVI3 technology. Los Huevos Locos is a digital hand drawn collection created in collaboration by Adrian Corrales and Humanity Vs Insanity (HVI). Art is based on a Las Vegas experience, for the full story talk to Adrian. This digital art was created using an iPad with unique attributes focused on expression. Utility: Beta Test Collection fully managed on HVI3.com for th…", "account": "rB7UyKs9SwS4pX87tqtMjq4XRiEhkBfmuH", "taxon": 7, "type": "normal", "origin": "xrp.cafe", "verified": false, "created": 1792553531592, "time": 1795156910000, "logoImage": "1792553531668_a7e1a134a9f3424e8d548e1ecf3c55a6.webp", "twitter": "AdrianCorrales", "website": "https://hvi3.com/nft-management", "items": 1178, "owners": 86, "tags": [], "rarity": "score", "floor": 3.8, "floorATH": 9, "floorAthPercent": -57.777777777777786, "floor24hAgo": 3.8, "floor7dAgo": 3.8, "floor30dAgo": 0.98411, "floor90dAgo": 0.98411, "floor1dPercent": 0, "floor7dPercent": 0, "floor30dPercent": 286.1356962128217, "floor90dPercent": 286.1356962128217, "floorHigh24h": 3.8, "floorLow24h": 3.8, "listedCount": 40, "offers": 0, "topOffer": { "issuer": "XRPL", "currency": "XRP", "amount": 3.860382, "nftid": "00081F4072D67B49A7ED6E16B05851CF77CDC8475B5FD738959F36B105A0221B", "buyer": "rnuKwE785mUzy2JUryZogmDkbAv69DL6bX" }, "marketcap": { "amount": 4476.4, "currency": "XRP", "issuer": "XRPL" }, "totalVolume": 179.78788299999994, "totalVol24h": 0, "vol24h": 0, "vol7d": 5.525596 }, { "_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": 1, "pct": 25 }, { "c": "AR", "n": 1, "pct": 25 }, { "c": "IN", "n": 1, "pct": 25 }, { "c": "BB", "n": 1, "pct": 25 } ], "items": 165, "owners": 44, "tags": [], "rarity": "score", "NFTMinter": "rPggP6j56hLemAcgwBWKu3n9iXBF8DHkUq", "totalNFTsMinted": 242, "floor": null, "floorATH": 10.1, "floorAthPercent": null, "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": 30, "trendingScore": 0 } ], "nfts": [ { "_id": "00080000348675F10A11EE0E494A4510C7623F7B354DE220C1286A9B05F76100", "account": "rPZcrxJsjHFCULnU5yYyXz8WaVrNQoVMaB", "issuer": "rn8jD7Uixth2uDbSSEjKVfaHiNZkM4Nfyc", "collection": "Collection n8jD7Uix-0", "cslug": "collection-n8jd7uix-0", "name": "RLUSD", "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", "total": 55, "files": [ { "thumbnail": { "small": "cc81ead44a296cb6d1e8797dacd9a250s", "medium": "cc81ead44a296cb6d1e8797dacd9a250m", "large": "cc81ead44a296cb6d1e8797dacd9a250l" } } ] }, { "_id": "0008271035CF9DF306097EBA1B30FA614C0C37E691ED26981119B88304747AF4", "account": "r4uo8i75PU4MR3iCnA8dx6RqKvxKq7Mvta", "issuer": "rnuXXecrYw5MX6TojAdjqQ8G5kZpMmR21Q", "collection": "Ripple Art ", "cslug": "rlusdbirth", "name": "RLUSD BIRTH #24", "total": 55, "files": [ { "thumbnail": { "small": "cc81ead44a296cb6d1e8797dacd9a250s", "medium": "cc81ead44a296cb6d1e8797dacd9a250m", "large": "cc81ead44a296cb6d1e8797dacd9a250l" } } ] }, { "_id": "0008271035CF9DF306097EBA1B30FA614C0C37E691ED26981539BD8804747AE9", "account": "rsau5sj4i3fzhpyPmBfPHA8amgddqRK9Wd", "issuer": "rnuXXecrYw5MX6TojAdjqQ8G5kZpMmR21Q", "collection": "Ripple Art ", "cslug": "rlusdbirth", "name": "RLUSD BIRTH #13", "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", "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.
{ 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