GET /v1/testnet/nft/history

Request

GEThttps://api.xrpl.to/v1/testnet/nft/history?nft=00080000C2D5AE3A2E7AF5072D1FB422228915A85CBDAF85043D7341014EF9C7&limit=5

Query parameter	Value	Description
collection		issuer:taxon
nft		NFTokenID
account		the sending account (one of the three is required)
type		MINT \| BURN \| LIST \| BID \| CANCEL \| SALE \| TRANSFER \| MODIFY
limit		1-200
page		from 1

curl 'https://api.xrpl.to/v1/testnet/nft/history?nft=00080000C2D5AE3A2E7AF5072D1FB422228915A85CBDAF85043D7341014EF9C7&limit=5'

Response

200Example response2 ms · just now · 3.8 KB · 98 lines

https://api.xrpl.to/v1/testnet/nft/history?nft=00080000C2D5AE3A2E7AF5072D1FB422228915A85CBDAF85043D7341014EF9C7&limit=5

{
  "success": true,
  "took": 1,
  "type": null,
  "history": [
    {
      "_id": "50CF4F4FC439F24B17309259DAE2AB762DE712F8E0E81B1D6482B438F0CE0CB5_LIST_C5E22AB1679A610D90CD98ACC7E8F47572A147AB5FBF836946AFFC52E3645A80",
      "type": "LIST",
      "hash": "50CF4F4FC439F24B17309259DAE2AB762DE712F8E0E81B1D6482B438F0CE0CB5",
      "ledger": 21981173,
      "time": 1793515260000,
      "account": "r4LXJ9LYbY3xHquERhbHDPN87Z3E4dU2e2",
      "NFTokenID": "00080000C2D5AE3A2E7AF5072D1FB422228915A85CBDAF85043D7341014EF9C7",
      "cid": "rJmUnrau3q8a6BUMvLwprgNRoRv6a1Ch7y_2339",
      "offer": "C5E22AB1679A610D90CD98ACC7E8F47572A147AB5FBF836946AFFC52E3645A80",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 7.379452
      },
      "owner": "r4LXJ9LYbY3xHquERhbHDPN87Z3E4dU2e2"
    },
    {
      "_id": "920DEC283EEAD67BE9EF01F54D131C924461AF26986DBE24B535E9C28E993B13_SALE",
      "type": "SALE",
      "hash": "920DEC283EEAD67BE9EF01F54D131C924461AF26986DBE24B535E9C28E993B13",
      "ledger": 21980896,
      "time": 1793514280000,
      "account": "r4LXJ9LYbY3xHquERhbHDPN87Z3E4dU2e2",
      "NFTokenID": "00080000C2D5AE3A2E7AF5072D1FB422228915A85CBDAF85043D7341014EF9C7",
      "cid": "rJmUnrau3q8a6BUMvLwprgNRoRv6a1Ch7y_2339",
      "seller": "rs3MqAj6tzvz1cR4Cg3FvFw4xWxdsFXpGg",
      "buyer": "r4LXJ9LYbY3xHquERhbHDPN87Z3E4dU2e2",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 8.456988
      },
      "sellOffer": "13BBD76FB3997F42E8294EA49E6B7B45B27559E0F0F686FA1BAB7C958ECA14F8"
    },
    {
      "_id": "5DA96C88940235F621846F62A30B34D50294F0F0B7BE9F2082A2938CD157C1F3_BID_8FAEB14F340E5BA67A3E1F0635EE5C23B9EEA951AA0376D116EBBCE18C2B0757",
      "type": "BID",
      "hash": "5DA96C88940235F621846F62A30B34D50294F0F0B7BE9F2082A2938CD157C1F3",
      "ledger": 21980315,
      "time": 1793512251000,
      "account": "r9MMwhq5oTS5Fi8F9cMtJKm6weVDhfZK9r",
      "NFTokenID": "00080000C2D5AE3A2E7AF5072D1FB422228915A85CBDAF85043D7341014EF9C7",
      "cid": "rJmUnrau3q8a6BUMvLwprgNRoRv6a1Ch7y_2339",
      "offer": "8FAEB14F340E5BA67A3E1F0635EE5C23B9EEA951AA0376D116EBBCE18C2B0757",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 1.450291
      },
      "owner": "r9MMwhq5oTS5Fi8F9cMtJKm6weVDhfZK9r"
    },
    {
      "_id": "0E92E5D338287494283A8BA5C854E7D6C3C9D829D6A48520AC1593708B986AA0_LIST_13BBD76FB3997F42E8294EA49E6B7B45B27559E0F0F686FA1BAB7C958ECA14F8",
      "type": "LIST",
      "hash": "0E92E5D338287494283A8BA5C854E7D6C3C9D829D6A48520AC1593708B986AA0",
      "ledger": 21979871,
      "time": 1793510692000,
      "account": "rs3MqAj6tzvz1cR4Cg3FvFw4xWxdsFXpGg",
      "NFTokenID": "00080000C2D5AE3A2E7AF5072D1FB422228915A85CBDAF85043D7341014EF9C7",
      "cid": "rJmUnrau3q8a6BUMvLwprgNRoRv6a1Ch7y_2339",
      "offer": "13BBD76FB3997F42E8294EA49E6B7B45B27559E0F0F686FA1BAB7C958ECA14F8",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 8.456988
      },
      "owner": "rs3MqAj6tzvz1cR4Cg3FvFw4xWxdsFXpGg"
    },
    {
      "_id": "E5AB22945685BE587CCCDE652AF629CA4017903D15574F983A92354377935FAC_SALE",
      "type": "SALE",
      "hash": "E5AB22945685BE587CCCDE652AF629CA4017903D15574F983A92354377935FAC",
      "ledger": 21978703,
      "time": 1793506602000,
      "account": "rs3MqAj6tzvz1cR4Cg3FvFw4xWxdsFXpGg",
      "NFTokenID": "00080000C2D5AE3A2E7AF5072D1FB422228915A85CBDAF85043D7341014EF9C7",
      "cid": "rJmUnrau3q8a6BUMvLwprgNRoRv6a1Ch7y_2339",
      "seller": "rft4AqYzkSoqkc2sBAQ6EwsKKv4HeLpUXK",
      "buyer": "rs3MqAj6tzvz1cR4Cg3FvFw4xWxdsFXpGg",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 4.87102
      },
      "sellOffer": "B4C22F9D794AA5CDFB12BFC31F5290DB49E6F17433D14AC716665FC2D79B35F0"
    }
  ],
  "count": 5,
  "total": 25,
  "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

/v1/testnet/nft/history

Request

Response

What it does

Also in Testnet