Coinbase Wallet PHP Library
, (*1)
This is the official client library for the Coinbase Wallet API v2. We
provide an intuitive, stable interface to integrate Coinbase Wallet into your
PHP project., (*2)
Important: As this library is targeted for newer API v2, it requires v2
permissions (i.e. wallet:accounts:read). If you're still using v1, please use
the older version of this library., (*3)
Installation
Install the library using Composer. Please read the Composer Documentation if you are unfamiliar with Composer or dependency managers in general., (*4)
"require": {
"coinbase/coinbase": "~2.0"
}
Authentication
API Key
Use an API key and secret to access your own Coinbase account., (*5)
use Coinbase\Wallet\Client;
use Coinbase\Wallet\Configuration;
$configuration = Configuration::apiKey($apiKey, $apiSecret);
$client = Client::create($configuration);
OAuth2
Use OAuth2 authentication to access a user's account other than your own. This
library does not handle the handshake process, and assumes you have an access
token when it's initialized. You can handle the handshake process using an
[OAuth2 client][5] such as [league/oauth2-client][6]., (*6)
use Coinbase\Wallet\Client;
use Coinbase\Wallet\Configuration;
// with a refresh token
$configuration = Configuration::oauth($accessToken, $refreshToken);
// without a refresh token
$configuration = Configuration::oauth($accessToken);
$client = Client::create($configuration);
Two factor authentication
The send money endpoint requires a 2FA token in certain situations (read more
here). A specific exception is thrown when this is required., (*7)
use Coinbase\Wallet\Enum\Param;
use Coinbase\Wallet\Exception\TwoFactorRequiredException;
use Coinbase\Wallet\Resource\Transaction;
$transaction = Transaction::send([
'toEmail' => 'test@test.com',
'bitcoinAmount' => 1
]);
$account = $client->getPrimaryAccount();
try {
$client->createAccountTransaction($account, $transaction);
} catch (TwoFactorRequiredException $e) {
// show 2FA dialog to user and collect 2FA token
// retry call with token
$client->createAccountTransaction($account, $transaction, [
Param::TWO_FACTOR_TOKEN => '123456',
]);
}
Several endpoints are paginated. By default, the library will only fetch
the first page of data for a given request. You can easily load more than just
the first page of results., (*8)
$transactions = $client->getAccountTransactions($account);
while ($transactions->hasNextPage()) {
$client->loadNextTransactions($transactions);
}
You can also use the fetch_all parameter to have the library issue all the
necessary requests to load the complete collection., (*9)
use Coinbase\Wallet\Enum\Param;
$transactions = $client->getAccountTransactions($account, [
Param::FETCH_ALL => true,
]);
Warnings
It's prudent to be conscious of warnings. The library will log all warnings to a
standard PSR-3 logger if one is configured., (*10)
use Coinbase\Wallet\Client;
use Coinbase\Wallet\Configuration;
$configuration = Configuration::apiKey($apiKey, $apiSecret);
$configuration->setLogger($logger);
$client = Client::create($configuration);
Resource references
In some cases the API will return resource references in place of expanded
resource objects. These references can be expanded by refreshing them., (*11)
$deposit = $this->client->getAccountDeposit($account, $depositId);
$transaction = $deposit->getTransaction();
if (!$transaction->isExpanded()) {
$this->client->refreshTransaction($transaction);
}
You can also request that the API return an expanded resource in the initial
request by using the expand parameter., (*12)
use Coinbase\Wallet\Enum\Param;
$deposit = $this->client->getAccountDeposit($account, $depositId, [
Param::EXPAND = ['transaction'],
]);
Resource references can be used when creating new resources, avoiding the
overhead of requesting a resource from the API., (*13)
use Coinbase\Wallet\Resource\Deposit;
use Coinbase\Wallet\Resource\PaymentMethod;
$deposit = new Deposit([
'paymentMethod' => PaymentMethod::reference($paymentMethodId)
]);
// or use the convenience method
$deposit = new Deposit([
'paymentMethodId' => $paymentMethodId
]);
Responses
There are multiple ways to access raw response data. First, each resource
object has a getRawData() method which you can use to access any field that
are not mapped to the object properties., (*14)
$data = $deposit->getRawData();
Raw data from the last HTTP response is also available on the client object., (*15)
$data = $client->decodeLastResponse();
Active record methods
The library includes support for active record methods on resource objects. You
must enable this functionality when bootstrapping your application., (*16)
$client->enableActiveRecord();
Once enabled, you can call active record methods on resource objects., (*17)
use Coinbase\Wallet\Enum\Param;
$transactions = $account->getTransactions([
Param::FETCH_ALL => true,
]);
Usage
This is not intended to provide complete documentation of the API. For more
detail, please refer to the
official documentation., (*18)
List supported native currencies, (*19)
$currencies = $client->getCurrencies();
List exchange rates, (*20)
$rates = $client->getExchangeRates();
Buy price, (*21)
$buyPrice = $client->getBuyPrice('BTC-USD');
Sell price, (*22)
$sellPrice = $client->getSellPrice('BTC-USD');
Spot price, (*23)
$spotPrice = $client->getSpotPrice('BTC-USD');
Current server time, (*24)
$time = $client->getTime();
Get authorization info, (*25)
$auth = $client->getCurrentAuthorization();
Lookup user info, (*26)
$user = $client->getUser($userId);
Get current user, (*27)
$user = $client->getCurrentUser();
Update current user, (*28)
$user->setName('New Name');
$client->updateCurrentUser($user);
List all accounts, (*29)
$accounts = $client->getAccounts();
List account details, (*30)
$account = $client->getAccount($accountId);
List primary account details, (*31)
$account = $client->getPrimaryAccount();
Set account as primary, (*32)
$client->setPrimaryAccount($account);
Create a new bitcoin account, (*33)
use Coinbase\Wallet\Resource\Account;
$account = new Account([
'name' => 'New Account'
]);
$client->createAccount($account);
Update an account, (*34)
$account->setName('New Account Name');
$client->updateAccount($account):
Delete an account, (*35)
$client->deleteAccount($account);
List receive addresses for account, (*36)
$addresses = $client->getAccountAddresses($account);
Get receive address info, (*37)
$address = $client->getAccountAddress($account, $addressId);
List transactions for address, (*38)
$transactions = $client->getAddressTransactions($address);
Create a new receive address, (*39)
use Coinbase\Wallet\Resource\Address;
$address = new Address([
'name' => 'New Address'
]);
$client->createAccountAddress($account, $address);
List transactions, (*40)
$transactions = $client->getAccountTransactions($account);
Get transaction info, (*41)
$transaction = $client->getAccountTransaction($account, $transactionId);
Send funds, (*42)
use Coinbase\Wallet\Enum\CurrencyCode;
use Coinbase\Wallet\Resource\Transaction;
use Coinbase\Wallet\Value\Money;
$transaction = Transaction::send([
'toBitcoinAddress' => 'ADDRESS',
'amount' => new Money(5, CurrencyCode::USD),
'description' => 'Your first bitcoin!',
'fee' => '0.0001' // only required for transactions under BTC0.0001
]);
try { $client->createAccountTransaction($account, $transaction); }
catch(Exception $e) {
echo $e->getMessage();
}
Transfer funds to a new account, (*43)
use Coinbase\Wallet\Resource\Transaction;
use Coinbase\Wallet\Resource\Account;
$fromAccount = Account::reference($accountId);
$toAccount = new Account([
'name' => 'New Account'
]);
$client->createAccount($toAccount);
$transaction = Transaction::transfer([
'to' => $toAccount,
'bitcoinAmount' => 1,
'description' => 'Your first bitcoin!'
]);
$client->createAccountTransaction($fromAccount, $transaction);
Request funds, (*44)
use Coinbase\Wallet\Enum\CurrencyCode;
use Coinbase\Wallet\Resource\Transaction;
use Coinbase\Wallet\Value\Money;
$transaction = Transaction::request([
'amount' => new Money(8, CurrencyCode::USD),
'description' => 'Burrito'
]);
$client->createAccountTransaction($transaction);
Resend request, (*45)
$account->resendTransaction($transaction);
Cancel request, (*46)
$account->cancelTransaction($transaction);
Fulfill request, (*47)
$account->completeTransaction($transaction);
List buys, (*48)
$buys = $client->getAccountBuys($account);
Get buy info, (*49)
$buy = $client->getAccountBuy($account, $buyId);
Buy bitcoins, (*50)
use Coinbase\Wallet\Resource\Buy;
$buy = new Buy([
'bitcoinAmount' => 1
]);
$client->createAccountBuy($account, $buy);
Commit a buy, (*51)
You only need to do this if you pass commit=false when you create the buy., (*52)
use Coinbase\Wallet\Enum\Param;
$client->createAccountBuy($account, $buy, [Param::COMMIT => false]);
$client->commitBuy($buy);
List sells, (*53)
$sells = $client->getSells($account);
Get sell info, (*54)
$sell = $client->getAccountSell($account, $sellId);
Sell bitcoins, (*55)
use Coinbase\Wallet\Resource\Sell;
$sell = new Sell([
'bitcoinAmount' => 1
]);
$client->createAccountSell($account, $sell);
Commit a sell, (*56)
You only need to do this if you pass commit=false when you create the sell., (*57)
use Coinbase\Wallet\Enum\Param;
$client->createAccountSell($account, $sell, [Param::COMMIT => false]);
$client->commitSell($sell);
List deposits, (*58)
$deposits = $client->getAccountDeposits($account);
Get deposit info, (*59)
$deposit = $client->getAccountDeposit($account, $depositId);
Deposit funds, (*60)
use Coinbase\Wallet\Enum\CurrencyCode;
use Coinbase\Wallet\Resource\Deposit;
use Coinbase\Wallet\Value\Money;
$deposit = new Deposit([
'amount' => new Money(10, CurrencyCode::USD)
]);
$client->createAccountDeposit($account, $deposit);
Commit a deposit, (*61)
You only need to do this if you pass commit=false when you create the deposit., (*62)
use Coinbase\Wallet\Enum\Param;
$client->createAccountDeposit($account, $deposit, [Param::COMMIT => false]);
$client->commitDeposit($deposit);
List withdrawals, (*63)
$withdrawals = $client->getAccountWithdrawals($account);
Get withdrawal, (*64)
$withdrawal = $client->getAccountWithdrawal($account, $withdrawalId);
Withdraw funds, (*65)
use Coinbase\Wallet\Enum\CurrencyCode;
use Coinbase\Wallet\Resource\Withdrawal;
use Coinbase\Wallet\Value\Money;
$withdrawal = new Withdrawal([
'amount' => new Money(10, CurrencyCode::USD)
]);
$client->createAccountWithdrawal($account, $withdrawal);
Commit a withdrawal, (*66)
You only need to do this if you pass commit=true when you call the withdrawal method., (*67)
use Coinbase\Wallet\Enum\Param;
$client->createAccountWithdrawal($account, $withdrawal, [Param::COMMIT => false]);
$client->commitWithdrawal($withdrawal);
List payment methods, (*68)
$paymentMethods = $client->getPaymentMethods();
Get payment method, (*69)
$paymentMethod = $client->getPaymentMethod($paymentMethodId);
Get merchant
$merchant = $client->getMerchant($merchantId);
List orders
$orders = $client->getOrders();
Get order
$order = $client->getOrder($orderId);
Create order
use Coinbase\Wallet\Resource\Order;
use Coinbase\Wallet\Value\Money;
$order = new Order([
'name' => 'Order #1234',
'amount' => Money::btc(1)
]);
$client->createOrder($order);
Refund order
use Coinbase\Wallet\Enum\CurrencyCode;
$client->refundOrder($order, CurrencyCode::BTC);
Checkouts
List checkouts
$checkouts = $client->getCheckouts();
Create checkout
use Coinbase\Wallet\Resource\Checkout;
$params = array(
'name' => 'My Order',
'amount' => new Money(100, 'USD'),
'metadata' => array( 'order_id' => $custom_order_id )
);
$checkout = new Checkout($params);
$client->createCheckout($checkout);
$code = $checkout->getEmbedCode();
$redirect_url = "https://www.coinbase.com/checkouts/$code";
Get checkout
$checkout = $client->getCheckout($checkoutId);
Get checkout's orders
$orders = $client->getCheckoutOrders($checkout);
Create order for checkout
$order = $client->createNewCheckoutOrder($checkout);
$raw_body = file_get_contents('php://input');
$signature = $_SERVER['HTTP_CB_SIGNATURE'];
$authenticity = $client->verifyCallback($raw_body, $signature); // boolean
Contributing and testing
The test suite is built using PHPUnit. Run the suite of unit tests by running
the phpunit command., (*70)
phpunit
There is also a collection of integration tests that issues real requests to the
API and inspects the resulting objects. To run these tests, you must copy
phpunit.xml.dist to phpunit.xml, provide values for the CB_API_KEY and
CB_API_SECRET variables, and specify the integration group when running the
test suite., (*71)
phpunit --group integration
Wallogit.com
