Certified Miner Data
Summary
This endpoint takes an address as input and returns success if there is a valid certificate of a miner who uses this address to receive coins.
The body of a successful response contains the miner name, miner (Bitcoin) address, miner country, certificate ID, and certificate validity dates.
Restrictions and Assumptions
Only native SegWit P2PKH mainnet addresses are allowed. These start with the characters bc1q...
We assume that miners re-use the same address to receive all of their freshly mined coins.
Endpoint
Authorizations
Path parameters
addressstringRequiredExample:
bcrt1qud948h8hqem5e0pvlcnep8gsp348v99fwrc5seResponses
200
Successful Response
application/json
401
Not authenticated
application/json
403
Not authorized
application/json
404
Miner not found
application/json
422
Validation Error
application/json
500
Internal server error
application/json
get
/v1/certified_miners/{address}GET /v1/certified_miners/{address} HTTP/1.1
Host:
X-API-Key: YOUR_API_KEY
Accept: */*
{
"name": "GreenTech Mining Co.",
"address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
"location": "US",
"certificate_id": "BTC-CL-12345678",
"certificate_valid_from": "2024-01-15T12:30:00Z",
"certificate_valid_until": "2024-07-15T14:30:00Z"
}Last updated