GET /v1/testnet/nft/history

Request

GEThttps://api.xrpl.to/v1/testnet/nft/history?nft=00080000CBCE3BC706D5D9384500837C286BE4AD8B208643052655EC01424A8E&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=00080000CBCE3BC706D5D9384500837C286BE4AD8B208643052655EC01424A8E&limit=5'

Response

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

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

{
  "success": true,
  "took": 1,
  "type": null,
  "history": [
    {
      "_id": "C5354BF9B8EAFAC9CD744A2CD4FB664FFAB69D609A321E72AB20C65911E310DB_BID_C020E9EFB608A082F5CD3E8039712D9D6DCAAC2AA479D224F5718BAC6ECA64AF",
      "type": "BID",
      "hash": "C5354BF9B8EAFAC9CD744A2CD4FB664FFAB69D609A321E72AB20C65911E310DB",
      "ledger": 21652769,
      "time": 1792398982000,
      "account": "rwMfvFj3gDnFxcKnd6GAZxcAQJ1Rd3H1cJ",
      "NFTokenID": "00080000CBCE3BC706D5D9384500837C286BE4AD8B208643052655EC01424A8E",
      "cid": "rK2dNJDJBGPvshUSNe2gjeg6rDGcPCkGgD_6085",
      "offer": "C020E9EFB608A082F5CD3E8039712D9D6DCAAC2AA479D224F5718BAC6ECA64AF",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 5.450507
      },
      "owner": "rwMfvFj3gDnFxcKnd6GAZxcAQJ1Rd3H1cJ"
    },
    {
      "_id": "D8A53225C77950A32873781D61D3992628295CC8C689B1C9E9B3590BD4281164_BID_0C71DDDCAC2D3814D203D1DB01CBD17EEDE49DF0B9F4FF0997E6142ACEB619F2",
      "type": "BID",
      "hash": "D8A53225C77950A32873781D61D3992628295CC8C689B1C9E9B3590BD4281164",
      "ledger": 21652761,
      "time": 1792398960000,
      "account": "rNSFYXg4rNgnAPBs3AKnBSKcVa3S8cxBfs",
      "NFTokenID": "00080000CBCE3BC706D5D9384500837C286BE4AD8B208643052655EC01424A8E",
      "cid": "rK2dNJDJBGPvshUSNe2gjeg6rDGcPCkGgD_6085",
      "offer": "0C71DDDCAC2D3814D203D1DB01CBD17EEDE49DF0B9F4FF0997E6142ACEB619F2",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 1.434383
      },
      "owner": "rNSFYXg4rNgnAPBs3AKnBSKcVa3S8cxBfs"
    },
    {
      "_id": "FB603E9A9843305F938EFF85D17555B42E8264E78F05FD55B5D3DE4A7D1F45BD_BID_91AD8C4C8332B4CA5949747731B161DB115CCB4EEB380C895CC261822AC952F0",
      "type": "BID",
      "hash": "FB603E9A9843305F938EFF85D17555B42E8264E78F05FD55B5D3DE4A7D1F45BD",
      "ledger": 21651521,
      "time": 1792394890000,
      "account": "rEMaeZR5KmTetvw7SSDBsV3Yo41KQdCX9K",
      "NFTokenID": "00080000CBCE3BC706D5D9384500837C286BE4AD8B208643052655EC01424A8E",
      "cid": "rK2dNJDJBGPvshUSNe2gjeg6rDGcPCkGgD_6085",
      "offer": "91AD8C4C8332B4CA5949747731B161DB115CCB4EEB380C895CC261822AC952F0",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 5.178335
      },
      "owner": "rEMaeZR5KmTetvw7SSDBsV3Yo41KQdCX9K"
    },
    {
      "_id": "34633C470E8A082C5B164E989CE8E0C013B6828ACA6B7938F9EB6A3C42CE78DF_BID_A21731D36855D59F851F9430F27D965462F52728FF578235C5C7C5B8258E4E49",
      "type": "BID",
      "hash": "34633C470E8A082C5B164E989CE8E0C013B6828ACA6B7938F9EB6A3C42CE78DF",
      "ledger": 21648465,
      "time": 1792384792000,
      "account": "rfnxjxn174miNCuwbrkmLa1h8ATFvxfCb2",
      "NFTokenID": "00080000CBCE3BC706D5D9384500837C286BE4AD8B208643052655EC01424A8E",
      "cid": "rK2dNJDJBGPvshUSNe2gjeg6rDGcPCkGgD_6085",
      "offer": "A21731D36855D59F851F9430F27D965462F52728FF578235C5C7C5B8258E4E49",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 2.58704
      },
      "owner": "rfnxjxn174miNCuwbrkmLa1h8ATFvxfCb2"
    },
    {
      "_id": "5417197ABC35B23AF9896E8209C9A4929DA3B3DBFE62B09E58D9B7C5BA5242CF_BID_294D9F4B15FB0B0B0FEFC2EFD1B5401D10BA10DB774A65AB505205A8082E0AFE",
      "type": "BID",
      "hash": "5417197ABC35B23AF9896E8209C9A4929DA3B3DBFE62B09E58D9B7C5BA5242CF",
      "ledger": 21646512,
      "time": 1792378320000,
      "account": "rwWL3dn9uozLqNpEbhA4K76H6PMwpcYBe3",
      "NFTokenID": "00080000CBCE3BC706D5D9384500837C286BE4AD8B208643052655EC01424A8E",
      "cid": "rK2dNJDJBGPvshUSNe2gjeg6rDGcPCkGgD_6085",
      "offer": "294D9F4B15FB0B0B0FEFC2EFD1B5401D10BA10DB774A65AB505205A8082E0AFE",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 1.805488
      },
      "owner": "rwWL3dn9uozLqNpEbhA4K76H6PMwpcYBe3"
    }
  ],
  "count": 5,
  "total": 422,
  "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