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 response13 ms · just now · 3.8 KB · 96 lines

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

{
  "success": true,
  "took": 11,
  "type": null,
  "history": [
    {
      "_id": "D7E47CCB028E72C1A6B60E35C2C60DC63A3D88A8E73D4ABFA6E8DF06D0776E4F_BID_0591E1B32D58C52EDCC0E32F5CF5F6A768E90B1646026086777E2D7C9CD0188A",
      "type": "BID",
      "hash": "D7E47CCB028E72C1A6B60E35C2C60DC63A3D88A8E73D4ABFA6E8DF06D0776E4F",
      "ledger": 21467252,
      "time": 1791766733000,
      "account": "rNBDE2TjhctT1uYwQhxwvMyxWXvAnim1sR",
      "NFTokenID": "00080000CBCE3BC706D5D9384500837C286BE4AD8B208643052655EC01424A8E",
      "cid": "rK2dNJDJBGPvshUSNe2gjeg6rDGcPCkGgD_6085",
      "offer": "0591E1B32D58C52EDCC0E32F5CF5F6A768E90B1646026086777E2D7C9CD0188A",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 4.269402
      },
      "owner": "rNBDE2TjhctT1uYwQhxwvMyxWXvAnim1sR"
    },
    {
      "_id": "586AFC45D59EAEB6097FCAD23D5538734075A5E97BADA70CF638C56237B8CCE6_BID_49BB3633C7DCBE2B4F6A5DC71F7FDAA24E2ED83B06DE30974328489B90EE5157",
      "type": "BID",
      "hash": "586AFC45D59EAEB6097FCAD23D5538734075A5E97BADA70CF638C56237B8CCE6",
      "ledger": 21465553,
      "time": 1791761022000,
      "account": "rBpDB61TmZjhmo4jeu2Dv67toqPjEnLgTC",
      "NFTokenID": "00080000CBCE3BC706D5D9384500837C286BE4AD8B208643052655EC01424A8E",
      "cid": "rK2dNJDJBGPvshUSNe2gjeg6rDGcPCkGgD_6085",
      "offer": "49BB3633C7DCBE2B4F6A5DC71F7FDAA24E2ED83B06DE30974328489B90EE5157",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 1.725468
      },
      "owner": "rBpDB61TmZjhmo4jeu2Dv67toqPjEnLgTC"
    },
    {
      "_id": "910DE0F1B1CAA9269E43573ACF26F9D9E3D62A86BEDC150046A5423369F20A59_BID_87E9A8FB85BA1A1DD14DF396016A06CFCB363992B236C43B398D1B1B548A02F0",
      "type": "BID",
      "hash": "910DE0F1B1CAA9269E43573ACF26F9D9E3D62A86BEDC150046A5423369F20A59",
      "ledger": 21465288,
      "time": 1791760130000,
      "account": "rP2z5c7o5yz9VhjWki1HEvsL1DHaT2cLnk",
      "NFTokenID": "00080000CBCE3BC706D5D9384500837C286BE4AD8B208643052655EC01424A8E",
      "cid": "rK2dNJDJBGPvshUSNe2gjeg6rDGcPCkGgD_6085",
      "offer": "87E9A8FB85BA1A1DD14DF396016A06CFCB363992B236C43B398D1B1B548A02F0",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 2.24804
      },
      "owner": "rP2z5c7o5yz9VhjWki1HEvsL1DHaT2cLnk"
    },
    {
      "_id": "CCA5C3C031511242CEB1E3E8EE498CD683107B865EA975B7CF0709D35808652D_BID_59354AEAF292A85A4DB801A12E439BF91E39A754BA3374E7AF7D16CC19E8D4D1",
      "type": "BID",
      "hash": "CCA5C3C031511242CEB1E3E8EE498CD683107B865EA975B7CF0709D35808652D",
      "ledger": 21463376,
      "time": 1791753680000,
      "account": "r4eSzJRYnTPHzn9mD14ERq3vGEkbmHTNAE",
      "NFTokenID": "00080000CBCE3BC706D5D9384500837C286BE4AD8B208643052655EC01424A8E",
      "cid": "rK2dNJDJBGPvshUSNe2gjeg6rDGcPCkGgD_6085",
      "offer": "59354AEAF292A85A4DB801A12E439BF91E39A754BA3374E7AF7D16CC19E8D4D1",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 2.367024
      },
      "owner": "r4eSzJRYnTPHzn9mD14ERq3vGEkbmHTNAE"
    },
    {
      "_id": "3B9241B176C8847D640C7CE2D639EC6E1BAB33ADCCED98EFDB67B3A66D1ECF9C_BID_2407810242E0CC706A948F56576BBA988AD78B03CC27ACC6B586BAB10C1992F5",
      "type": "BID",
      "hash": "3B9241B176C8847D640C7CE2D639EC6E1BAB33ADCCED98EFDB67B3A66D1ECF9C",
      "ledger": 21462609,
      "time": 1791750972000,
      "account": "rMsUFwpTUaSQwqUNy9yoULbNFBMbXuxp7N",
      "NFTokenID": "00080000CBCE3BC706D5D9384500837C286BE4AD8B208643052655EC01424A8E",
      "cid": "rK2dNJDJBGPvshUSNe2gjeg6rDGcPCkGgD_6085",
      "offer": "2407810242E0CC706A948F56576BBA988AD78B03CC27ACC6B586BAB10C1992F5",
      "amount": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": 5.711737
      },
      "owner": "rMsUFwpTUaSQwqUNy9yoULbNFBMbXuxp7N"
    }
  ],
  "count": 5,
  "total": 278,
  "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