BETA PÚBLICA · v1

PyBLØCK Market API

Construí sobre el PyBLØCK Market: listá y alquilá rigs BLAKE2b, seguí órdenes y configurá el cobro de los mineros desde tu propia app, bot o sitio. JSON por HTTPS, sin cuentas, sin claves, CORS abierto.

URL base: https://b.pyblock.xyz:8443/api/market/v1.php · OpenAPI 3 (JSON) · Market →

Principios

Sin cuentas: una orden se identifica por su secreto (32 hex). Quien tiene el secreto tiene la orden: estado y devoluciones. Guardalo en privado.
A los mineros se los identifica por un id público mid (16 hex), nunca por su dirección de minería.
La entrega la mide PyBLØCK validando cada share (prueba de trabajo), no lo que diga el pool de destino. Lo que tu pool no recibe se devuelve.
Pagos en XBT por Lightning (facturas BOLT11 de Laguz). Cobros de mineros y devoluciones: dirección Lightning de XBT u oferta BOLT12.
Toda respuesta trae ok; los errores llegan como {"ok":false,"error":"…"} con el código HTTP. Hay límites por IP; 429 = esperá un minuto.

Endpoints

GET/statsResumen del mercado: rigs, disponibles, TH/s, precio mediano.

GET/rigsRigs publicados: TH/s verificado, precio (sats XBT/TH/día), disponibilidad, estado.

GET/rigs/{mid}/{rig}Un rig.

GET/miners/{mid}Panel público de un minero (sin montos).

GET/miners/{mid}/series?range=6|12|168|720|allHistorial de hashrate.

GET/quote?rigs=mid:rig,…&hours=HCotizar un alquiler (mínimo 3 h).

POST/ordersCrear una orden → factura Lightning (15 min) + secreto.

GET/orders/{secret}Estado de la orden, entrega por rig, devolución / cupón.

GET/payout/challenge?address=&payout=&price=Minero: mensaje a firmar (1 h).

POST/payoutMinero: guardar el cobro firmado.

Alquilar hashrate en 4 llamadas

# 1) rigs disponibles
curl -s https://b.pyblock.xyz:8443/api/market/v1.php/rigs | jq '.rigs[] | select(.state=="available") | {mid, rig, ths, price}'

# 2) cotizar
curl -s "https://b.pyblock.xyz:8443/api/market/v1.php/quote?rigs=<mid>:<rig>&hours=6"

# 3) orden (pagá la factura en 15 min)
curl -s -X POST https://b.pyblock.xyz:8443/api/market/v1.php/orders -H 'Content-Type: application/json' -d '{
  "rigs": [{"mid": "<mid>", "rig": "<rig>"}], "hours": 6,
  "host": "your.pool.example", "port": 3333, "user": "<your address>.worker", "pass": "x",
  "host2": "backup.pool.example", "port2": 3333,
  "refund_to": "[email protected]", "accept": 1 }'

# 4) seguila
curl -s https://b.pyblock.xyz:8443/api/market/v1.php/orders/<secret>

accept: 1 = aceptás que PyBLØCK no se hace responsable de la disponibilidad, estabilidad ni desconexión de las máquinas alquiladas; lo que tu pool no recibe se devuelve.
host2/port2 opcional: si tu pool no contesta, los rigs pasan ahí; si se caen los dos, el alquiler se pausa y ese tiempo se agrega al final.
Sin refund_to, la devolución es un cupón LNURL-withdraw en /orders/{secret} → refund.lnurl.

Publicar tu rig (mineros)

Apuntá el rig a stratum+tcp://pool.pyblock.xyz:23200, usuario <tu dirección XBT>.<rig>, contraseña x. Tras 2 h de verificación aparece en /rigs.
Configurá cobro y precio firmando con la dirección de minería:

curl -s "https://b.pyblock.xyz:8443/api/market/v1.php/payout/challenge?address=<addr>&[email protected]&price=50000&pool=mynode.example.com:23334"
# firmá .message con tu billetera (BIP-137) y después:
curl -s -X POST https://b.pyblock.xyz:8443/api/market/v1.php/payout -H 'Content-Type: application/json' \
  -d '{"address":"<addr>","message":"<message>","signature":"<base64>"}'

pool=host:puerto (obligatorio) = tu propio gateway DATUM (cadena BLAKE2b, tu nodo): el rig mina ahí mientras nadie lo alquila. Lo verificamos antes de darte el mensaje; contamos solo las shares cuya prueba de trabajo validamos nosotros. ¿Sin gateway? PATUM lo instala en un clic.

Mientras te alquilan cobrás cada hora lo entregado, hasta la parte del contrato del tiempo transcurrido (entregar más rápido no adelanta el cobro); el resto al terminar. Comisión PyBLØCK: 3 %.