LocalBitcoins.com PHP Client

This is a (work-in-progress) client for the LocalBitcoins.com API:, _(*1)

https://localbitcoins.com/api-docs/, _(*2)

TODO

API methods:, _(*3)

[x] Authentication
[x] AccountInfo
[x] Myself
[x] Escrows
[x] EscrowRelease
[ ] Ads
[ ] AdUpdate

Other stuff:, _(*4)

[ ] Custom errors
[ ] AccountInfo

Installing

Install with composer:, _(*5)

git clone https://github.com/lox/localbtc-php.git
composer install

Authenticating

The API uses OAuth2, so it's somewhat annoying to authenticate to for console apps. First you need to register an application and generate a client ID and client secret in the API console:, _(*6)

https://localbitcoins.com/accounts/api/, _(*7)

Then use these commands to generate a access_token:, _(*8)

export LOCALBITCOINS_CLIENT_ID=1234567
export LOCALBITCOINS_CLIENT_SECRET=123456

php oauth.php --authorize

Click the link generated, grant the application access in your localbitcoins.com account., _(*9)

Copy the access_token from the output for the below example., _(*10)

Usage

<?php

$client = \LocalBtc\Client::factory(array(
    'client_identifier' => '1234567',
    'access_token' => 'generated access token goes here',
));

// get data about yourself
$myself = $client->myself()->get('data');

// get data about someone
$someone = $client->accountInfo(array('username'=>'someone'))->get('data');

// get your escrows
$escrows = $client->escrows()->get('data');

// release an escrow
$client->releaseEscrow(array('escrow_id'=>123456));