Cryptohopper PHP SDK

Official PHP SDK for the Cryptohopper API — synchronous client, typed exceptions, auto-retry on 429, full coverage of all 18 public API domains.

Deeper docs: Getting Started · Authentication · Error Handling · Rate Limits

Requirements

• PHP 8.1+
• guzzlehttp/guzzle 7.8+ (installed as a dependency)

Install

composer require cryptohopper/sdk

Quick start

<?php

use Cryptohopper\Sdk\Client;
use Cryptohopper\Sdk\Exceptions\CryptohopperException;

$client = new Client(apiKey: getenv('CRYPTOHOPPER_TOKEN'));

try {
    $me      = $client->user->get();
    $hoppers = $client->hoppers->list();
    $ticker  = $client->exchange->ticker(exchange: 'binance', market: 'BTC/USDT');
} catch (CryptohopperException $e) {
    fwrite(STDERR, "{$e->getCode()} / {$e->getStatus()}: {$e->getMessage()}\n");
    if ($e->getCode() === 'RATE_LIMITED' && $e->getRetryAfterMs() !== null) {
        fwrite(STDERR, "Retry after {$e->getRetryAfterMs()}ms\n");
    }
}

Authentication

Every request (except endpoints explicitly marked security: [] in the OpenAPI spec) requires a bearer token, which you issue through the Cryptohopper developer dashboard.

$client = new Client(
    apiKey: 'your-40-char-oauth-token',
    appKey: 'your-oauth-client-id', // optional, sent as x-api-app-key
);

The optional appKey attaches your OAuth client_id to every request so Cryptohopper can attribute per-app rate limits.

Configuration

$client = new Client(
    apiKey:     getenv('CRYPTOHOPPER_TOKEN'),
    appKey:     getenv('CRYPTOHOPPER_APP_KEY'),
    baseUrl:    'https://api.cryptohopper.com/v1', // override for staging
    timeout:    30,                                 // per-request, seconds
    maxRetries: 3,                                  // HTTP 429 backoff
    userAgent:  'my-app/1.0',                       // appended after 'cryptohopper-sdk-php/<v>'
);

Pass maxRetries: 0 to opt out of the automatic 429 backoff.

Resources

Resource	Example call
$client->user	$client->user->get()
$client->hoppers	$client->hoppers->list()
$client->exchange	$client->exchange->ticker(exchange: 'binance', market: 'BTC/USDT')
$client->strategy	$client->strategy->list()
$client->backtest	$client->backtest->create($data)
$client->market	$client->market->signals()
$client->signals	$client->signals->chartData()
$client->arbitrage	$client->arbitrage->history()
$client->marketmaker	$client->marketmaker->get()
$client->template	$client->template->list()
$client->ai	$client->ai->availableModels()
$client->platform	$client->platform->countries()
$client->chart	$client->chart->list()
$client->subscription	$client->subscription->plans()
$client->social	$client->social->getFeed()
$client->tournaments	$client->tournaments->active()
$client->webhooks	$client->webhooks->create($data)
$client->app	$client->app->receipt($data)

Errors

Every non-2xx response (and every network/timeout failure) raises Cryptohopper\Sdk\Exceptions\CryptohopperException:

try {
    $client->hoppers->get('not-a-real-id');
} catch (CryptohopperException $e) {
    $e->getCode();          // string: 'NOT_FOUND', 'UNAUTHORIZED', 'RATE_LIMITED', ...
    $e->getStatus();        // int: HTTP status (0 on network error)
    $e->getServerCode();    // int|null: Cryptohopper numeric code when present
    $e->getIpAddress();     // string|null: server-reported caller IP, if any
    $e->getRetryAfterMs();  // int|null: parsed Retry-After (only on 429)
}

Error codes are stable across every official Cryptohopper SDK (Node, Python, Go, Ruby, Rust, PHP).

Rate limits

On HTTP 429 the client sleeps for Retry-After seconds (or an exponential-backoff fallback) and retries up to maxRetries times. The final failure — whether retries were exhausted or maxRetries was zero — surfaces as CryptohopperException with code = RATE_LIMITED and retryAfterMs populated.

Versioning

Semantic versioning. While on 0.x, minor releases can ship breaking changes — we call them out in CHANGELOG.md. See the versioning policy for the full SDK-wide policy.

Official SDKs and CLI

Language	Install	Repository
Node.js / TypeScript	npm i @cryptohopper/sdk	cryptohopper-node-sdk
Python	pip install cryptohopper	cryptohopper-python-sdk
Go	go get github.com/cryptohopper/cryptohopper-go-sdk	cryptohopper-go-sdk
Ruby	gem install cryptohopper --pre	cryptohopper-ruby-sdk
Rust	cargo add cryptohopper	cryptohopper-rust-sdk
PHP	composer require cryptohopper/sdk	cryptohopper-php-sdk
CLI	npm i -g @cryptohopper/cli or binaries	cryptohopper-cli

License

MIT — see LICENSE.