PUBLIC BETA · v1

PyBLØCK Market API

Build on the PyBLØCK Market: list and rent BLAKE2b rigs, follow orders, and set up miner payouts from your own app, bot or site. JSON over HTTPS, no accounts, no API keys, CORS open.

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

Principles

No accounts: an order is identified by its secret (32 hex). Whoever has the secret has the order: status and refunds. Keep it private.
Miners are identified by a public id mid (16 hex), never by their mining address.
Delivery is measured by PyBLØCK validating every share (proof of work), not by what the destination pool reports. What your pool does not receive is refunded.
Payments in XBT over Lightning (BOLT11 invoices from Laguz). Miner payouts and refunds: XBT Lightning address or BOLT12 offer.
Every response has ok; errors come as {"ok":false,"error":"…"} with the HTTP status. Rate limits are per IP; 429 means wait a minute.

Endpoints

GET/statsMarket summary: rigs, available, TH/s, median price.

GET/rigsListed rigs: verified TH/s, price (sats XBT/TH/day), availability, state.

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

GET/miners/{mid}Public miner panel (no amounts).

GET/miners/{mid}/series?range=6|12|168|720|allHashrate history.

GET/quote?rigs=mid:rig,…&hours=HQuote a rental (min 3 h).

POST/ordersCreate an order → Lightning invoice (15 min) + secret.

GET/orders/{secret}Order status, per-rig delivery, refund / coupon.

GET/payout/challenge?address=&payout=&price=Miner: message to sign (1 h).

POST/payoutMiner: save the signed payout.

Rent hashrate in 4 calls

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

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

# 3) order (pay the invoice within 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) follow it
curl -s https://b.pyblock.xyz:8443/api/market/v1.php/orders/<secret>

accept: 1 = you accept that PyBLØCK is not responsible for availability, stability or disconnection of rented machines; what your pool does not receive is refunded.
Optional host2/port2: if your pool does not answer, rigs move there; if both are down, the rental pauses and that time is added at the end.
Without refund_to, refunds are a LNURL-withdraw coupon in /orders/{secret} → refund.lnurl.

List your rig (miners)

Point the rig at stratum+tcp://pool.pyblock.xyz:23200, user <your XBT address>.<rig>, password x. After 2 h of verification it appears in /rigs.
Set payout and price by signing with the mining address:

curl -s "https://b.pyblock.xyz:8443/api/market/v1.php/payout/challenge?address=<addr>&[email protected]&price=50000&pool=mynode.example.com:23334"
# sign .message with your wallet (BIP-137), then:
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:port (required) = your own DATUM gateway (BLAKE2b chain, your node): the rig mines there while nobody rents it. We check it before issuing the message; we only count shares whose proof of work we validate ourselves. No gateway yet? PATUM installs one in one click.

While rented you are paid every hour for what you delivered, up to the contract's share of the time elapsed (delivering faster does not pay you earlier); the rest when the rental ends. 3 % PyBLØCK fee.