GET
/v1/testnet/tokens/{md5}/trades
Fills of a Testnet token, newest first
AuthNone — works without a key
Request
GET
https://api.xrpl.to/v1/testnet/tokens/ecfb8f46ab12687bf34adeda926a9adb/trades| Path parameter | Value | Description |
|---|---|---|
| md5 | The token's md5 (md5 of issuer_currency) |
| Query parameter | Value | Description |
|---|---|---|
| limit | 1-200 | |
| page | from 1 |
curl 'https://api.xrpl.to/v1/testnet/tokens/ecfb8f46ab12687bf34adeda926a9adb/trades'
Response
200Example response57 ms · just now · 4.7 KB · 155 lines
https://api.xrpl.to/v1/testnet/tokens/ecfb8f46ab12687bf34adeda926a9adb/trades{ "success": true, "took": 55, "trades": [ { "_id": "84e5efeb89c4eae8f68188982dc290d8_21650784_1_6E51EFC1", "maker": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1", "taker": "rN21yRRJyYsKTvf3MGSKyGkvyZrzN2kaQV", "seq": 21189490, "pair": "64465e024b74272b0daabdb69706e251", "paid": { "currency": "XRP", "issuer": "XRPL", "value": 27.15471 }, "got": { "currency": "524C555344000000000000000000000000000000", "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1", "value": 35.6397480316857 }, "ledger": 21650784, "hash": "44DCD45E955AC0BFD9C5AC0BD5303DFB265DE94C416B4B5FA36899D76E51EFC1", "time": 1792392462000, "isAMM": false, "sourceTag": 7101, "md5s": [ "84e5efeb89c4eae8f68188982dc290d8", "ecfb8f46ab12687bf34adeda926a9adb" ], "md5": "ecfb8f46ab12687bf34adeda926a9adb", "price": 0.7619220533169305, "xrp": 27.15471 }, { "_id": "84e5efeb89c4eae8f68188982dc290d8_21650784_2_C9D854B9", "maker": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1", "taker": "rEzeooCuZkCRvGinjxj6gGHxBn84eC2wod", "seq": 21189490, "pair": "64465e024b74272b0daabdb69706e251", "paid": { "currency": "XRP", "issuer": "XRPL", "value": 64.311664 }, "got": { "currency": "524C555344000000000000000000000000000000", "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1", "value": 84.3846 }, "ledger": 21650784, "hash": "E237DC70C2D566E1EDC3C88A39F27C6A3536B77D912A109D1ABEA274C9D854B9", "time": 1792392462000, "isAMM": false, "sourceTag": 7101, "md5s": [ "84e5efeb89c4eae8f68188982dc290d8", "ecfb8f46ab12687bf34adeda926a9adb" ], "md5": "ecfb8f46ab12687bf34adeda926a9adb", "price": 0.7621256011167915, "xrp": 64.311664 }, { "_id": "ecfb8f46ab12687bf34adeda926a9adb_21650784_3_C93F09EF", "maker": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1", "taker": "rHsuA9aEpdZCt1eyDsMwsx1jZdmEPgHAwq", "seq": 21189036, "pair": "64465e024b74272b0daabdb69706e251", "paid": { "currency": "524C555344000000000000000000000000000000", "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1", "value": 92.22101846051333 }, "got": { "currency": "XRP", "issuer": "XRPL", "value": 70.189199 }, "ledger": 21650784, "hash": "FA2AB8211E65CE5FB122FEF7F451EE9E4C5BFB083D343806349BF6ACC93F09EF", "time": 1792392462000, "isAMM": false, "sourceTag": 7101, "md5s": [ "ecfb8f46ab12687bf34adeda926a9adb", "84e5efeb89c4eae8f68188982dc290d8" ], "md5": "ecfb8f46ab12687bf34adeda926a9adb", "price": 0.7610976344839784, "xrp": 70.189199 }, { "_id": "ecfb8f46ab12687bf34adeda926a9adb_21650784_4_E0E7BA49", "maker": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1", "taker": "rLeTsgPLDFKyHcBuor4UUCvK9fe1EhV8iX", "seq": 21188981, "pair": "64465e024b74272b0daabdb69706e251", "paid": { "currency": "524C555344000000000000000000000000000000", "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1", "value": 139.81880094266057 }, "got": { "currency": "XRP", "issuer": "XRPL", "value": 106.385187 }, "ledger": 21650784, "hash": "543C646CD96B55EA794EC214A4443DC1E85149BE6A7699B24B08C521E0E7BA49", "time": 1792392462000, "isAMM": false, "sourceTag": 7101, "md5s": [ "ecfb8f46ab12687bf34adeda926a9adb", "84e5efeb89c4eae8f68188982dc290d8" ], "md5": "ecfb8f46ab12687bf34adeda926a9adb", "price": 0.7608789825313147, "xrp": 106.385187 }, { "_id": "ecfb8f46ab12687bf34adeda926a9adb_21650784_5_34B7B12A", "maker": "rPZ4iweTw9ficJh4eRKFPSUPnZE7RZnykT", "taker": "rQNAhQGux6d6Xjn8cfkgHjBAtzVp4mAMLJ", "seq": null, "pair": "64465e024b74272b0daabdb69706e251", "paid": { "currency": "524C555344000000000000000000000000000000", "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1", "value": 5.27382016712 }, "got": { "currency": "XRP", "issuer": "XRPL", "value": 4.013773 }, "ledger": 21650784, "hash": "F4CE32C4B692DE29E566431EC3FF50827BCB6DC3E42E801AB9E77D8434B7B12A", "time": 1792392462000, "isAMM": true, "sourceTag": 7101, "md5s": [ "ecfb8f46ab12687bf34adeda926a9adb", "84e5efeb89c4eae8f68188982dc290d8" ], "md5": "ecfb8f46ab12687bf34adeda926a9adb", "price": 0.7610750599772339, "xrp": 4.013773 } ], "count": 50, "total": 89068, "page": 1, "limit": 50 }
Long arrays and strings are shortened in the example; Send request for the full answer.
Shapeas documented
{ trades: [ { maker, taker, paid, got, price, xrp, isAMM, hash, ledger, time } ], count, total }
What it does
Fills of a Testnet token, newest first
Start at GET /v1/testnet/fixtures: it names live accounts, a busy token, an NFT with offers and one of every ledger object that xrpl.to keeps alive on Testnet, plus a real transaction of every type. The busiest token gains holders every hour, so its GET /v1/testnet/tokens/{md5}/holders is the place to test paginating a long list. Testnet resets without warning; the data is rebuilt from the chain within minutes, and only objects touched since count. Open the Testnet sandbox →