Überblick
Mit der API von btcpuzzle.info spricht der Pool-Client. Sie vergibt Schlüsselbereiche zum Scannen, nimmt das Ergebnis eines Scans entgegen und veröffentlicht die öffentlichen Statistiken des Pools. btcpuzzle.info ist Open Source, und jeder kann einen Client schreiben: Diese Anleitung beschreibt jeden öffentlichen Endpunkt, die zu sendenden Daten, die Daten, die du zurückbekommst, und die Fehler, auf die du stoßen kannst. Fragen: support@btcpuzzle.info.
Diese API ist absichtlich eingefroren: Miner und Tools von Dritten hängen von ihr ab. Pfade, Header, Feldnamen (einschließlich einiger alter Schreibweisen wie dateProcces und holded) und Fehlercodes ändern sich nicht. Antworten können neue Felder erhalten, ignoriere also Felder, die du nicht kennst.
Basis-URL
Jeder Pfad in dieser Anleitung ist relativ zur Basis-URL:
https://btcpuzzle.info/apiClients, die vor dem Umzug der Website geschrieben wurden, können weiter den alten Host verwenden, mit denselben Pfaden und ohne das Präfix /api:
https://api.btcpuzzle.infoZum Beispiel antworten GET https://btcpuzzle.info/api/puzzle/codes und GET https://api.btcpuzzle.info/puzzle/codes gleich. Neue Clients sollten die Basis-URL mit /api verwenden.
Schnellstart
Erstelle ein kostenloses Konto auf btcpuzzle.info, kopiere dein Miner-Token aus dem Dashboard und fordere dann einen Bereich an:
curl "https://btcpuzzle.info/api/puzzle/71/range" \
-H "UserToken: <128-character miner token>" \
-H "WorkerName: rig1"Scanne den zurückgegebenen Bereich zusammen mit den sechs Proof-Adressen, sende den Nachweis mit PUT /puzzle/71/range und wiederhole das. Sende zwischen den beiden Aufrufen ab und zu einen Ping, damit der Pool weiß, dass der Worker noch läuft.
Konventionen
Versionierung
Es gibt eine einzige Version und keine Version in der URL. Der Vertrag der alten API wird exakt eingehalten; siehe Änderungen gegenüber der alten Dokumentation.
Authentifizierung
Die Miner-Endpunkte werden über den Header UserToken identifiziert: das 128 Zeichen lange Miner-Token deines Kontos. Es gibt dafür keine andere Anmeldung und keine Sitzung. Du kannst in deinem Konto jederzeit ein neues Token erstellen; das alte funktioniert dann sofort nicht mehr. Halte das Token geheim: Wer es hat, scannt in deinem Namen.
Alle Daten-Endpunkte (Puzzles, Statistiken, Pool, Token) sind öffentlich und brauchen kein Token.
Anfragen und Antworten
- Bei den Miner-Endpunkten stehen die Anfragedaten in HTTP-Headern, nicht im Query-String oder Body. Header-Namen unterscheiden nicht zwischen Groß- und Kleinschreibung (
UserToken,usertokenunduserTokensind derselbe Header). NurPOST /puzzle/{puzzleCode}/save-private-keyhat einen JSON-Body (Content-Type: application/json). - Antworten sind JSON in UTF-8 mit Eigenschaftsnamen in camelCase. Eigenschaften ohne Wert werden weggelassen; die API schreibt nie ein JSON-
null. Verlasse dich nicht auf die Einrückung. - Datumsangaben sind ISO 8601 in UTC (
2026-11-18T08:28:25.8176144Z). Geldbeträge und Mengen sind JSON-Zahlen. - Große Zahlen wie
rangeContainsKeyssind vorzeichenlose 64-Bit-Ganzzahlen und können größer als 2^53 sein: Parse sie in Sprachen mit Doubles als 64-Bit-Ganzzahlen oder Strings. - Wallet-Adressen in öffentlichen Daten sind gekürzt (erste 8 Zeichen,
..., letzte 8), und das dritte Zeichen eines Bereichs-HEX wird durchXersetzt (3AB8443wird zu3AX8443).
Ratenlimits
Die folgenden Limits sind die aktuellen Standardwerte. Sie werden in einem festen Zeitfenster gezählt; der Betreiber kann sie anpassen, lies also die 429-Antwort, statt die Zahlen fest einzuprogrammieren.
| Gilt für | Gezählt pro | Limit |
|---|---|---|
GET /puzzle/{puzzleCode}/range | UserToken | 120 Anfragen pro 60 Sekunden |
PUT /puzzle/{puzzleCode}/range | UserToken | 360 Anfragen pro 60 Sekunden |
PATCH /puzzle/{puzzleCode}/range/ping | UserToken | 360 Anfragen pro 60 Sekunden |
POST /puzzle/{puzzleCode}/save-private-key | UserToken | 10 Anfragen pro 180 Sekunden |
| Alle anderen Endpunkte | IP-Adresse | 20 Anfragen pro Sekunde je Endpunkt, insgesamt 200 pro Sekunde |
Eine Anfrage über dem Limit wird mit 429 Too Many Requests, einem Retry-After-Header und diesem Body beantwortet:
{
"isSuccess": false,
"details": "Quota exceeded."
}Fehler
Fehlschläge verwenden die folgenden Statuscodes. Der Body hängt vom Endpunkt ab, prüfe also zuerst den Statuscode.
| Status | Body | Bedeutung |
|---|---|---|
400 | {"error": "<code>"} | Ein Miner-Endpunkt hat die Anfrage abgelehnt. Der Code sagt, warum: invalid_puzzle, invalid_user_token, reached_of_keyspace, too_much_request, not_eligable (die Schreibweise ist historisch), invalid_request. |
400 | {"isSuccess": false} | Die Markierungsanfrage eines Bereichs wurde abgelehnt (falscher Nachweis, unbekannter oder bereits gescannter Bereich, gesperrter Nutzer, inaktives Puzzle). |
400 | Validierungsproblem | Ein Pflicht-Header fehlt oder ist ungültig, oder die Puzzle-Nummer liegt außerhalb von 1 bis 160. Es ist ein application/problem+json-Objekt, dessen errors die fehlerhaften Namen auflistet. |
400 | Problem Details | Ein öffentlicher Daten-Endpunkt hat für dieses Puzzle nichts zu antworten (unbekanntes oder inaktives Puzzle). application/problem+json mit type, title, status und traceId. |
401 | {"error": "invalid_user_token"} | Das Miner-Token ist unbekannt oder das Konto gesperrt (Ping und save-private-key). |
404 | {"error": "range_not_found"} | Der zu pingende Bereich ist nicht für diesen Worker reserviert. |
429 | {"isSuccess": false, "details": "Quota exceeded."} | Ratenlimit. Warte Retry-After Sekunden. |
Beispiel für ein Validierungsproblem (GET /puzzle/71/range ohne den Header UserToken):
{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
"title": "One or more validation errors occurred.",
"status": 400,
"errors": {
"UserToken": [
"The UserToken field is required."
]
},
"traceId": "00-e3fc704f799663ec7f42c140ab4c996d-8592b3515c26a5c2-00"
}Caching und CORS
Öffentliche Daten-Endpunkte senden Cache-Control: public, max-age=N; der Wert steht bei jedem Endpunkt, und eine zwischengespeicherte Kopie wird von allen Aufrufern geteilt, häufigeres Abfragen als alle N Sekunden liefert also nur dieselben Daten. Miner-Endpunkte werden nie zwischengespeichert. Browser dürfen die API von https://btcpuzzle.info, https://www.btcpuzzle.info und http://localhost:3000 aus aufrufen (letzteres existiert für die lokale Entwicklung des alten Frontends); native Clients sind von CORS nicht betroffen.
Miner-Endpunkte
Die drei Aufrufe der Scan-Schleife: Bereich holen, während des Scans pingen, als gescannt markieren. Ein vierter Aufruf speichert einen gefundenen Schlüssel. Alle vier verwenden den Header UserToken.
GET/puzzle/{puzzleCode}/range
Vergibt einen zufälligen freien Bereich des Puzzles und reserviert ihn für dich. Niemand sonst erhält einen von dir reservierten Bereich; markierst du ihn nicht, geht er nach einer Weile an den Pool zurück (ein Ping verlängert die Reservierung).
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
puzzleCode | path | integer (1 bis 160) | Ja | Das zu scannende Puzzle, zum Beispiel 71. 38 ist der Test-Pool. GET /puzzle/codes listet die Codes. Für ein abgeschlossenes Puzzle wird stillschweigend das Standard-Puzzle bedient, und die Antwort nennt in puzzleCode, welches Puzzle du bekommen hast. |
UserToken | header | string (128 Zeichen) | Ja | Dein Miner-Token. |
WorkerName | header | string (1 bis 16 Zeichen) | Nein | Der Name dieses Workers. Nur Buchstaben und Ziffern. Wird als default gespeichert, wenn du keinen sendest. |
SecurityHash | header | string | Nein | Freier Text, der mit dem Bereich gespeichert wird. Optional. |
CustomRange | header | string | Nein | Schränkt den erhaltenen Bereich ein: ein Präfix des HEX (2D, 3BA) oder start:end (3400000:38FFFFF). none oder kein Header bedeutet beliebiger Bereich. Ein sehr schmales Fenster wird vom Pool erweitert, du kannst also einen anderen Bereich als den genannten erhalten. |
Beispielanfrage
curl "https://btcpuzzle.info/api/puzzle/71/range" \
-H "UserToken: <128-character miner token>" \
-H "WorkerName: rig1"Beispielantwort
200 OK
{
"hex": "3AB8443",
"puzzleCode": 71,
"workloadStart": "00000000000",
"workloadEnd": "fffffffffff",
"targetAddress": "1MVDYgVaSN6iKKEsbzRUAYFrYJadLYZvvZ",
"proofOfWorkAddresses": [
"1QLLeQ3Hwp9ai7L4KM65e7SxS12skkYUsA",
"15mLWAX7Hno94fntWj6PEx5wCvZz2zAn8a",
"1DazU9YxVrojvnTrcZrymyc6ZrDkvezJEA",
"14Qada8GbVoKUXCtPHBgF7BPjdEhJWo1ph",
"1PmdgtX2NzoSsSf2ANAnFrBzdftyW3CThY",
"14it3UVGsK6JhsV2HPimD46VSpVcXipFwQ"
]
}Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
hex | string | Der zu scannende Bereich, in Großbuchstaben ohne Auffüllung. Er ist der Anfang der privaten Schlüssel des Bereichs. |
puzzleCode | integer | Das Puzzle, zu dem der Bereich gehört (das Standard-Puzzle, wenn das angefragte abgeschlossen ist). |
workloadStart | string | Wird an hex angehängt, um den ersten privaten Schlüssel des Bereichs zu erhalten. |
workloadEnd | string | Wird an hex angehängt, um den letzten privaten Schlüssel des Bereichs zu erhalten. Bei Puzzles, deren Bereiche mehrere IDs umfassen, kann es länger als workloadStart sein. |
targetAddress | string | Die gesuchte Puzzle-Adresse. Scanne sie zusammen mit den Proof-Adressen. |
proofOfWorkAddresses | array aus 6 strings | Adressen von sechs privaten Schlüsseln, die der Pool im Bereich platziert hat. Finde ihre privaten Schlüssel, um den Scan nachzuweisen: siehe Proof of Work. |
Im Beispiel oben reicht der Bereich von 3AB8443 + 00000000000 = 3AB844300000000000 bis 3AB8443 + fffffffffff = 3AB8443FFFFFFFFFFF. Private Schlüssel haben 64 Hexadezimalzeichen; fülle links mit Nullen auf.
Fehler
| Status | Body | Wann |
|---|---|---|
400 | {"error": "invalid_puzzle"} | Das Puzzle existiert nicht oder ist nicht aktiv. |
400 | {"error": "invalid_user_token"} | Das Token ist unbekannt oder gesperrt. |
400 | {"error": "too_much_request"} | Du hast zu viele nicht gescannte Bereiche reserviert oder fragst schneller an, als du fertig wirst. Scanne, was du reserviert hast; reservierte Bereiche gehen nach kurzer Zeit an den Pool zurück. |
400 | {"error": "not_eligable"} | Das Puzzle hat eine Teilnahmegebühr, und du erfüllst ihre Bedingungen noch nicht. |
400 | {"error": "reached_of_keyspace"} | Es ist kein freier Bereich mehr übrig (oder keiner, der zu deinem CustomRange passt). |
400 | validation problem | Fehlender oder fehlerhafter Header oder eine Puzzle-Nummer außerhalb von 1 bis 160. |
429 | {"isSuccess": false, ...} | Ratenlimit: 120 pro Minute und Token. |
Proof of Work
Der Pool will sicher sein, dass du den Bereich wirklich gescannt hast. Für jeden Bereich wählt er sechs private Schlüssel darin aus und gibt nur deren Adressen zurück (proofOfWorkAddresses). Während du den Bereich nach der Zieladresse durchsuchst, suche auch nach diesen sechs Adressen. Wenn du alle sechs privaten Schlüssel gefunden hast:
- Schreibe jeden privaten Schlüssel als 64 Hexadezimalzeichen in Großbuchstaben, links mit Nullen aufgefüllt.
- Verkette die sechs Strings in der Reihenfolge der Adressen, ohne etwas dazwischen.
- Berechne den SHA-256 des UTF-8-Textes und schreibe ihn als 64 Hexadezimalzeichen in Kleinbuchstaben. Das ist der
HashedProofKeyder Markierungsanfrage.
ProofKey1 = 000000000000000000000000000000000000000000000003AB8443AB91BBAFE8 // for proofOfWorkAddresses[0]
ProofKey2 = 000000000000000000000000000000000000000000000003AB84435AF1E51FD1 // for proofOfWorkAddresses[1]
...
ProofKey6 = ...
HashedProofKey = lowercase_hex( SHA256( ProofKey1 + ProofKey2 + ProofKey3 + ProofKey4 + ProofKey5 + ProofKey6 ) )
= 892a38381912bcce412030d7a403de8a92c0e56f452ba5a865f0bf728ff3fa87Der Nachweis ist für jeden Bereich anders. Die Anzahl der Proof-Adressen beträgt heute sechs; lies die Länge von proofOfWorkAddresses, statt davon auszugehen.
PUT/puzzle/{puzzleCode}/range
Markiert einen Bereich als gescannt. Der Pool prüft den Nachweis und zählt den Bereich, wenn er stimmt, als von dir erledigt. Ein Bereich kann nur einmal markiert werden.
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
puzzleCode | path | integer (1 bis 160) | Ja | Das Puzzle des Bereichs. |
UserToken | header | string (128 Zeichen) | Ja | Dein Miner-Token. |
HEX | header | string | Ja | Der hex des gescannten Bereichs, so wie der Pool ihn zurückgegeben hat. Beispiel: 3AB8443. |
HashedProofKey | header | string | Ja | Der Arbeitsnachweis: siehe Proof of Work. |
WorkerName | header | string (1 bis 16 Zeichen) | Nein | Der Worker, der den Bereich gescannt hat. |
GPUName | header | string | Nein | Das Grafikkartenmodell. Wird für die öffentlichen Statistiken verwendet. |
GPUCount | header | integer | Nein | Anzahl der Karten des Workers. Standard 1. |
IsForceContinue | header | boolean | Nein | Setze ihn, wenn der Worker weitergemacht hat, obwohl er das Ende seines Schlüsselraums erreicht hatte. Standard false. |
Beispielanfrage
curl -X PUT "https://btcpuzzle.info/api/puzzle/71/range" \
-H "UserToken: <128-character miner token>" \
-H "WorkerName: rig1" \
-H "HEX: 3AB8443" \
-H "HashedProofKey: 892a38381912bcce412030d7a403de8a92c0e56f452ba5a865f0bf728ff3fa87" \
-H "GPUName: RTX 4090" \
-H "GPUCount: 1"Beispielantwort
200 OK
{
"isSuccess": true
}Fehler
| Status | Body | Wann |
|---|---|---|
400 | {"isSuccess": false} | Jede Ablehnung: falscher Nachweis, unbekannter Bereich, bereits markierter Bereich, gesperrtes Konto, inaktives Puzzle. |
400 | validation problem | Ein Pflicht-Header fehlt oder ist fehlerhaft. |
429 | {"isSuccess": false, ...} | Ratenlimit: 360 pro Minute und Token. |
PATCH/puzzle/{puzzleCode}/range/ping
Teilt dem Pool mit, dass ein Worker seinen Bereich noch scannt. Ein Ping erhält die Reservierung des Bereichs und zeigt den Worker auf der Website als aktiv an. Sende etwa alle 2 Minuten einen; der Abstand darf nicht länger als 30 Minuten sein, sonst nimmt der Pool den Bereich zurück.
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
puzzleCode | path | integer | Ja | Das Puzzle des Bereichs. |
Hex | header | string | Ja | Der Bereich, den der Worker gerade scannt. |
UserToken | header | string (128 Zeichen) | Ja | Dein Miner-Token. |
WorkerName | header | string | Ja | Der Worker-Name, der bei der Anforderung des Bereichs verwendet wurde (default, wenn keiner gesendet wurde). |
Beispielanfrage
curl -X PATCH "https://btcpuzzle.info/api/puzzle/71/range/ping" \
-H "Hex: 3AB8443" \
-H "UserToken: <128-character miner token>" \
-H "WorkerName: rig1"Beispielantwort
200 OK mit leerem Body.
Fehler
| Status | Body | Wann |
|---|---|---|
400 | {"error": "invalid_request"} | Ein Header ist leer. |
401 | {"error": "invalid_user_token"} | Unbekanntes oder gesperrtes Token. |
404 | {"error": "range_not_found"} | Dieser Worker hat keinen nicht gescannten Bereich mit diesem HEX bei diesem Puzzle reserviert. |
429 | {"isSuccess": false, ...} | Ratenlimit: 360 pro Minute und Token. |
POST/puzzle/{puzzleCode}/save-private-key
Speichert einen gefundenen privaten Schlüssel verschlüsselt in deinem Konto. Der Client verschlüsselt den Schlüssel mit dem öffentlichen RSA-Schlüssel, den du ihm gegeben hast; die Seite speichert nur den verschlüsselten Text, den du mit deinem privaten Schlüssel entschlüsselst. Der Schlüssel erscheint auf der Seite der gefundenen Schlüssel in deinem Dashboard.
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
puzzleCode | path | integer | Ja | Das Puzzle, zu dem der Schlüssel gehört. |
UserToken | header | string (128 Zeichen) | Ja | Dein Miner-Token. |
Content-Type | header | string | Ja | application/json. |
name | body | string | Nein | Eine Bezeichnung, zum Beispiel der Worker-Name. Gespeichert als Puzzle71 - rig1. |
encryptedKey | body | string | Ja | Der verschlüsselte private Schlüssel (der Client sendet ihn in Base64). |
Beispielanfrage
curl -X POST "https://btcpuzzle.info/api/puzzle/71/save-private-key" \
-H "UserToken: <128-character miner token>" \
-H "Content-Type: application/json" \
-d '{"name": "rig1","encryptedKey": "<encrypted key, base64>"}'Beispielantwort
200 OK Beachte, dass die Eigenschaft success heißt, nicht isSuccess.
{
"success": true,
"message": "Key saved successfully."
}Fehler
| Status | Body | Wann |
|---|---|---|
401 | {"error": "invalid_user_token"} | Unbekanntes oder gesperrtes Token. |
400 | problem details | Es wurde nichts gespeichert: Derselbe Schlüssel ist für dieses Konto bereits gespeichert, oder der Body fehlt. |
429 | {"isSuccess": false, ...} | Ratenlimit: 10 pro 180 Sekunden und Token. |
Puzzle-Daten
Öffentliche Lese-Endpunkte zu den Puzzles des Pools. Es ist kein Token nötig. Das Puzzle-Objekt und die anderen Objekte werden am Ende dieser Anleitung beschrieben.
GET/puzzle
Die Puzzles im Pool: die aktiven, die nächsten und der Test-Pool (sowie die abgeschlossenen, die für die Historie aufbewahrt werden). 300 Sekunden zwischengespeichert.
Beispielanfrage
curl "https://btcpuzzle.info/api/puzzle"Beispielantwort
200 OK Ein Array von Puzzle-Objekten, hier auf eines gekürzt.
[
{
"id": 71,
"name": "Puzzle 71",
"code": 71,
"hexStart": "400000000000000000",
"hexEnd": "7fffffffffffffffff",
"targetWalletAddress": "1MVDYgVaSN6iKKEsbzRUAYFrYJadLYZvvZ",
"hexRangeLength": 7,
"reward": 7.1,
"hexStartPool": "4000000",
"hexEndPool": "7ffffff",
"totalRanges": 67108864,
"percentage": 0.4172,
"rangesScannedLastHour": 612,
"totalScanned": 279997,
"statisticsTotalScanned": 0,
"statisticsFoundOnPool": false,
"statisticsFoundDate": "2026-11-18T08:27:56.937996Z",
"rangeContainsKeyByDefault": 17592186044415,
"rangeContainsKeys": 17592186044415,
"rangesPerKey": 1,
"workloadStart": "00000000000",
"workloadEnd": "fffffffffff",
"dateStart": "2026-01-01T00:00:00Z",
"dateEnd": "2027-01-01T00:00:00Z",
"isCompleted": false,
"isNextPuzzle": false,
"isActive": true,
"isEntranceFeeActive": false,
"entranceFee": 0,
"isDefault": true,
"isTestPool": false,
"isOnPool": true,
"nextScanAllowedInMinutes": 360,
"challenges": []
}
]Fehler
| Status | Body | Wann |
|---|---|---|
404 | [] | Der Pool hat überhaupt kein Puzzle. |
GET/puzzle/all
Jedes Puzzle der Datenbank, einschließlich der abgeschlossenen. 300 Sekunden zwischengespeichert.
Beispielanfrage
curl "https://btcpuzzle.info/api/puzzle/all"Antwortet mit 200 und einem Array von Puzzle-Objekten.
GET/puzzle/available
Die Puzzles, die im Pool gescannt werden können. 300 Sekunden zwischengespeichert.
Beispielanfrage
curl "https://btcpuzzle.info/api/puzzle/available"Antwortet mit 200 und einem Array von Puzzle-Objekten.
GET/puzzle/default
Das Standard-Puzzle: dasjenige, auf das eine Anfrage für ein abgeschlossenes Puzzle zurückfällt. 300 Sekunden zwischengespeichert.
Beispielanfrage
curl "https://btcpuzzle.info/api/puzzle/default"Beispielantwort
200 OK Ein einzelnes Puzzle-Objekt.
{
"id": 71,
"name": "Puzzle 71",
"code": 71,
"hexStart": "400000000000000000",
"hexEnd": "7fffffffffffffffff",
"targetWalletAddress": "1MVDYgVaSN6iKKEsbzRUAYFrYJadLYZvvZ",
"hexRangeLength": 7,
"reward": 7.1,
"hexStartPool": "4000000",
"hexEndPool": "7ffffff",
"totalRanges": 67108864,
"percentage": 0.4172,
"rangesScannedLastHour": 612,
"totalScanned": 279997,
"statisticsTotalScanned": 0,
"statisticsFoundOnPool": false,
"statisticsFoundDate": "2026-11-18T08:27:56.937996Z",
"rangeContainsKeyByDefault": 17592186044415,
"rangeContainsKeys": 17592186044415,
"rangesPerKey": 1,
"workloadStart": "00000000000",
"workloadEnd": "fffffffffff",
"dateStart": "2026-01-01T00:00:00Z",
"dateEnd": "2027-01-01T00:00:00Z",
"isCompleted": false,
"isNextPuzzle": false,
"isActive": true,
"isEntranceFeeActive": false,
"entranceFee": 0,
"isDefault": true,
"isTestPool": false,
"isOnPool": true,
"nextScanAllowedInMinutes": 360,
"challenges": []
}Fehler
| Status | Body | Wann |
|---|---|---|
404 | {"error": "puzzle_not_found"} | Es ist kein Standard-Puzzle festgelegt. |
GET/puzzle/codes
Die Nummern der aktiven oder nächsten Puzzles, normale Puzzles zuerst und der Test-Pool zuletzt. 300 Sekunden zwischengespeichert.
Beispielanfrage
curl "https://btcpuzzle.info/api/puzzle/codes"Beispielantwort
200 OK
[71, 72, 73, 38]GET/puzzle/{puzzleCode}/info
Ein Puzzle, aus der Datenbank gelesen. 10 Sekunden zwischengespeichert.
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
puzzleCode | path | integer | Ja | Die Puzzle-Nummer. |
Beispielanfrage
curl "https://btcpuzzle.info/api/puzzle/71/info"Beispielantwort
200 OK Ein Puzzle-Objekt. Laufzeitwerte wie rangesScannedLastHour werden nur in den Listen-Endpunkten befüllt.
{
"id": 71,
"name": "Puzzle 71",
"code": 71,
"hexStart": "400000000000000000",
"hexEnd": "7fffffffffffffffff",
"targetWalletAddress": "1MVDYgVaSN6iKKEsbzRUAYFrYJadLYZvvZ",
"hexRangeLength": 7,
"reward": 7.1,
"hexStartPool": "4000000",
"hexEndPool": "7ffffff",
"totalRanges": 67108864,
"percentage": 0.4172,
"rangesScannedLastHour": 612,
"totalScanned": 279997,
"statisticsTotalScanned": 0,
"statisticsFoundOnPool": false,
"statisticsFoundDate": "2026-11-18T08:27:56.937996Z",
"rangeContainsKeyByDefault": 17592186044415,
"rangeContainsKeys": 17592186044415,
"rangesPerKey": 1,
"workloadStart": "00000000000",
"workloadEnd": "fffffffffff",
"dateStart": "2026-01-01T00:00:00Z",
"dateEnd": "2027-01-01T00:00:00Z",
"isCompleted": false,
"isNextPuzzle": false,
"isActive": true,
"isEntranceFeeActive": false,
"entranceFee": 0,
"isDefault": true,
"isTestPool": false,
"isOnPool": true,
"nextScanAllowedInMinutes": 360,
"challenges": []
}Fehler
| Status | Body | Wann |
|---|---|---|
204 | leer | Kein solches Puzzle. |
GET/puzzle/{puzzleCode}/statistics
Alles, was die Puzzle-Seite zeigt: Summen, Ranglisten, aktive Worker, die letzten 200 gescannten Bereiche und ein stündliches Diagramm. 60 Sekunden zwischengespeichert (und der Server hält eine Kopie 5 Minuten lang).
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
puzzleCode | path | integer | Ja | Ein aktives Puzzle (oder der Test-Pool). |
Beispielanfrage
curl "https://btcpuzzle.info/api/puzzle/71/statistics"Beispielantwort
200 OK Gekürzt: Die Arrays enthalten hier ein Element, und lastRanges bis zu 200.
{
"puzzle": {
"name": "Puzzle 71",
"code": 71,
"hexStart": "400000000000000000",
"hexEnd": "7fffffffffffffffff",
"targetWalletAddress": "1MVDYgVaSN6iKKEsbzRUAYFrYJadLYZvvZ",
"hexStartPool": "4000000",
"hexEndPool": "7ffffff",
"totalRanges": 67108864,
"totalScanned": 279997,
"rangeContainsKeys": 17592186044415,
"workloadStart": "00000000000",
"workloadEnd": "fffffffffff",
"rangesPerKey": 1,
"isCompleted": false,
"isActive": true,
"isEntranceFeeActive": false,
"entranceFee": 0,
"isDefault": true,
"isTestPool": false,
"reward": 7.1
},
"scannedLast24H": 14702,
"entranceFeesPaidTotal": 0,
"topWorkersAlltime": [
{
"userId": 0,
"walletAddress": "1BvBMSEY...7xJaNVN2",
"totalScanned": 5120
}
],
"topWorkersLast24h": [
{
"userId": 2051875,
"walletAddress": "1BvBMSEY...7xJaNVN2",
"totalScanned": 412
}
],
"activeWorkers": [
{
"walletAddress": "1BvBMSEY...7xJaNVN2",
"workerName": "rig1"
}
],
"challenges": [],
"kingdom": {
"walletAddress": "1BvBMSEY...7xJaNVN2",
"message": "Hello pool",
"image": 3,
"isPublished": true
},
"topSpeed": {
"date": "2026-11-10T14:00:00Z",
"scanned": 912,
"keysPerSecond": 4456789012345
},
"chartData": [
{
"date": "2026-11-18T08:00:00Z",
"dateOnly": "2026-11-18",
"hoursOnly": 8,
"rangesScanned": 640
}
],
"lastRanges": [
{
"hex": "10X0",
"walletAddress": "1BvBMSEY...7xJaNVN2",
"startTime": "2026-11-18T07:27:57.603786Z",
"endTime": "2026-11-18T08:22:57.603786Z",
"pingTime": "2026-11-18T08:20:57.603786Z",
"gpuModel": "RTX 4090",
"gpuCount": 1,
"workerName": "rig1",
"isPremiumUser": false,
"isScanned": true,
"isPinged": false,
"keysInSeconds": 20824083.85909091,
"totalSeconds": 3300
}
],
"rewards": [],
"dateUpdated": "2026-11-18T08:28:25.8176144Z",
"currentSpeed": {
"activeWorkerCount": 38,
"keysPerSecondFormatted": "162.3 Bkeys/s",
"keysPerSecondRaw": "162300000000"
}
}Für ein noch nicht aktives Puzzle (die nächsten) werden nur puzzle, scannedLast24H, entranceFeesPaidTotal, lastRanges und dateUpdated zurückgegeben. Die Felder findest du unter Statistics-Objekt.
Fehler
| Status | Body | Wann |
|---|---|---|
400 | problem details | Das Puzzle existiert nicht oder ist weder aktiv noch als Nächstes dran. |
GET/puzzle/{puzzleCode}/speed
Die aktuelle Geschwindigkeit des Pools bei einem Puzzle. 60 Sekunden zwischengespeichert.
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
puzzleCode | path | integer | Ja | Die Puzzle-Nummer. |
Beispielanfrage
curl "https://btcpuzzle.info/api/puzzle/71/speed"Beispielantwort
200 OK Siehe CurrentSpeed. Ein unbekanntes Puzzle antwortet mit Nullwerten, nie mit einem Fehler.
{
"puzzleCode": 71,
"currentSpeed": {
"activeWorkerCount": 38,
"keysPerSecondFormatted": "162.3 Bkeys/s",
"keysPerSecondRaw": "162300000000"
}
}GET/puzzle/{puzzleCode}/workers
Die Worker, die gerade scannen: diejenigen mit einem Bereich, den sie in den letzten 30 Minuten gepingt haben. Nicht im Browser zwischengespeichert; der Server hält die Antwort 60 Sekunden lang. puzzleCode 0 bedeutet das Standard-Puzzle.
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
puzzleCode | path | integer | Ja | Die Puzzle-Nummer. |
Beispielanfrage
curl "https://btcpuzzle.info/api/puzzle/71/workers"Beispielantwort
200 OK Ein leeres Array, wenn niemand scannt oder das Puzzle unbekannt ist.
[
{
"walletAddress": "1BvBMSEY...7xJaNVN2",
"workerName": "rig1"
}
]GET/puzzle/{puzzleCode}/workers-pinging
Dieselbe Liste wie /workers (als eigener Pfad erhalten, weil Clients beide verwenden).
Beispielanfrage
curl "https://btcpuzzle.info/api/puzzle/71/workers-pinging"Dieselben Parameter und dieselbe Antwort wie GET /puzzle/{puzzleCode}/workers.
GET/puzzle/{puzzleCode}/rewards
Die Pool-Belohnungen eines aktiven Puzzles: Zusatzpreise, die Sponsoren auf private Schlüssel innerhalb der Bereiche setzen (neueste zuerst, bis zu 32). Der private Schlüssel einer Belohnung wird erst angezeigt, nachdem sie gelöst wurde. 600 Sekunden zwischengespeichert.
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
puzzleCode | path | integer | Ja | Ein aktives Puzzle. |
Beispielanfrage
curl "https://btcpuzzle.info/api/puzzle/71/rewards"Beispielantwort
200 OK Siehe Reward. Ein leeres Array, wenn das Puzzle keine hat.
[
{
"id": 12,
"puzzleCode": 71,
"targetAddress": "1ExampleRewardAddress0000000000000",
"rewardDescription": "Hardware wallet",
"provider": "Sponsor",
"brand": "Example",
"dateCreated": "2026-11-01T00:00:00Z",
"dateSolved": "0001-01-01T00:00:00",
"puzzleId": 71
}
]Fehler
| Status | Body | Wann |
|---|---|---|
400 | problem details | Das Puzzle ist nicht aktiv. |
GET/puzzle/{puzzleCode}/challenge
Die neuesten Challenge-Startpunkte eines aktiven Puzzles (neueste zuerst, bis zu 32). 600 Sekunden zwischengespeichert.
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
puzzleCode | path | integer | Ja | Ein aktives Puzzle. |
Beispielanfrage
curl "https://btcpuzzle.info/api/puzzle/71/challenge"Beispielantwort
200 OK Siehe Challenge. Ein leeres Array, wenn es keine gibt.
[
{
"hex": "3A",
"dateCreated": "2026-11-18T06:00:00Z",
"puzzleId": 71
}
]Fehler
| Status | Body | Wann |
|---|---|---|
400 | problem details | Das Puzzle ist nicht aktiv. |
GET/puzzle/{puzzleCode}/entrancefee
Die Teilnahmegebühr eines Puzzles in USD, wenn die Gebühr aktiv ist. 300 Sekunden zwischengespeichert.
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
puzzleCode | path | integer | Ja | Ein aktives Puzzle mit Teilnahmegebühr. |
Beispielanfrage
curl "https://btcpuzzle.info/api/puzzle/71/entrancefee"Beispielantwort
200 OK
{
"fee": 25.0,
"puzzle": 71
}Fehler
| Status | Body | Wann |
|---|---|---|
400 | problem details | Das Puzzle ist nicht aktiv oder hat keine Teilnahmegebühr. |
GET/puzzle/{puzzleCode}/statistics-by-hex-prefix
Wie viel des Puzzles für jedes zweistellige Präfix des Bereichs-HEX gescannt ist (die Heatmap der Puzzle-Seite). 3.600 Sekunden zwischengespeichert.
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
puzzleCode | path | integer | Ja | Ein aktives Puzzle. |
Beispielanfrage
curl "https://btcpuzzle.info/api/puzzle/71/statistics-by-hex-prefix"Beispielantwort
200 OK Ein Element pro Präfix, sortiert nach hexStarts. Die Eigenschaft pertantageShow ist absichtlich falsch geschrieben (eingefroren). Ab 70 % bleiben die Zahlen bei 70 % stehen, und isLimitExceeded ist true.
[
{
"hexStarts": "40",
"maxRanges": 1048576,
"scannedShow": 4411,
"pertantageShow": 0.37,
"isLimitExceeded": false
}
]Fehler
| Status | Body | Wann |
|---|---|---|
400 | problem details | Das Puzzle ist nicht aktiv. |
Pool-Daten
Öffentliche Lese-Endpunkte zum Pool insgesamt, zur GPU-Liste und zum BCPZ-Token.
GET/pool/homepage
Die Puzzle-Liste der Startseite: dasselbe Array wie GET /puzzle, und das Standard-Puzzle enthält seine speed. 60 Sekunden zwischengespeichert.
Beispielanfrage
curl "https://btcpuzzle.info/api/pool/homepage"Antwortet mit 200 und einem Array von Puzzle-Objekten.
GET/pool/gpus
Die GPU-Benchmark-Liste, schnellste zuerst (Schlüssel pro Sekunde im Pool). 300 Sekunden zwischengespeichert.
Beispielanfrage
curl "https://btcpuzzle.info/api/pool/gpus"Beispielantwort
200 OK
[
{
"brand": "nvidia",
"name": "RTX 4090",
"keysPerSecond": 4491469067.71,
"dateUpdated": "2026-11-18T08:27:53.190819Z"
}
]Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
brand | string | nvidia oder amd. |
name | string | Die Karte. |
keysPerSecond | number | Gemessene Geschwindigkeit. |
dateUpdated | date | Letzte Aktualisierung. |
GET/pool/token-distribute-history
Die täglichen BCPZ-Verteilungen, neueste zuerst (bis zu 180). 300 Sekunden zwischengespeichert.
Beispielanfrage
curl "https://btcpuzzle.info/api/pool/token-distribute-history"Beispielantwort
200 OK
[
{
"id": 412,
"dateProcces": "2026-11-17T03:00:19Z",
"totalUsers": 85,
"totalAmount": 516,
"description": "Success: 85/85"
}
]Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
id | integer | Nummer der Verteilung. |
dateProcces | date | Wann sie lief. Der Name ist falsch geschrieben und eingefroren. |
totalUsers | integer | Nutzer, die Token erhalten haben. |
totalAmount | number | Verteilte BCPZ (1 pro gescanntem Bereich). |
description | string | Ergebnistext. |
GET/pool/token-top-50-holders
Die 50 Konten mit den meisten verdienten BCPZ, Wallet-Adressen gekürzt. 600 Sekunden zwischengespeichert.
Beispielanfrage
curl "https://btcpuzzle.info/api/pool/token-top-50-holders"Beispielantwort
200 OK
[
{
"walletAddress": "1BvBMSEY...7xJaNVN2",
"balance": 2500.25,
"total": 400,
"minted": 200
}
]Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
walletAddress | string | Gekürzte Adresse. |
balance | number | Aktuelle BCPZ auf dem Konto. |
total | number | Insgesamt verdiente BCPZ. |
minted | number | Bereits ins Polygon-Netzwerk ausgezahlte BCPZ. |
GET/pool/token-mint-history
Die neuesten BCPZ-Auszahlungen ins Polygon-Netzwerk, neueste zuerst (bis zu 180). 600 Sekunden zwischengespeichert.
Beispielanfrage
curl "https://btcpuzzle.info/api/pool/token-mint-history"Beispielantwort
200 OK
[
{
"walletAddress": "1BvBMSEY...7xJaNVN2",
"minted": 100,
"date": "2026-11-15T08:27:58.123754Z",
"txId": "0x1609149d1d218ff590c738ca97b9cac42613c2a248393d66dfad36c3702c3fee"
}
]Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
walletAddress | string | Gekürzte Adresse des Kontos. |
minted | number | Gesendete BCPZ. |
date | date | Wann sie gesendet wurden. |
txId | string | Hash der Polygon-Transaktion. Fehlt, solange die Übertragung nicht abgeschlossen ist. |
GET/pool/btc-price
Der Bitcoin-Kurs in USD und EUR von einer Börse. 600 Sekunden zwischengespeichert.
Beispielanfrage
curl "https://btcpuzzle.info/api/pool/btc-price"Beispielantwort
200 OK Beide Werte sind 0, wenn die Kursquelle nicht erreichbar ist.
{"usd":66739.06,"eur":60607.25}Echtzeit-Feed (SignalR)
Der Pool veröffentlicht jeden reservierten und fertigen Bereich an einen SignalR-Hub. Die Website nutzt ihn für die Live-Statusseite. Der Hub ist öffentlich, braucht kein Token und sendet nur: Es gibt keine Methoden, die ein Client aufrufen kann.
| Hub-URL | https://btcpuzzle.info/api/hex_socket |
| Alter Host | https://api.btcpuzzle.info/hex_socket |
| Protokoll | SignalR mit dem Standard-JSON-Protokoll; WebSockets, Server-Sent Events und Long Polling werden angeboten. |
| Ereignis | PoolStatus |
| Limit | Die Negotiate-Anfrage zählt für das IP-Ratenlimit. Der Hub selbst ist nach dem Verbinden nicht begrenzt. |
Verbinden
Verwende eine SignalR-Client-Bibliothek (JavaScript: @microsoft/signalr; .NET: Microsoft.AspNetCore.SignalR.Client). Intern verhandelt sie zuerst:
Beispielanfrage
curl -X POST "https://btcpuzzle.info/api/hex_socket/negotiate?negotiateVersion=1"Beispielantwort
200 OK
{
"negotiateVersion": 1,
"connectionId": "s7dzEsrMHQKQsCHjvm2faQ",
"connectionToken": "A9SBLfct2OZrZZkvaQMLZw",
"availableTransports": [
{
"transport": "WebSockets",
"transferFormats": [
"Text",
"Binary"
]
},
{
"transport": "ServerSentEvents",
"transferFormats": [
"Text"
]
},
{
"transport": "LongPolling",
"transferFormats": [
"Text",
"Binary"
]
}
]
}import { HubConnectionBuilder } from '@microsoft/signalr';
const hub = new HubConnectionBuilder()
.withUrl('https://btcpuzzle.info/api/hex_socket')
.withAutomaticReconnect()
.build();
hub.on('PoolStatus', (event) => console.log(event));
await hub.start();PoolStatus-Ereignis
Ein Argument, ein JSON-Objekt. Das Ereignis wird an alle verbundenen Clients gesendet, wenn ein Bereich vergeben und wenn ein Bereich als gescannt markiert wird.
{
"hex": "3AX8443",
"walletAddress": "1BvBMSEY...7xJaNVN2",
"workerName": "rig1",
"puzzleCode": 71,
"status": "holded"
}| Feld | Typ | Beschreibung |
|---|---|---|
hex | string | Das Bereichs-HEX, dessen drittes Zeichen durch X ersetzt ist. |
walletAddress | string | Gekürzte Adresse des Kontos. |
workerName | string oder null | Der Worker-Name (default, wenn keiner gesendet wurde). Bei scanned ist es der mit der Markierungsanfrage gesendete Name, der null sein kann. |
puzzleCode | integer | Das Puzzle des Bereichs. |
status | string | holded, nachdem ein Bereich vergeben wurde, scanned, nachdem ein Bereich markiert wurde. Die Schreibweise ist eingefroren. |
Ereignisse werden zugestellt, solange die Verbindung offen ist; nach einer Neuverbindung wird nichts nachgeliefert. Wenn der Betreiber den Live-Feed abschaltet, werden Verbindungen abgelehnt.
Objekte
Puzzle-Objekt
Wird von den Puzzle-Listen-Endpunkten und /puzzle/{puzzleCode}/info zurückgegeben. Eigenschaften ohne Wert werden weggelassen.
| Feld | Typ | Beschreibung |
|---|---|---|
id | integer | Datenbank-ID (bei Puzzles aus dem alten System gleich code). |
name | string | Zum Beispiel Puzzle 71. |
code | integer | Die Puzzle-Nummer. |
hexStart, hexEnd | string | Erster und letzter privater Schlüssel des Puzzles, hexadezimal. |
targetWalletAddress | string | Die Adresse, die die Belohnung hält. |
hexRangeLength | integer | Länge des Bereichs-HEX, das der Pool vergibt (der Teil des Schlüssels, den er wählt). |
reward | number | Die Belohnung in BTC. |
hexStartPool, hexEndPool | string | Erstes und letztes Bereichs-HEX. Leer, wenn das Puzzle nicht im Pool ist. |
totalRanges | integer | Anzahl der Bereiche des Puzzles. 0, wenn das Puzzle nicht im Pool ist. |
percentage | number | Prozentsatz der gescannten Bereiche. |
totalScanned, rangesScannedLastHour | integer | Gescannte Bereiche insgesamt und in der letzten Stunde (in den Listen-Endpunkten befüllt). |
statisticsTotalScanned, statisticsFoundOnPool, statisticsFoundDate, statisticsFoundBy | verschieden | Endgültige Zahlen eines abgeschlossenen Puzzles; statisticsFoundBy ist nur vorhanden, wenn bekannt. |
rangeContainsKeys, rangeContainsKeyByDefault | integer | Anzahl der privaten Schlüssel (minus eins) in einem Bereich. Die beiden unterscheiden sich, wenn Bereiche mehrere IDs umfassen. |
rangesPerKey | integer | Wie viele Bereichs-IDs ein Bereich umfasst (bei den meisten Puzzles 1). |
workloadStart, workloadEnd | string | Der Teil des privaten Schlüssels, den ein Client nach dem Bereichs-HEX scannt: siehe GET range. |
customWorkloadStart, customWorkloadEnd | string | Vorhanden, wenn das Puzzle einen eigenen Workload verwendet. |
dateStart, dateEnd | date | Geplante Daten des Puzzles. |
isCompleted, isNextPuzzle, isActive, isDefault, isTestPool, isOnPool | boolean | Der Zustand des Puzzles: beendet, angekündigt, jetzt scanbar, Standard, Test-Pool, im Pool. |
isEntranceFeeActive, entranceFee | boolean, number | Ob die Teilnahmegebühr aktiv ist, und ihr Preis in USD (0, wenn aus). |
nextScanAllowedInMinutes | integer | Wie lange ein vergebener Bereich reserviert bleibt, bevor er an jemand anderen gehen kann. |
challenges | array | Die neueste Challenge oder ein leeres Array. |
privateKey, publicKey | string | Nur bei gelösten Puzzles. |
rewards, speed | array, object | Nur bei einigen Endpunkten vorhanden. |
Statistics-Objekt
| Feld | Typ | Beschreibung |
|---|---|---|
puzzle | object | Die Hauptzahlen des Puzzles (Name, Code, Bereichsanzahlen, Workload, Zustand, Belohnung). |
scannedLast24H | integer | In den letzten 24 Stunden gescannte Bereiche. |
entranceFeesPaidTotal | number | Für das Puzzle gezahlte Teilnahmegebühren, USD. |
topWorkersAlltime | array | Bis zu 50 Einträge {userId, walletAddress, totalScanned}; userId ist hier 0. |
topWorkersLast24h | array | Dasselbe für die letzten 24 Stunden. |
activeWorkers | array | {walletAddress, workerName} der Worker, die in den letzten 30 Minuten gepingt haben. |
challenges | array | Bis zu 32 Challenges. |
kingdom | object | Der König des Puzzles: walletAddress, message, image und isPublished. |
topSpeed | object | Die beste Stunde aller Zeiten: date, scanned Bereiche und keysPerSecond. |
chartData | array | Der letzte Monat nach Stunden, neueste zuerst: date, dateOnly, hoursOnly und rangesScanned. |
lastRanges | array | Die letzten 200 gescannten Bereiche, neueste zuerst: hex (maskiert), walletAddress (maskiert), startTime, endTime, pingTime, gpuModel, gpuCount, workerName, isPremiumUser, isScanned, isPinged, keysInSeconds und totalSeconds. |
rewards | array | Belohnungen des Puzzles (ohne private Schlüssel). |
dateUpdated | date | Wann die Zahlen berechnet wurden. |
currentSpeed | object | CurrentSpeed. |
CurrentSpeed-Objekt
| Feld | Typ | Beschreibung |
|---|---|---|
activeWorkerCount | integer | Worker, die in den letzten 6 Stunden gescannt und in der letzten Stunde gepingt haben. |
keysPerSecondFormatted | string | Die Geschwindigkeit mit Einheit: keys/s, Kkeys/s, Mkeys/s, Bkeys/s, Tkeys/s und so weiter. |
keysPerSecondRaw | string | Die Geschwindigkeit in Schlüsseln pro Sekunde als Ganzzahl-Text. |
Challenge-Objekt
| Feld | Typ | Beschreibung |
|---|---|---|
hex | string | Die Startzeichen, die jeder Challenge-Teilnehmer scannt. |
dateCreated | date | Wann die Challenge begann. |
puzzleId | integer | Das Puzzle. |
Reward-Objekt
| Feld | Typ | Beschreibung |
|---|---|---|
id, puzzleCode, puzzleId | integer | Identifikation. |
targetAddress | string | Die Adresse des Belohnungsschlüssels. |
rewardContent, rewardDescription, provider, providerDesc, brand | string | Was der Preis ist und wer ihn vergibt. Eigenschaften ohne Wert werden weggelassen. |
privateKey | string | Nur vorhanden, nachdem die Belohnung gelöst wurde. |
dateCreated, dateSolved | date | Wann sie erstellt und gelöst wurde (0001-01-01T00:00:00, solange ungelöst). |
Änderungen gegenüber der alten Dokumentation
Am Vertrag hat sich nichts geändert: Jeder Endpunkt, Header, jedes Feld und jeder Fehlercode der alten API funktioniert weiterhin und antwortet gleich. Diese Anleitung ersetzt die alte Seite, die drei Endpunkte beschrieb. Neu ist hier:
- Die öffentlichen Daten-Endpunkte, der Echtzeit-Feed, die Fehlercodes und die Ratenlimits sind dokumentiert. Die alte Seite erwähnte sie nicht.
- Korrekturen des alten Textes: Der Header
UserTokender Markierungsanfrage ist das Miner-Token (die alte Seite nannte es eine Wallet-Adresse); der Ping-Abstand beträgt etwa 2 Minuten und höchstens 30 Minuten, und das Limit liegt bei 360 Pings pro Minute und Token, nicht bei 60 pro Stunde; das Test-Pool-Puzzle ist38. - Die Basis-URL ist
https://btcpuzzle.info/api; der alte Hostapi.btcpuzzle.infofunktioniert weiterhin. - Der SignalR-Hub hat keine Client-zu-Server-Methode mehr, daher kann niemand gefälschte Ereignisse senden. Das Ereignis selbst hat sich nicht geändert.
- Auch der letzte freie Bereich eines Puzzles wird jetzt vergeben, und ein sehr schmales
CustomRange-Fenster wird erweitert, damit ein Bereich nicht durch gezieltes Anfragen genau eines Bereichs ausgewählt werden kann. - Die öffentlichen Statistiken zeigen die IP-Adresse eines Miners nicht mehr.