Saltar al contenido principal

Historial del dominio

Devuelve el registro histórico de operaciones (como el registro y las modificaciones) realizadas sobre un nombre de PIVX concreto.

Punto de acceso​

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

Parámetros de ruta​

ParámetroTipoObligatorioDescripción
domain_namestringSíEl dominio de PIVX cuyo historial se consulta (por ejemplo, richard.pivx).

Cuerpo de la petición​

El cuerpo de la petición debe ser un objeto JSON con los siguientes parámetros:

ParámetroTipoPor defectoDescripción
countinteger100El máximo de filas que se devuelven, hasta 500: un número mayor se reduce a 500.
from_block_idintegerNingunoDevuelve solo las filas posteriores a este bloque: de bloques más recientes con asc, de bloques anteriores con desc; el bloque en sí queda fuera. Sin él, la lista empieza por la fila más antigua (asc) o por la más reciente (desc).
from_nonceintegerNingunoSolo junto con from_block_id: el nonce de la última fila que tiene. La lista continúa entonces justo después de esa fila, no después de todo su bloque; consulte Paginación.
orderstringdescEl orden: asc o desc. Las filas se ordenan por bloque y luego por nonce.

Ejemplos de código​

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"
}'

Ejemplo de respuesta

{
"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
}
]
}
CampoTipoDescripción
domain_block_idintEl bloque de PIVX que contiene la operación
domain_tsintLa hora de ese bloque, en segundos Unix
target_addressstringLa dirección a la que resuelve el nombre tras la operación
opstringLa operación: REG, UPD, CHG, LST, ULT o BUY
owner_pubkeystringLa clave pública del titular del nombre tras la operación
domain_txstringEl hash de la transacción de PIVX que llevó la operación
nonceintEl nonce de la operación: una marca de tiempo que crece con cada operación sobre el nombre
priceintEl precio de venta tras la operación, en satoshi: el precio de oferta para LST, en otro caso 0. Una fila BUY muestra 0, porque el nombre ya no está a la venta; el precio pagado es el del último LST anterior

Paginación​

Para leer un historial largo página a página, devuelva la última fila de cada página como cursor: su domain_block_id como from_block_id y su nonce como from_nonce. Envíe ambos: un bloque puede contener varias operaciones sobre el mismo nombre (en el ejemplo de arriba, el LST y el ULT del bloque 5538248) y una página puede terminar entre ellas. Solo con from_block_id, la página siguiente empezaría en el bloque siguiente y se saltaría el resto de ese. Una página con menos filas de las que pidió (o de 500, si pidió más) es la última.

Un from_nonce sin from_block_id, o que no sea un entero no negativo, se responde con el error One or several params provided have wrong value, igual que un count negativo o no entero.