Domain-Historie
Liefert das Protokoll der Operationen (etwa Registrierung und Änderungen), die an einem bestimmten PIVX-Namen vorgenommen wurden.
Endpunkt
POST https://indexer.pivx.name/v1.0/history/richard.pivx
Pfadparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
domain_name | string | Ja | Die PIVX-Domain, deren Historie abgefragt wird (z. B. richard.pivx). |
Anfragekörper
Der Anfragekörper muss ein JSON-Objekt mit folgenden Parametern sein:
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
count | integer | 100 | Die höchste Zahl zurückgegebener Einträge, bis 500: eine größere Zahl wird auf 500 gekürzt. |
from_block_id | integer | Keiner | Nur Einträge nach diesem Block zurückgeben: aus späteren Blöcken bei asc, aus früheren bei desc; der Block selbst ist ausgenommen. Ohne ihn beginnt die Liste beim ältesten Eintrag (asc) oder beim neuesten (desc). |
from_nonce | integer | Keiner | Nur zusammen mit from_block_id: die nonce des letzten Eintrags, den Sie haben. Die Liste setzt dann direkt nach diesem Eintrag fort statt nach seinem ganzen Block; siehe Seitenweises Lesen. |
order | string | desc | Die Sortierreihenfolge: asc oder desc. Die Einträge sind nach Block und dann nach nonce sortiert. |
Codebeispiele
- cURL
- JavaScript
- Python
- PHP
curl -X POST https://indexer.pivx.name/v1.0/history/richard.pivx \
-H "Content-Type: application/json" \
-d '{
"count": 10,
"from_block_id": 5537000,
"order": "asc"
}'
const url = 'https://indexer.pivx.name/v1.0/history/richard.pivx';
const data = {
count: 10,
from_block_id: 5537000,
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));
import requests
url = "https://indexer.pivx.name/v1.0/history/richard.pivx"
payload = {
"count": 10,
"from_block_id": 5537000,
"order": "asc"
}
headers = {
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
<?php
$url = 'https://indexer.pivx.name/v1.0/history/richard.pivx';
$data = [
'count' => 10,
'from_block_id' => 5537000,
'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);
Beispielantwort
{
"response": [
{
"domain_block_id": 5537326,
"domain_ts": 1784808285,
"target_address": "ps1f84lvgj0awz2yf2zha5d5gddhd4j88g0kzj5cwp776vhxp5fdjqe7e95cdx2qs5e7fcvg3ds3yq",
"owner_pubkey": "3757ee1a8b3f10353ca6edd47b66920392b02e323dca3f3edddb5de142079a53",
"domain_tx": "388241ffc5bf8ba3d7633d132298d157e26d6ac127ff8d162f26e7203084df08",
"op": "REG",
"nonce": 1784808228,
"price": 0
},
{
"domain_block_id": 5537369,
"domain_ts": 1784812590,
"target_address": "ps1f84lvgj0awz2yf2zha5d5gddhd4j88g0kzj5cwp776vhxp5fdjqe7e95cdx2qs5e7fcvg3ds3yq",
"owner_pubkey": "3757ee1a8b3f10353ca6edd47b66920392b02e323dca3f3edddb5de142079a53",
"domain_tx": "4d5419af400966616ba9325f78bb3cac2ff1229fd4d39ed022a9fc113ee4b67e",
"op": "LST",
"nonce": 1784812534,
"price": 200000
},
{
"domain_block_id": 5537421,
"domain_ts": 1784815647,
"target_address": "ps1yq6m9k7hn4wzp3gv5xun8kf0eq2dm3ay5r7vc6t9jl0sxh2pw8dz4knmg7uve3cqr6t5hxj9fda",
"owner_pubkey": "66a998241f62b4c8e4340f6e840b4570ac1d2d9840e2e42f62e713a34244f098",
"domain_tx": "3834eb36ca816f1bd9074c546ec64b3a361aca67e88c35b1586fe4ec1ae60095",
"op": "BUY",
"nonce": 1784815586,
"price": 0
},
{
"domain_block_id": 5538248,
"domain_ts": 1784878331,
"target_address": "ps1yq6m9k7hn4wzp3gv5xun8kf0eq2dm3ay5r7vc6t9jl0sxh2pw8dz4knmg7uve3cqr6t5hxj9fda",
"owner_pubkey": "66a998241f62b4c8e4340f6e840b4570ac1d2d9840e2e42f62e713a34244f098",
"domain_tx": "3c08640ed394b1a270abddcc3ca873c13793629c6a148ad0b5585003ca9e632a",
"op": "LST",
"nonce": 1784878114,
"price": 10012345678
},
{
"domain_block_id": 5538248,
"domain_ts": 1784878331,
"target_address": "ps1yq6m9k7hn4wzp3gv5xun8kf0eq2dm3ay5r7vc6t9jl0sxh2pw8dz4knmg7uve3cqr6t5hxj9fda",
"owner_pubkey": "66a998241f62b4c8e4340f6e840b4570ac1d2d9840e2e42f62e713a34244f098",
"domain_tx": "9ad75f893c002f21e9bbc3c6cdf4e151477293d64a013aa773db26598c1d5d11",
"op": "ULT",
"nonce": 1784878293,
"price": 0
}
]
}
| Feld | Typ | Beschreibung |
|---|---|---|
domain_block_id | int | Der PIVX-Block, der die Operation enthält |
domain_ts | int | Die Zeit dieses Blocks, in Unix-Sekunden |
target_address | string | Die Adresse, auf die der Name nach der Operation aufgelöst wird |
op | string | Die Operation: REG, UPD, CHG, LST, ULT oder BUY |
owner_pubkey | string | Der öffentliche Schlüssel des Namensinhabers nach der Operation |
domain_tx | string | Der Hash der PIVX-Transaktion, die die Operation trug |
nonce | int | Die Nonce der Operation: ein Zeitstempel, der mit jeder Operation am Namen wächst |
price | int | Der Verkaufspreis nach der Operation, in Satoshi: der Angebotspreis bei LST, sonst 0. Ein BUY-Eintrag zeigt 0, da der Name nicht mehr zum Verkauf steht; gezahlt wurde der Preis des letzten LST davor |
Seitenweises Lesen
Um eine lange Historie seitenweise zu lesen, senden Sie den letzten Eintrag jeder Seite als Cursor zurück: seine domain_block_id als from_block_id und seine nonce als from_nonce. Senden Sie beide: Ein Block kann mehrere Operationen am selben Namen enthalten (im Beispiel oben das LST und das ULT in Block 5538248), und eine Seite kann zwischen ihnen enden. Mit from_block_id allein würde die nächste Seite beim nächsten Block beginnen und den Rest dieses Blocks überspringen. Eine Seite mit weniger Einträgen als angefragt (oder als 500, wenn Sie mehr angefragt haben) ist die letzte.
Eine from_nonce ohne from_block_id oder eine, die keine nichtnegative ganze Zahl ist, wird mit dem Fehler One or several params provided have wrong value beantwortet, ebenso ein negativer oder nicht ganzzahliger count.