Domain History

Retrieves the historical log of operations (such as registration and updates) performed on a specific PIVX name.

Endpoint

POST https://indexer.pivx.name/v1.0/history/richard.pivx

Path Parameters

Parameter	Type	Required	Description
domain_name	string	Yes	The PIVX domain to query history for (e.g., richard.pivx).

Request Body

The request body must be a JSON object containing the following parameters:

Parameter	Type	Default	Description
count	integer	None	Limit the maximum number of items returned in a single response.
from_block_id	integer	None	Request the history logs starting from this specific block height.
order	string	desc	The sorting order of the history log. Accepted values: asc or desc.

---

Code Examples

cURL

curl -X POST https://indexer.pivx.name/v1.0/history/richard.pivx \
  -H "Content-Type: application/json" \
  -d '{
    "count": 10,
    "from_block_id": 5332579,
    "order": "asc"
  }'

JavaScript

const url = 'https://indexer.pivx.name/v1.0/history/richard.pivx';
const data = {
  count: 10,
  from_block_id: 5332579,
  order: 'asc'
};

fetch(url, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error('Error:', error));

Python

import requests

url = "https://indexer.pivx.name/v1.0/history/richard.pivx"
payload = {
    "count": 10,
    "from_block_id": 5332579,
    "order": "asc"
}
headers = {
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

PHP

<?php

$url = 'https://indexer.pivx.name/v1.0/history/richard.pivx';
$data = [
    'count' => 10,
    'from_block_id' => 5332579,
    'order' => 'asc'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

Response Example

{
  "response": [
    {
      "domain_block_id": 5432577,
      "target_address": "ps12qtzaw6x3dh35xuukrqgk06e9ffx8szg2n2huqncwjsnj3ajczmklqgcx97kn63vwlge6gj2cmn",
      "owner_pubkey": "3757ee1a8b3f10353ca6edd47b66920392b02e323dca3f3edddb5de142079a53",
      "domain_tx": "5c16fa577b95d76fd54b11d4076a0509f45bc468c6a69f9e8f524b4f98d76635",
      "op": "REG",
      "nonce": 1780049890835,
      "price": 0
    },
    {
      "domain_block_id": 5432579,
      "target_address": "ps1a5dvcrw8k49tcmmsmfh2d5cthhamfrxue4h3ervww2z625qwyarcflpznaxlalwk7trkyxas4ln",
      "owner_pubkey": "3757ee1a8b3f10353ca6edd47b66920392b02e323dca3f3edddb5de142079a53",
      "domain_tx": "d39bb4aeb116449cfcd9a40ff5a437b5b6957a62531e3dcf170bccf62816edf7",
      "op": "UPD",
      "nonce": 1780050207591,
      "price": 0
    },
    {
      "domain_block_id": 5434368,
      "target_address": "ps1a5dvcrw8k49tcmmsmfh2d5cthhamfrxue4h3ervww2z625qwyarcflpznaxlalwk7trkyxas4ln",
      "owner_pubkey": "3aa7910fa98101312acadc381af1fa72157a9d8dcce6c62655c7b4e9a69e2b32",
      "domain_tx": "15395cac30c9a5f82374b26f4c9214669c7f828abe54a35ded530609057fd662",
      "op": "CHG",
      "nonce": 1780160609750,
      "price": 0
    }
  ]
}

Field	Type	Description
domain_block_id	int	The PIVX block_id of the operation
target_address	string	Resolving Shielded addres
op	string	Operation perfomed on the name
owner_pubkey	string	Public key of the name owner
domain_tx	string	The PIVX tx_id of the name registration
nonce	int	Increasing timestamp of the operation
price	int	Selling price of the domain (for LST or BUY), otherwise 0