The calls
In the examples, $HASHSTRIKE_KEY is your key in an environment variable on your server.
The answers are real answers from a test system: use the ids of your own /listings answer.
GET
/status
No key
Is the API up, are payments working, and how much hashrate is free right now. payments_ok is true only while our last payment check is fresh and good.
curl https://hashstrike.mineshop.eu/partner-api/v1/status
ANSWER
{
"api": "ok",
"payments_ok": true,
"market": {
"free_th": 35.5,
"rented_th": 120,
"free_count": 2,
"rented_count": 1
},
"time": "2026-11-17T09:00:00Z"
}
GET
/listings
No key
Every listing the marketplace page shows, the ones you can rent now first. The list comes in one answer (next_cursor is always null). Add ?ref=<your affiliate number> and each rent_url carries it. Titles are plain text typed by sellers: escape them before you put them into a web page.
curl https://hashstrike.mineshop.eu/partner-api/v1/listings
ANSWER
{
"data": [
{
"id": 214,
"type": "rig",
"title": "market-rig-cbdc194a",
"model": "Antminer S21",
"algorithm": "sha-256",
"hashrate_th": 10,
"price": {
"sats_per_day": 1000,
"sats_per_th_day": 100,
"usd_per_day": 1
},
"min_days": 1,
"max_days": 30,
"discounts": [
{
"from_days": 7,
"percent": 5
},
{
"from_days": 30,
"percent": 10
}
],
"max_quantity": 1,
"coins": [
"btc"
],
"available": true,
"available_from": null,
"stats": {
"rentals": 0,
"avg_delivery_pct": null,
"seller_rating": null,
"best_share": null
},
"rent_url": "https://hashstrike.mineshop.eu/marketplace/rent/214",
"updated_at": "2026-11-17T09:00:00Z"
}
],
"next_cursor": null
}
GET
/listings/{id}
No key
One listing: the same object as in the list. A listing the marketplace page does not show answers 404 not_found.
curl https://hashstrike.mineshop.eu/partner-api/v1/listings/214
GET
/listings/{id}/quote
No key
The exact price for a number of days (1 to 365) and pieces (1 when left out), worked out the same way as on the website. Use total_sats as max_total_sats when you rent. When the rental cannot be bought, available is false and reason says why; the numbers are filled in either way. A quote holds nothing: the rent call checks again.
curl "https://hashstrike.mineshop.eu/partner-api/v1/listings/301/quote?days=7&quantity=1"
ANSWER
{
"listing_id": 301,
"days": 7,
"quantity": 1,
"total_sats": 8862,
"sats_per_day": 1266,
"list_sats_per_day": 1333,
"discount_percent": 5,
"available": true,
"reason": null
}
| REASON | WHAT IT MEANS |
| rented | The rig has a rental. available_from of the listing says until when. |
| listing_unavailable | The listing is not verified yet. |
| sales_paused | Sales of this pooled hashrate are paused. |
| days_out_of_range | The number of days is outside min_days to max_days of the listing. |
| below_minimum | The total is under the smallest rental we sell. Rent for more days or more pieces. |
| not_available_for_days | The pooled hashrate cannot serve this size for this long. Try fewer days or fewer pieces. |
GET
/openapi.json
No key
This API described as an OpenAPI 3.1 document, for tools that read one.
curl https://hashstrike.mineshop.eu/partner-api/v1/openapi.json
GET
/account
Key · read
Who the key belongs to and what it may do. The quickest way to test a new key.
curl https://hashstrike.mineshop.eu/partner-api/v1/account -H "Authorization: Bearer $HASHSTRIKE_KEY"
ANSWER
{
"partner": {
"name": "Example Miners",
"status": "approved"
},
"key": {
"name": "Shop server",
"mode": "test",
"scopes": [
"read",
"rent"
],
"hint": "hs_test_EXAM…XAMP",
"expires_at": null
},
"limits": {
"read_per_minute": 120,
"write_per_minute": 30,
"daily_spend_cap_sats": 1000000,
"rentals_enabled": true
}
}
GET
/balance
Key · read
Your prepaid balance and your daily spend caps, with what the last 24 hours used of them.
curl https://hashstrike.mineshop.eu/partner-api/v1/balance -H "Authorization: Bearer $HASHSTRIKE_KEY"
ANSWER
{
"available_sats": 60000,
"daily_spend_cap_sats": 1000000,
"spent_last_24h_sats": 40000,
"key_daily_spend_cap_sats": null,
"key_spent_last_24h_sats": 40000,
"spend_remaining_sats": 960000
}
| FIELD | WHAT IT MEANS |
| available_sats | Your prepaid balance. |
| daily_spend_cap_sats | The most your account may spend on rentals in any 24 hours. |
| spent_last_24h_sats | The totals of the rentals you started in the last 24 hours. A refund does not lower it. |
| key_daily_spend_cap_sats | The cap of this key, when it has one of its own. Otherwise null. |
| key_spent_last_24h_sats | The same sum for the rentals started with this key. |
| spend_remaining_sats | What this key may still spend now under the caps. Your balance is a separate limit. |
POST
/rentals
Key · rent
Start a rental for your customer. It is paid in full from your balance and the hashrate starts right after the call. The answer is 201 with the rental object.
curl -X POST https://hashstrike.mineshop.eu/partner-api/v1/rentals -H "Authorization: Bearer $HASHSTRIKE_KEY" \
-H "Content-Type: application/json" \
-d '{"reference":"order-1001","listing_id":2325,"days":3,"quantity":1,"coin":"btc","address":"bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq","worker_name":"rig-a","max_total_sats":30000}'
ANSWER
{
"reference": "order-1001",
"id": "P2P-20261117-ZK4K1OII",
"status": "active",
"listing": {
"id": 2325,
"title": "Antminer S21 200T",
"type": "rig"
},
"hashrate_th": 200,
"quantity": 1,
"days": 3,
"coin": "btc",
"total_sats": 30000,
"refund_sats": null,
"starts_at": "2026-11-17T09:03:26Z",
"ends_at": "2026-11-20T09:03:26Z",
"delivery": {
"delivered_pct": 0,
"pace_pct": null,
"current_th": null,
"average_th": null,
"last_share_at": null,
"stale": false
},
"mining": {
"target": "solo",
"pool": null,
"login": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq.rig-a"
},
"tracking_url": "https://hashstrike.mineshop.eu/marketplace/contract/YiPflvNPaoNZmOehpQVcTzbq1cMm1WXv7OmCqnEgxyaXmxMpW0UIabvCasObJhq8",
"created_at": "2026-11-17T09:03:26Z",
"updated_at": "2026-11-17T09:03:26Z"
}
GET
/rentals/{reference}
Key · read
One of your rentals, by your own order number. The answer is the rental object shown above, with all delivery figures. An order number you never used answers 404 not_found.
curl https://hashstrike.mineshop.eu/partner-api/v1/rentals/order-1001 -H "Authorization: Bearer $HASHSTRIKE_KEY"
POST
/rentals/{reference}/pool
Key · rent
Correct the pool details of one of your running rentals while its pool is not taking the work (we warn you first). The new details are tested like those of a new rental, then the rig moves to them. The price, the length and the end of the rental never change. The answer is the rental object with the new pool. A rental whose pool works answers 422 validation_failed.
curl -X POST https://hashstrike.mineshop.eu/partner-api/v1/rentals/order-1002/pool -H "Authorization: Bearer $HASHSTRIKE_KEY" \
-H "Content-Type: application/json" \
-d '{"pool":{"url":"stratum+tcp://pool.example.com:3334","worker":"account.worker1","password":"x"}}'
GET
/rentals
Key · read
The rentals you started through the API, newest first: 25 in one answer unless you send limit (1 to 100). Filter with status (one of the six statuses) and updated_since (an ISO 8601 time with its zone, like 2026-11-17T09:00:00Z: only rentals changed at or after it; a bare date or a word like yesterday answers 422). When next_cursor is not null, send it as cursor to get the next page. Rows carry delivered_pct only: read one rental for the other delivery figures.
curl "https://hashstrike.mineshop.eu/partner-api/v1/rentals?limit=1" -H "Authorization: Bearer $HASHSTRIKE_KEY"
ANSWER
{
"data": [
{
"reference": "order-1002",
"id": "P2P-20261117-Q0MJPZEV",
"status": "active",
"listing": {
"id": 2326,
"title": "API S21 380e8d",
"type": "rig"
},
"hashrate_th": 200,
"quantity": 1,
"days": 1,
"coin": "btc",
"total_sats": 10000,
"refund_sats": null,
"starts_at": "2026-11-17T09:03:26Z",
"ends_at": "2026-11-18T09:03:26Z",
"delivery": {
"delivered_pct": 0
},
"mining": {
"target": "pool",
"pool": "stratum+tcp://pool.example.com:3333",
"login": "account.worker1"
},
"tracking_url": "https://hashstrike.mineshop.eu/marketplace/contract/EzwUWydXSLXOhwcRBqRLuucO8fJalbQiFF2jxZ25b3Ej40p5r3XTmQING5eSYhLm",
"created_at": "2026-11-17T09:03:26Z",
"updated_at": "2026-11-17T09:03:26Z"
}
],
"next_cursor": "OTEuZWI3NWEzZmJiOTY2ZjU3M2JiZDYyNTUxNzFhYzliM2E"
}
Renting in detail
POST /rentals takes a JSON body (Content-Type: application/json, at most 16 KB).
It answers 201 with the rental object.
| FIELD | NEEDED | WHAT IT IS |
| reference | yes | Your own order number. 1 to 64 characters: letters, digits, dot, dash, underscore and colon, starting with a letter or digit. Capitals count. |
| listing_id | yes | The id of a listing from /listings. |
| days | yes | Whole days, 1 to 365, and within min_days and max_days of the listing. |
| quantity | no | How many pieces of the listing, up to its max_quantity. 1 when left out. A rig is always 1. |
| coin | no | btc (when left out) or bch. It must be one of the coins of the listing. |
| address | yes | The address of your customer for that coin, at most 100 characters. A block reward is paid to it. |
| worker_name | no | A name for the worker on our solo pool: up to 40 letters, digits, dash and underscore. Kept in lower case. We make one up when you leave it out. Not used when you send pool. |
| pool | no | Mine on the pool of your customer instead of our solo pool: an object with url and worker, and password if the pool wants one. |
| pool.url | with pool | stratum+tcp://host:port or stratum+ssl://host:port, at most 300 characters. It must be reachable from the internet. |
| pool.worker | with pool | The login at that pool, at most 200 characters. |
| pool.password | no | At most 200 characters. We never send it back in any answer. |
| max_total_sats | yes | The most this rental may cost, in whole sats. Take total_sats from the quote. |
| dry_run | no | true checks everything and rents nothing. |
Any other field, at the top or inside pool, is refused with 422
validation_failed and nothing is rented: a misspelt dry_run
never turns a trial into a real, paid rental.
Sending it twice never rents twice
Send the same body again under the same reference and you get the first rental back
(HTTP 200, "replayed": true): nothing is rented or charged twice.
The same reference with any other field changed (dry_run aside) answers
409 reference_reused.
After a timeout or a 5xx, repeat the same call or read GET /rentals/{reference};
never send the order under a new reference unless the read answers 404.
{
"reference": "order-1001",
"id": "P2P-20261117-ZK4K1OII",
"status": "active",
"…": "…",
"replayed": true
}
The price cannot surprise you
Prices move. If the rental would cost more than max_total_sats, nothing is rented and the answer is
409 price_changed with the price now in total_sats:
{
"error": {
"code": "price_changed",
"message": "The price is above max_total_sats.",
"request_id": "7550b303-eab8-41c8-8034-aa77ec6367c3",
"total_sats": 10000
}
}
Trying it without spending
Send "dry_run": true, or use a test key: a test key always makes a trial call, whatever you send.
Every check runs, nothing is reserved or paid, and the reference stays free. The answer is 200 and tells you
what the rental would cost and whether your balance covers it:
curl -X POST https://hashstrike.mineshop.eu/partner-api/v1/rentals -H "Authorization: Bearer $HASHSTRIKE_KEY" \
-H "Content-Type: application/json" \
-d '{"reference":"order-1001","listing_id":2325,"days":3,"quantity":1,"coin":"btc","address":"bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq","worker_name":"rig-a","max_total_sats":30000,"dry_run":true}'
ANSWER
{
"dry_run": true,
"reference": "order-1001",
"total_sats": 30000,
"balance_sufficient": true,
"available_sats": 100000,
"rental": {
"reference": "order-1001",
"listing": {
"id": 2325,
"title": "Antminer S21 200T",
"type": "rig"
},
"hashrate_th": 200,
"quantity": 1,
"days": 3,
"coin": "btc",
"total_sats": 30000,
"mining": {
"target": "solo",
"pool": null,
"login": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq.rig-a"
}
}
}
Mining on your customer's own pool
Leave pool out and the hashrate mines solo on our pool, for your customer's address.
Send pool and it goes to that pool instead. We check that the pool can be reached before anything is paid:
if not, the answer is 422 pool_unreachable. The password is never sent back.
curl -X POST https://hashstrike.mineshop.eu/partner-api/v1/rentals -H "Authorization: Bearer $HASHSTRIKE_KEY" \
-H "Content-Type: application/json" \
-d '{"reference":"order-1002","listing_id":2326,"days":1,"address":"bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq","pool":{"url":"stratum+tcp://pool.example.com:3333","worker":"account.worker1","password":"x"},"max_total_sats":10000}'
IN THE ANSWER
{
"mining": {
"target": "pool",
"pool": "stratum+tcp://pool.example.com:3333",
"login": "account.worker1"
}
}
When the balance or the daily cap is too low
If your balance does not cover the rental, nothing is rented and the answer is 402
insufficient_balance with both amounts. If the rental would take you over your daily spend cap,
the answer is 403 spend_cap_reached (see Limits).
{
"error": {
"code": "insufficient_balance",
"message": "Your balance doesn't cover 300,000 sats — deposit first from your wallet page.",
"request_id": "49d3fff4-47d2-4889-9ce6-17bd12fa7e72",
"required_sats": 300000,
"available_sats": 60000
}
}