Endpoint API

Tutti i tuoi richieste API devono essere effettuate al seguente endpoint API:

https://api.cryptohopper.com/v1/

Metodi di Richiesta Supportati

Parametri della richiesta

Ci sono quattro tipi di parametri che utilizziamo nella nostra API: percorso, stringa di query, header e parametri del corpo della richiesta. I parametri del corpo della richiesta sono dati pubblicati nel corpo della richiesta JSON per le richieste POST e PATCH. I parametri header sono ovviamente parametri che devono essere pubblicati nell'header. Maggiori informazioni sui parametri Header, Percorso e Stringa di query sono disponibili qui sotto.

Parametri Header

Ogni richiesta al nostro API deve essere autenticata inviando i seguenti valori nell'header:

• access-token - Il tuo token di accesso ricevuto con l'autenticazione Oauth2

Parametri di percorso

Questi sono i parametri forniti nell'URI dell'endpoint. Ad esempio, l'endpoint GET Hopper:

https://api.cryptohopper.com/v1/hopper/{hopper_id}

Per recuperare un bot di trading tramite il suo ID univoco, devi sostituire il valore del suo ID nel placeholder {hopper_id}. Ad esempio, per recuperare un bot di trading con ID 37, richiedi il seguente URL:

https://api.cryptohopper.com/v1/hopper/37

Alcuni endpoint richiedono più parametri. Ad esempio, se desideri restituire un ordine specifico dal Hopper precedente, devi chiamare il seguente URL:

https://api.cryptohopper.com/v1//hopper/{hopperId}/order/{orderId}

E sostituendo i parametri con l'ID Hopper e l'ID Ordine otterrai:

https://api.cryptohopper.com/v1//hopper/37/order/231

Per un elenco dettagliato dei parametri richiesti in ogni endpoint API, consulta la nostra guida di riferimento API.

Parametri Query String

Utilizziamo questi tipi di parametri nelle richieste GET per filtrare e/o pagina,re i dati. Questi parametri non sono specificati nel percorso, ma come un insieme di valori separati dal carattere ‘&’ nella stringa dell'URL.

Ad esempio, per recuperare gli ordini di acquisto Bitcoin di un bot di trading, puoi chiamare l'endpoint Hopper Order così:

https://api.cryptohopper.com/v1/hopper/37/order/?order_type=buy&coin=btc
        

Guardando la nostra referenza API, puoi vedere che, in questo caso, il parametro order_type può assumere i valori ‘buy’ o ‘sell’, e il parametro coin può essere qualsiasi codice di criptovaluta in minuscolo.

Formato Risposta

Tutti i riscontri sono in formato oggetto JSON. Quindi, il tipo MIME che trovi in ​​tutte le nostre risposte sarà application/json. Consulta la nostra documentazione di riferimento API per il formato JSON specifico del corpo di ogni richiesta e risposta.

Codici di risposta HTTP

Utilizziamo i codici di stato di risposta definiti dagli standard RFC 2616 e RFC 6585..

Codici di Errore HTTP

Messaggi di errore

Ogni volta che l'API restituisce un codice di errore, allegherà un oggetto JSON con la descrizione dell'errore nel suo corpo. Un messaggio di errore potrebbe avere questo aspetto:

{
            "status": 400,
            "error": 1,
            "message": "Missing required request parameters: [access_token]"
        }
        

Limiti di Tariffazione

La nostra API ha un limite di richiesta per distribuire equamente le risorse di banda a tutti gli utenti. I limiti attuali sono 2 richieste al secondo per utente, tranne per le ordinazioni di acquisto. In quel caso, il massimo numero di ordini di acquisto che possono essere piazzati è uno ogni 8 secondi.

Se superi il numero di richieste al secondo disponibili, riceverai un codice di risposta errore 429. Controlla l'intestazione Retry-After allegata alla risposta, che contiene il numero di secondi che devi attendere prima di poter effettuare un'altra richiesta.