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/2b5e3c50d0500edf86212000b9883dce/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/2b5e3c50d0500edf86212000b9883dce/trades'
Response
200Example response3 ms · just now · 4.7 KB · 155 lines
https://api.xrpl.to/v1/testnet/tokens/2b5e3c50d0500edf86212000b9883dce/trades{ "success": true, "took": 2, "trades": [ { "_id": "2b5e3c50d0500edf86212000b9883dce_21981606_4_0503863A", "maker": "r453rpyijXZ3S8qpXb1G1bRZq8TRAiFaaW", "taker": "r9MMwhq5oTS5Fi8F9cMtJKm6weVDhfZK9r", "seq": 21955470, "pair": "e72c2c7d6a5225b7c4927c717a6c8d25", "paid": { "currency": "524C555344000000000000000000000000000000", "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7", "value": 147.2451854897487 }, "got": { "currency": "XRP", "issuer": "XRPL", "value": 117.252215 }, "ledger": 21981606, "hash": "99C6C92D4CDA68F986E45AE46F92E22087C13DA1DED67C5E6EB6261C0503863A", "time": 1793516762000, "isAMM": false, "sourceTag": 7101, "md5s": [ "2b5e3c50d0500edf86212000b9883dce", "84e5efeb89c4eae8f68188982dc290d8" ], "md5": "2b5e3c50d0500edf86212000b9883dce", "price": 0.7963059342824025, "xrp": 117.252215 }, { "_id": "2b5e3c50d0500edf86212000b9883dce_21981606_8_2197497D", "maker": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7", "taker": "rFVRKYWsnrKmGc4WiGWKLF1m7iLqHL8zU", "seq": 21953890, "pair": "e72c2c7d6a5225b7c4927c717a6c8d25", "paid": { "currency": "524C555344000000000000000000000000000000", "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7", "value": 218.7343302155422 }, "got": { "currency": "XRP", "issuer": "XRPL", "value": 174.078611 }, "ledger": 21981606, "hash": "81C03F0F958B0AFC8B8CB2EC6CDEAF67FE4F8873B594276E2E9A1BC92197497D", "time": 1793516762000, "isAMM": false, "sourceTag": 7101, "md5s": [ "2b5e3c50d0500edf86212000b9883dce", "84e5efeb89c4eae8f68188982dc290d8" ], "md5": "2b5e3c50d0500edf86212000b9883dce", "price": 0.7958449449999999, "xrp": 174.078611 }, { "_id": "2b5e3c50d0500edf86212000b9883dce_21981606_9_2A15B1C0", "maker": "rHh8QTC8Jr8dEwzUWTQxdFF3ZBhKGp1gAk", "taker": "rs3MqAj6tzvz1cR4Cg3FvFw4xWxdsFXpGg", "seq": null, "pair": "e72c2c7d6a5225b7c4927c717a6c8d25", "paid": { "currency": "524C555344000000000000000000000000000000", "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7", "value": 39.2008 }, "got": { "currency": "XRP", "issuer": "XRPL", "value": 31.249641 }, "ledger": 21981606, "hash": "CEFA5F950D1D5435DC44314DFA05E3D4A721A08F44F9A205F97D5DE72A15B1C0", "time": 1793516762000, "isAMM": true, "sourceTag": 7101, "md5s": [ "2b5e3c50d0500edf86212000b9883dce", "84e5efeb89c4eae8f68188982dc290d8" ], "md5": "2b5e3c50d0500edf86212000b9883dce", "price": 0.7971684506438644, "xrp": 31.249641 }, { "_id": "84e5efeb89c4eae8f68188982dc290d8_21981606_10_ED634627", "maker": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7", "taker": "rp5xSm78RgLUnLj8NFs4jw8DtANMPC84cV", "seq": 21953889, "pair": "e72c2c7d6a5225b7c4927c717a6c8d25", "paid": { "currency": "XRP", "issuer": "XRPL", "value": 27.210746 }, "got": { "currency": "524C555344000000000000000000000000000000", "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7", "value": 34.040197719637 }, "ledger": 21981606, "hash": "61FA81BB96CF929193E2FA0B70CD075D8C2A01179461107D5A39AF6EED634627", "time": 1793516762000, "isAMM": false, "sourceTag": 7101, "md5s": [ "84e5efeb89c4eae8f68188982dc290d8", "2b5e3c50d0500edf86212000b9883dce" ], "md5": "2b5e3c50d0500edf86212000b9883dce", "price": 0.7993709738149597, "xrp": 27.210746 }, { "_id": "84e5efeb89c4eae8f68188982dc290d8_21981606_11_B37C444B", "maker": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7", "taker": "rMdUAe9qH81CPeTtcthM1SKdEogqSEMv8r", "seq": 21953889, "pair": "e72c2c7d6a5225b7c4927c717a6c8d25", "paid": { "currency": "XRP", "issuer": "XRPL", "value": 106.645246 }, "got": { "currency": "524C555344000000000000000000000000000000", "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7", "value": 133.3341999999998 }, "ledger": 21981606, "hash": "4EF2FA0F4D1B726E74E97D5EB603E86CAB39725F0DE4082AC188B9F9B37C444B", "time": 1793516762000, "isAMM": false, "sourceTag": 7101, "md5s": [ "84e5efeb89c4eae8f68188982dc290d8", "2b5e3c50d0500edf86212000b9883dce" ], "md5": "2b5e3c50d0500edf86212000b9883dce", "price": 0.7998341460780517, "xrp": 106.645246 } ], "count": 50, "total": 5393, "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 →