GET /testnet/nft/history
GET

/v1/testnet/nft/history

Testnet NFT events, newest first

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/testnet/nft/history?nft=00080000C2D5AE3A2E7AF5072D1FB422228915A85CBDAF85043D7341014EF9C7&limit=5
Query parameterValueDescription
collectionissuer:taxon
nftNFTokenID
accountthe sending account (one of the three is required)
typeMINT | BURN | LIST | BID | CANCEL | SALE | TRANSFER | MODIFY
limit1-200
pagefrom 1
curl 'https://api.xrpl.to/v1/testnet/nft/history?nft=00080000C2D5AE3A2E7AF5072D1FB422228915A85CBDAF85043D7341014EF9C7&limit=5'

Response

200Example response6 ms · just now · 3.8 KB · 97 lines
https://api.xrpl.to/v1/testnet/nft/history?nft=00080000C2D5AE3A2E7AF5072D1FB422228915A85CBDAF85043D7341014EF9C7&limit=5
{
  "success": true,
  "took": 1,
  "type": null,
  "history": [
    {
      "_id": "479105873ABC260737C0325005D0D6A27BE6AD364F7511EB50219C3DD7708DD1_SALE",
      "type": "SALE",
      "hash": "479105873ABC260737C0325005D0D6A27BE6AD364F7511EB50219C3DD7708DD1",
      "ledger": 22503455,
      "time": 1795281181000,
      "account": "rsmsd5CCDiUP1VUB95VXyGRRzWbjhNYc4i",
      "NFTokenID": "00080000C2D5AE3A2E7AF5072D1FB422228915A85CBDAF85043D7341014EF9C7",
      "cid": "rJmUnrau3q8a6BUMvLwprgNRoRv6a1Ch7y_2339",
      "seller": "rU3KNagYRmKXMrcPXrV6eWR4WKRPKcN6QX",
      "buyer": "rsmsd5CCDiUP1VUB95VXyGRRzWbjhNYc4i",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 8.124405
      },
      "sellOffer": "2F83F2FD4D0CC0743F5A3229F256CDAFBD1488F08F62A480631AAB52295D61BA"
    },
    {
      "_id": "E438A0EA171B2763040C60B7B04543BD5E295CDF78B5B63AEC32BC37F559AC78_BID_D66C03F1442F0268C898EFAC0352CE78B089953244289E8071F56B54BFCFC090",
      "type": "BID",
      "hash": "E438A0EA171B2763040C60B7B04543BD5E295CDF78B5B63AEC32BC37F559AC78",
      "ledger": 22503093,
      "time": 1795279971000,
      "account": "rHAg7wMpyd8N5qx9DC8mDgMcVeB1xGs473",
      "NFTokenID": "00080000C2D5AE3A2E7AF5072D1FB422228915A85CBDAF85043D7341014EF9C7",
      "cid": "rJmUnrau3q8a6BUMvLwprgNRoRv6a1Ch7y_2339",
      "offer": "D66C03F1442F0268C898EFAC0352CE78B089953244289E8071F56B54BFCFC090",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 1.744609
      },
      "owner": "rHAg7wMpyd8N5qx9DC8mDgMcVeB1xGs473"
    },
    {
      "_id": "BC34369BE1D5355FEDB8D29FE5183CD38BDCDFBA372D19424C305F007F62A855_BID_DE5D8D4B3FF710967DD506B0D5A94C7CEB23833E15E903C391F13D29D28BAE5C",
      "type": "BID",
      "hash": "BC34369BE1D5355FEDB8D29FE5183CD38BDCDFBA372D19424C305F007F62A855",
      "ledger": 22502093,
      "time": 1795276600000,
      "account": "r4Lxcrnwc3QUy6yj255W8f6q1pyZpVSZVB",
      "NFTokenID": "00080000C2D5AE3A2E7AF5072D1FB422228915A85CBDAF85043D7341014EF9C7",
      "cid": "rJmUnrau3q8a6BUMvLwprgNRoRv6a1Ch7y_2339",
      "offer": "DE5D8D4B3FF710967DD506B0D5A94C7CEB23833E15E903C391F13D29D28BAE5C",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 4.758631
      },
      "owner": "r4Lxcrnwc3QUy6yj255W8f6q1pyZpVSZVB"
    },
    {
      "_id": "6F5EB475FE5E580846FCA50AA80B1201FA55F3F23CFA05223897CA3DC3F1BB3C_BID_86ACB808132D7F6C139FDFAAB8DB2D55DEFBD302906AE51946AD0845DE45C1B2",
      "type": "BID",
      "hash": "6F5EB475FE5E580846FCA50AA80B1201FA55F3F23CFA05223897CA3DC3F1BB3C",
      "ledger": 22501863,
      "time": 1795275821000,
      "account": "rEJJHbJ8ex6iGN9LoQwJhsGbyWP65RQ3Nj",
      "NFTokenID": "00080000C2D5AE3A2E7AF5072D1FB422228915A85CBDAF85043D7341014EF9C7",
      "cid": "rJmUnrau3q8a6BUMvLwprgNRoRv6a1Ch7y_2339",
      "offer": "86ACB808132D7F6C139FDFAAB8DB2D55DEFBD302906AE51946AD0845DE45C1B2",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 4.668379
      },
      "owner": "rEJJHbJ8ex6iGN9LoQwJhsGbyWP65RQ3Nj"
    },
    {
      "_id": "4CF4CA37B239BFEA85F2F17BA0EF2EAA9C7FFEA872B4D701E24697206AE9B2DB_BID_11E4D5EA161A3B412157BEEF3D404C7EF140E1CC40EDDC3A57DA0471F835C9F3",
      "type": "BID",
      "hash": "4CF4CA37B239BFEA85F2F17BA0EF2EAA9C7FFEA872B4D701E24697206AE9B2DB",
      "ledger": 22499543,
      "time": 1795268030000,
      "account": "rFVRKYWsnrKmGc4WiGWKLF1m7iLqHL8zU",
      "NFTokenID": "00080000C2D5AE3A2E7AF5072D1FB422228915A85CBDAF85043D7341014EF9C7",
      "cid": "rJmUnrau3q8a6BUMvLwprgNRoRv6a1Ch7y_2339",
      "offer": "11E4D5EA161A3B412157BEEF3D404C7EF140E1CC40EDDC3A57DA0471F835C9F3",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 3.93046
      },
      "owner": "rFVRKYWsnrKmGc4WiGWKLF1m7iLqHL8zU"
    }
  ],
  "count": 5,
  "total": 323,
  "page": 1,
  "limit": 5
}
Shapeas documented
{
  history: [
    {
      type,
      NFTokenID,
      cid,
      account,
      buyer,
      seller,
      amount,
      broker,
      hash,
      ledger,
      time
    }
  ],
  count,
  total
}

What it does

Testnet NFT events, 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 →
OpenAPI