Bitfinex.php

<?php 

/**
* Bitfinex PHP API
*
* Access all features of https://www.bitfinex.com trading platform
*
* @package  Bitfinex
* @author   Mario Dian (http://mariodian.com)
* @license  https://creativecommons.org/publicdomain/zero/1.0/ CC0 1.0 Universal
* @version  0.1.2
* @link     https://github.com/mariodian/bitfinex-api-php
*/

class Bitfinex {
    const CONNECT_TIMEOUT = 60;
    const API_URL = 'https://api.bitfinex.com';

    private $api_key = '';
    private $api_secret = '';
    private $api_version = '';

    /**
    * @param string $api_key       Your API key obtained from https://www.bitfinex.com/account/api
    * @param string $api_secret    Your API secret obtained from https://www.bitfinex.com/account/api
    * @param string $api_version   Bitfinex API version
    */
    public function __construct($api_key, $api_secret, $api_version = 'v1') {
        $this->api_key = $api_key;
        $this->api_secret = $api_secret;
        $this->api_version = $api_version;
    }

    /**
    * Public endpoints
    * =================================================================
    */

    /**
    * Get Book
    *
    * Get the full order book.
    *
    * @param string $symbol    The name of the symbol (see `/symbols`).
    * @param int $limit_bids   Limit the number of bids returned. May be 0 
    *                          in which case the array of bids is empty.
    * @param int $limit_asks   Limit the number of asks returned. May be 0 
    *                          in which case the array of asks is empty.
    * @param int $group        If 1, orders are grouped by price in the 
    *                          orderbook. If 0, orders are not grouped and 
    *                          sorted individually
    * @return mixed
    */
    public function get_book($symbol = 'BTCUSD', $data = array()) {
    	$request = $this->endpoint('book', $symbol);
    	
    	return $this->send_public_request($request, $data);
    }

    /**
    * Get Lendbook
    *
    * Get the full margin funding book.
    *
    * @param string $currency      USD/BTC/LTC/ETH
    * @param int $limit_bids       Limit the number of funding bids returned. 
    *                              May be 0 in which case the array of bids is
    *                              empty.
    * @param int $limit_asks       Limit the number of funding offers returned. 
    *                              May be 0 in which case the array of asks is 
    *                              empty.
    * @return mixed
    */
    public function get_lendbook($currency = 'USD', $data = array()) {
    	$request = $this->endpoint('lendbook', $currency);
    	
    	return $this->send_public_request($request, $data);
    }	

    /**
    * Get Lends
    *
    * Get a list of the most recent funding data for the given currency: total 
    * amount provided and Flash Return Rate (in % by 365 days) over time.
    *
    * @param string $currency      USD/BTC/LTC/ETH
    * @param time $timestamp       Only show data at or after this timestamp.
    * @param int $limit_lends      Limit the amount of funding data returned. 
    *                              Must be >= 1
    * @return mixed
    */
    public function get_lends($currency = 'USD', $data = array()) {
    	$request = $this->endpoint('lends', $currency);
    	
    	return $this->send_public_request($request, $data);
    }

    /**
    * Get Stats
    *
    * Various statistics about the requested pair.
    *
    * @param string $symbol    The name of the symbol (see `/symbols`).
    * @return mixed
    */
    public function get_stats($symbol = 'BTCUSD') {
    	$request = $this->endpoint('stats', $symbol);
    	
    	return $this->send_public_request($request);
    }

    /**
    * Get Symbols
    *
    * Get a list of valid symbol IDs.
    *
    * @return mixed
    */
    public function get_symbols() {
    	$request = $this->endpoint('symbols');
    	
    	return $this->send_public_request($request);
    }

    /**
    * Get Symbols Details
    *
    * Get a list of valid symbol IDs and the pair details.
    *
    * @return mixed
    */
    public function get_symbols_details() {
    	$request = $this->endpoint('symbols_details');
    	
    	return $this->send_public_request($request);
    }

    /**
    * Get Ticker
    *
    * Gives innermost bid and asks and information on the most recent trade, as 
    * well as high, low and volume of the last 24 hours.
    *
    * @param string $symbol    The name of the symbol (see `/symbols`).
    * @return mixed
    */
    public function get_ticker($symbol = 'BTCUSD') {
    	$request = $this->endpoint('pubticker', $symbol);
    	
    	return $this->send_public_request($request);
    }

    /**
    * Get Trades
    *
    * Get a list of the most recent trades for the given symbol.
    *
    * @param string $symbol        The name of the symbol (see `/symbols`).
    * @param time $timestamp       Only show trades at or after this timestamp.
    * @param int $limit_trades     Limit the number of trades returned. Must 
    *                              be >= 1.
    * @return mixed
    */
    public function get_trades($symbol = 'BTCUSD', $data = array()) {
    	$request = $this->endpoint('trades', $symbol);
    	
    	return $this->send_public_request($request, $data);
    }

    /**
    * Authenticated endpoints
    * =================================================================
    */

    /**
    * Get Account Infos
    *
    * Return information about your account (trading fees).
    *
    * @return mixed
    */
    public function get_account_infos() {
    	$request = $this->endpoint('account_infos');
    	
    	$data = array(
            'request' => $request
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Get Summary
    *
    * Returns a 30-day summary of your trading volume and return on margin 
    * funding
    *
    * @return mixed
    */
    public function get_summary() {
    	$request = $this->endpoint('summary');
    	
    	$data = array(
            'request' => $request
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * New Deposit
    *
    * Return your deposit address to make a new deposit.
    *
    * @param string $method        Method of deposit (methods accepted: 
    *                              “bitcoin”, “litecoin”, “ethereum”, 
    *                              “mastercoin” (tethers)).
    * @param string $wallet_name   Wallet to deposit in (accepted: “trading”, 
    *                              “exchange”, “deposit”). Your wallet needs to 
    *                              already exist
    * @param int $renew            (optional) Default is 0. If set to 1, will 
    *                              return a new unused deposit address
    * @return mixed
    */
    public function new_deposit($method, $wallet_name, $renew = 0) {
    	$request = $this->endpoint('deposit', 'new');
    	
    	$data = array(
            'request'       => $request,
            'method'        => $method,
            'wallet_name'   => $wallet_name,
            'renew'         => $renew
    	);

    	return $this->send_auth_request($data);
    }

    /**
    * New Order
    *
    * Submit a new order.
    *
    * @param string $symbol         The name of the symbol (see `/symbols`).
    * @param decimal $amount        Order size: how much to buy or sell.
    * @param price $price           Price to buy or sell at. Must be positive. 
    *                               Use random number for market orders.
    * @param string $exchange       “bitfinex”
    * @param string $side           Either “buy” or “sell”.
    * @param string $type           Either “market” / “limit” / “stop” / 
    *                               “trailing-stop” / “fill-or-kill” / 
    *                               “exchange market” / “exchange limit” / 
    *                               “exchange stop” / “exchange trailing-stop” / 
    *                               “exchange fill-or-kill”. 
    *                               (type starting by “exchange ” are exchange 
    *                               orders, others are margin trading orders)
    * @param bool $is_hidden        true if the order should be hidden. Default 
    *                               is false.
    * @param bool $is_postonly      true if the order should be post only. 
    *                               Default is false. Only relevant for limit 
    *                               orders.
    * @param bool $ocoorder         Set an additional STOP OCO order that will 
    *                               be linked with the current order.
    * @param price $buy_price_oco   If ocoorder is true, this field represent 
    *                               the price of the OCO stop order to place
    * @return mixed
    */
    public function new_order($symbol, $amount, $price, $exchange, $side, $type, $is_hidden = FALSE, $is_postonly = FALSE, $ocoorder = FALSE, $buy_price_oco = NULL) {
    	$request = $this->endpoint('order', 'new');

    	$data = array(
            'request'       => $request,
            'symbol'        => $symbol,
            'amount'        => $amount,
            'price'         => $price,
            'exchange'      => $exchange,
            'side'          => $side,
            'type'          => $type,
            'is_hidden'     => $is_hidden,
            'is_postonly'   => $is_postonly,
            'ocoorder'      => $ocoorder
    	);
    	
        if ($ocoorder) {
            $data['buy_price_oco'] = $buy_price_oco;
        }

    	return $this->send_auth_request($data);
    }

    /**
    * New Multi Order
    *
    * Submit several new orders at once.
    *
    * @param string $symbol     The name of the symbol (see `/symbols`).
    * @param decimal $amount    Order size: how much to buy or sell.
    * @param price $price       Price to buy or sell at. May omit if a market 
    *                           order.
    * @param string $exchange   “bitfinex”, “bitstamp”, “all” (for no routing).
    * @param string $side       Either “buy” or “sell”.
    * @param string $type       Either “market” / “limit” / “stop” / 
    *                           “trailing-stop” / “fill-or-kill”.
    * @return mixed
    */
    public function new_multi_order($symbol, $amount, $price, $exchange, $side, $type) {	
    	$request = $this->endpoint('order', 'new/multi');
    	
    	$data = array(
            'request'   => $request,
            'symbol'    => $symbol,
            'amount'    => $amount,
            'price'     => $price,
            'exchange'  => $exchange,
            'side'      => $side,
            'type'      => $type
    	);

    	return $this->send_auth_request($data);
    }

    /**
    * Cancel Order
    *
    * Cancel an order.
    *
    * @param int $order_id  The order ID given by `/order/new`.
    * @return mixed
    */
    public function cancel_order($order_id) {
    	$request = $this->endpoint('order', 'cancel');
    	
    	$data = array(
            'request'   => $request,
            'order_id'  => $order_id
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Cancel Multi Orders
    *
    * Cancel multiples orders at once.
    *
    * @param array $order_ids   An array of the order IDs given by `/order/new` 
    *                           or `/order/new/multi`
    * @return mixed
    */
    public function cancel_multi_orders($order_ids) {
    	$request = $this->endpoint('order', 'cancel/multi');
    	
    	$data = array(
            'request'   => $request,
            'order_ids' => $order_ids
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Cancel All Orders
    *
    * Cancel multiples orders at once.
    *
    * @return mixed
    */
    public function cancel_all_orders() {
    	$request = $this->endpoint('order', 'cancel/all');
    	
    	$data = array(
            'request' => $request
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Replace Order
    *
    * Replace an orders with a new one.
    *
    * @param int $order_id          The order ID (to be replaced) given by 
    *                               `/order/new`.
    * @param string $symbol         The name of the symbol (see `/symbols`).
    * @param decimal $amount        Order size: how much to buy or sell.
    * @param price $price           Price to buy or sell at. May omit if a 
    *                               market order.
    * @param string $exchange       “bitfinex”, “bitstamp”, “all” (for no 
    *                               routing).
    * @param string $side           Either “buy” or “sell”.
    * @param string $type           Either “market” / “limit” / “stop” / 
    *                               “trailing-stop” / “fill-or-kill” / 
    *                               “exchange market” / “exchange limit” / 
    *                               “exchange stop” / “exchange trailing-stop” / 
    *                               “exchange fill-or-kill”. (type starting by 
    *                               “exchange ” are exchange orders, others are 
    *                               margin trading orders)
    * @param bool $is_hidden        true if the order should be hidden. Default 
    *                               is false.
    * @param bool $use_remaining    True if the new order should use the 
    *                               remaining amount of the original order. 
    *                               Default is false
    * @return mixed
    */
    public function replace_order($order_id, $symbol, $amount, $price, $exchange, $side, $type, $is_hidden = FALSE, $use_remaining = FALSE) {	
    	$request = $this->endpoint('order', 'cancel/replace');
    	
    	$data = array(
            'request'       => $request,
            'order_id'      => $order_id,
            'symbol'        => $symbol,
            'amount'        => $amount,
            'price'         => $price,
            'exchange'      => $exchange,
            'side'          => $side,
            'type'          => $type,
            'is_hidden'     => $is_hidden,
            'use_remaining' => $use_remaining
    	);

    	return $this->send_auth_request($data);
    }

    /**
    * Get Order
    *
    * Get the status of an order. Is it active? Was it cancelled? To what extent 
    * has it been executed? etc.
    *
    * @param int $order_id      The order ID given by `/order/new`.
    * @return mixed
    */
    public function get_order($order_id) {
    	$request = $this->endpoint('order', 'status');
    	
    	$data = array(
            'request'   => $request,
            'order_id'  => $order_id
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Get Orders
    *
    * View your active orders.
    *
    * @return mixed
    */
    public function get_orders() {
    	$request = $this->endpoint('orders');
    	
    	$data = array(
            'request' => $request
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Get Positions
    *
    * View your active positions.
    *
    * @return mixed
    */
    public function get_positions() {
    	$request = $this->endpoint('positions');
    	
    	$data = array(
            'request' => $request
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Claim Position
    *
    * A position can be claimed if:
    *
    * It is a long position: The amount in the last unit of the position pair 
    * that you have in your trading wallet AND/OR the realized profit of the 
    * position is greater or equal to the purchase amount of the position (base 
    * price * position amount) and the funds which need to be returned. For 
    * example, for a long BTCUSD position, you can claim the position if the 
    * amount of USD you have in the trading wallet is greater than the base 
    * price * the position amount and the funds used.
    *
    * It is a short position: The amount in the first unit of the position pair 
    * that you have in your trading wallet is greater or equal to the amount of 
    * the position and the margin funding used.
    *
    * @param int $position_id       The position ID given by `/positions`.
    * @param decimal $amount        The partial amount you wish to claim
    * @return mixed
    */
    public function claim_position($position_id, $amount) {
    	$request = $this->endpoint('position', 'claim');
    	
    	$data = array(
            'request'       => $request,
            'position_id'   => $position_id,
            'amount'        => $amount
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Get History
    *
    * View all of your balance ledger entries.
    *
    * @param string $currency   USD/BTC/LTC/ETH
    * @param int $limit         Optional. Limit the number of entries to return. 
    *                           Default is 500.
    * @param string $wallet     Optional. Return only entries that took place in 
    *                           this wallet. Accepted inputs are: “trading”, 
    *                           “exchange”, “deposit”.
    * @param time $since        Optional. Return only the history after this 
    *                           timestamp.
    * @param time $until        Optional. Return only the history before this 
    *                           timestamp.
    * @return mixed
    */
    public function get_history($currency, $wallet, $limit = 500, $since = NULL, $until = NULL) {
    	$request = $this->endpoint('history');
    	
    	$data = array(
            'request'   => $request,
            'currency'  => $currency,
            'wallet'    => $wallet,
            'limit'     => $limit
    	);
    	
    	if ($since) {
            $data['since'] = $since;
    	}
    	
    	if ($until) {
            $data['until'] = $until;
    	}
    		
    	return $this->send_auth_request($data);
    }

    /**
    * Get History Movements
    *
    * View your past deposits/withdrawals.
    *
    * @param string $currency   USD/BTC/LTC/ETH
    * @param string $method     Optional. The method of the deposit/withdrawal 
    *                           (can be “bitcoin”, “litecoin”, “darkcoin”, 
    *                           “wire”).
    * @param int $limit         Optional. Limit the number of entries to return. 
    *                           Default is 500.
    * @param time $since        Optional. Return only the history after this 
    *                           timestamp.
    * @param time $until        Optional. Return only the history before this 
    *                           timestamp.
    * @return mixed
    */
    public function get_history_movements($currency = 'USD', $method = 'bitcoin', $limit = 500, $since = NULL, $until = NULL) {
    	$request = $this->endpoint('history', 'movements');
    	
    	$data = array(
            'request'   => $request,
            'currency'  => $currency,
            'method'    => $method,
            'limit'     => $limit
    	);
    	
    	if ($since) {
    		$data['since'] = $since;
    	}
    	
    	if ($until) {
    		$data['until'] = $until;
    	}
    		
    	return $this->send_auth_request($data);
    }

    /**
    * Get My Trades
    *
    * View your past trades.
    *
    * @param string $symbol         The name of the symbol (see `/symbols`).
    * @param int $limit_trades      Optional. Limit the number of trades
    *                               returned. Default is 50.
    * @param time $timestamp        Trades made before this timestamp won’t be
    *                               returned.
    * @param time $until            Optional. Trades made after this timestamp
    *                               won’t be returned.
    * @param int $reverse           Optional. Return trades in reverse order
    *                               (the oldest comes first). Default is
    *                               returning newest trades first.
    * @return mixed
    */
    public function get_my_trades($symbol = 'BTCUSD', $limit_trades = 50, $timestamp = NULL, $until = NULL, $reverse = 0) {
    	$request = $this->endpoint('mytrades');

    	$data = array(
            'request'       => $request,
            'symbol'        => $symbol,
            'limit_trades'  => $limit_trades,
            'reverse'       => $reverse
    	);
        
        if ($timestamp) {
            $data['timestamp'] = $timestamp;
    	}

    	if ($until) {
    		$data['until'] = $until;
    	}

    	return $this->send_auth_request($data);
    }

    /**
    * New Offer
    *
    * Submit a new offer.
    *
    * @param string $currency       USD/BTC/LTC/ETH
    * @param price $amount          Offer size: how much to lend or borrow.
    * @param decimal $rate          Rate to lend or borrow at. In percentage per 
    *                               365 days. (Set to 0 for FRR).
    * @param int $period            Number of days of the funding contract (in days)
    * @param string $direction      Either “lend” or “loan”.
    * @return mixed
    */
    public function new_offer($currency = 'BTC', $amount, $rate, $period, $direction = 'lend') {
    	$request = $this->endpoint('offer', 'new');
    	
    	$data = array(
            'request'   => $request,
            'currency'  => $currency,
            'amount'    => $amount,
            'rate'      => $rate,
            'period'    => $period,
            'direction' => $direction
    	);

    	return $this->send_auth_request($data);
    }

    /**
    * Cancel Offer
    *
    * Cancel an offer.
    *
    * @param int $offer_id      The offer ID given by `/offer/new`.
    * @return mixed
    */
    public function cancel_offer($offer_id) {
    	$request = $this->endpoint('offer', 'cancel');
    	
    	$data = array(
            'request'   => $request,
            'offer_id'  => $offer_id
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Get Offer
    *
    * Get the status of an offer. Is it active? Was it cancelled? To what extent
    * has it been executed? etc.
    *
    * @param int $offer_id      The offer ID given by `/offer/new`.
    * @return mixed
    */
    public function get_offer($offer_id) {
    	$request = $this->endpoint('offer', 'status');
    	
    	$data = array(
            'request'   => $request,
            'offer_id'  => $offer_id
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Get Credits
    *
    * View your funds currently taken (active credits).
    *
    * @return mixed
    */
    public function get_credits() {
    	$request = $this->endpoint('credits');

    	$data = array(
            'request' => $request
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Get Offers
    *
    * View your active offers.
    *
    * @return mixed
    */
    public function get_offers() {
    	$request = $this->endpoint('offers');
    	
    	$data = array(
            'request' => $request
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Get Taken Funds
    *
    * View your funding currently borrowed and used in a margin position.
    *
    * @return mixed
    */
    public function get_taken_funds() {
    	$request = $this->endpoint('taken_funds');
    	
    	$data = array(
            'request' => $request
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Get Unused Taken Funds
    *
    * View your funding currently borrowed and not used (available for a new 
    * margin position).
    *
    * @return mixed
    */
    public function get_unused_taken_funds() {
    	$request = $this->endpoint('unused_taken_funds');
    	
    	$data = array(
            'request' => $request
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Get Total Taken Funds
    *
    * View the total of your active funding used in your position(s).
    *
    * @return mixed
    */
    public function get_total_taken_funds() {
    	$request = $this->endpoint('total_taken_funds');
    	
    	$data = array(
            'request' => $request
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Close Funding
    *
    * Allow you to close an unused or used taken fund.
    *
    * @param int $swap_id       The ID given by `/taken_funds` or 
    *                           `/unused_taken_funds`.
    * @return mixed
    */
    public function close_funding($swap_id) {
    	$request = $this->endpoint('funding', 'close');
    	
    	$data = array(
            'request' => $request,
            'swap_id' => $swap_id
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Get Balances
    *
    * See your balances.
    *
    * @return mixed
    */
    public function get_balances() {
    	$request = $this->endpoint('balances');
    	
    	$data = array(
            'request' => $request
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Get Margin Infos
    *
    * See your trading wallet information for margin trading.
    *
    * @return mixed
    */
    public function get_margin_infos() {
    	$request = $this->endpoint('margin_infos');
    	
    	$data = array(
            'request' => $request
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Transfer
    *
    * Allow you to move available balances between your wallets.
    *
    * @param string $currency       USD/BTC/LTC/ETH
    * @param price $amount          Amount to transfer.
    * @param string $walletfrom     Wallet to transfer from.
    * @param string $walletto       Wallet to transfer to.
    *
    * @return mixed
    */
    public function transfer($currency, $amount, $walletfrom, $walletto) {
    	$request = $this->endpoint('transfer');

    	$data = array(
            'request'       => $request,
            'currency'      => $currency,
            'amount'        => $amount,
            'walletfrom'    => $walletfrom,
            'walletto'      => $walletto
    	);

    	return $this->send_auth_request($data);
    }

    /**
    * Withdraw
    *
    * Submit a new order.
    *
    * @param string $withdraw_type          can be “bitcoin”, “litecoin” or 
    *                                       “ethereum” or “tether” or “wire”.
    * @param string $walletselected         The wallet to withdraw from, can be
    *                                       “trading”, “exchange”, or “deposit”.
    * @param string $amount                 Amount to withdraw.
    * @param string $address                Destination address for withdrawal.
    * @param int $expressWire               Optional. “1” to submit an express 
    *                                       wire withdrawal, “0” or omit for a 
    *                                       normal withdrawal
    * @param string $account_name           Account name
    * @param string $account_number         Account number
    * @param string $bank_name              Bank name
    * @param string $bank_address           Bank address
    * @param string $bank_city              Bank city
    * @param string $bank_country           Bank country
    * @param string $detail_payment         Optional. Message to beneficiary
    * @param string $im_bank_name           Optional. Intermediary bank name
    * @param string $im_bank_address        Optional. Intermediary bank address
    * @param string $im_bank_city           Optional. Intermediary bank city
    * @param string $im_bank_country        Optional. Intermediary bank country
    * @param string $im_bank_account        Optional. Intermediary bank account
    * @param string $im_bank_swift          Optional. Intermediary bank SWIFT
    * @return mixed
    */
    public function withdraw($withdraw_type, $walletselected, $amount, $address = '', $expressWire = 0, $bank_data = array()) {	
    	$request = $this->endpoint('withdraw');
    	
    	$data = array(
            'request'           => $request,
            'withdraw_type'     => $withdraw_type,
            'walletselected'    => $walletselected,
            'amount'            => $amount
    	);
    	
    	switch ($withdraw_type) {
            case 'bitcoin':
            case 'litecoin':
            case 'ethereum':
            case 'tether':
                $data['address'] = $address;

                break;
            case 'wire':
                $data['expressWire'] = $expressWire;

                $data['account_name']   = $bank_data['account_name'];
                $data['account_number'] = $bank_data['account_number'];
                $data['bank_name']      = $bank_data['bank_name'];
                $data['bank_address']   = $bank_data['bank_address'];
                $data['bank_city']      = $bank_data['bank_city'];
                $data['bank_country']   = $bank_data['bank_country'];
                $data['detail_payment'] = array_key_exists('detail_payment', $bank_data) ? $bank_data['detail_payment'] : '';

                $data['intermediary_bank_name']     = array_key_exists('im_bank_name', $bank_data) ? $bank_data['im_bank_name'] : '';
                $data['intermediary_bank_address']  = array_key_exists('im_bank_address', $bank_data) ? $bank_data['im_bank_address'] : '';
                $data['intermediary_bank_city']     = array_key_exists('im_bank_city', $bank_data) ? $bank_data['im_bank_city'] : '';
                $data['intermediary_bank_country']  = array_key_exists('im_bank_country', $bank_data) ? $bank_data['im_bank_country'] : '';
                $data['intermediary_bank_account']  = array_key_exists('im_bank_account', $bank_data) ? $bank_data['im_bank_account'] : '';
                $data['intermediary_bank_swift']    = array_key_exists('im_bank_swift', $bank_data) ? $bank_data['im_bank_swift'] : '';

                break;
    	}

    	return $this->send_auth_request($data);
    }

    /**
    * Get Key Info
    *
    * Check the permissions of the key being used to generate this request
    *
    * @return mixed
    */
    public function get_key_info() {
    	$request = $this->endpoint('key_info');
    	
    	$data = array(
            'request' => $request
    	);
    	
    	return $this->send_auth_request($data);
    }

    /**
    * Endpoint
    *
    * Construct an endpoint URL
    *
    * @param string $method
    * @param mixed $params
    * @return string
    */
    private function endpoint($method, $params = NULL) {
    	$parameters = '';
    	
    	if ($params !== NULL) {
            $parameters = '/';

            if (is_array($params)) {
                $parameters .= implode('/', $params);
            } else {
                $parameters .= $params;
            }
    	}
    	
    	return "/{$this->api_version}/$method$parameters";
    }

    /**
    * Prepare Header
    *
    * Add data to header for authentication purpose
    *
    * @param array $data
    * @return json
    */
    private function prepare_header($data)
    {
    	$data['nonce'] = (string) number_format(round(microtime(true) * 100000), 0, '.', '');
    	
    	$payload = base64_encode(json_encode($data));
    	$signature = hash_hmac('sha384', $payload, $this->api_secret);
    	
    	return array(
            'X-BFX-APIKEY: ' . $this->api_key,
            'X-BFX-PAYLOAD: ' . $payload,
            'X-BFX-SIGNATURE: ' . $signature
    	);
    }

    /**
    * Curl Error
    *
    * Output curl error if possible
    *
    * @param array $data
    * @return json
    */
    private function curl_error($ch) {
    	if ($errno = curl_errno($ch)) {
            $error_message = curl_strerror($errno);
            echo "cURL error ({$errno}):\n {$error_message}";

            return FALSE;
    	}
    	
    	return TRUE;
    }

    /**
    * Is Bitfinex Error
    *
    * Check whether bitfinex API returned an error message
    *
    * @param array $ch 	Curl resource
    * @return bool
    */
    private function is_bitfinex_error($ch) {
    	$http_code = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    	
    	if ($http_code !== 200) {
            return TRUE;
    	}
    	
    	return FALSE;
    }

    /**
    * Output
    *
    * Prepare API output
    *
    * @param json $result
    * @param bool $is_error
    * @return array
    */
    private function output($result, $is_error = FALSE) {
    	$out_array = json_decode($result, TRUE);
    	
    	if ($is_error) {
            $out_array['error'] = TRUE;
    	}
    	
    	return $out_array;
    }

    /**
    * Send Signed Request
    *
    * Send a signed HTTP request
    *
    * @param array $data
    * @return mixed
    */
    private function send_auth_request($data) {
    	$ch = curl_init();
    	$url = self::API_URL . $data['request'];
    	
    	$headers = $this->prepare_header($data);
    	
    	curl_setopt_array($ch, array(
            CURLOPT_URL             => $url,
            CURLOPT_POST            => TRUE,
            CURLOPT_RETURNTRANSFER  => TRUE,
            CURLOPT_HTTPHEADER      => $headers,
            CURLOPT_SSL_VERIFYPEER  => TRUE,
            CURLOPT_CONNECTTIMEOUT  => self::CONNECT_TIMEOUT, 
            CURLOPT_POSTFIELDS      => ''
    	));
    	
    	if( !$result = curl_exec($ch) )
    	{
            return $this->curl_error($ch);
    	} 
    	else
    	{
            return $this->output($result, $this->is_bitfinex_error($ch));
    	}
    }

    /**
    * Send Unsigned Request
    *
    * Send an unsigned HTTP request
    *
    * @param string $request
    * @param array $params
    * @return mixed
    */
    private function send_public_request($request, $params = NULL) {
    	$ch = curl_init();
    	$query = '';
    	
    	if (count($params)) {
            $query = '?' . http_build_query($params);
    	}
    	
    	$url = self::API_URL . $request . $query;
    	
    	curl_setopt_array($ch, array(
            CURLOPT_URL             => $url,
            CURLOPT_RETURNTRANSFER  => TRUE,
            CURLOPT_SSL_VERIFYPEER  => TRUE,
            CURLOPT_CONNECTTIMEOUT  => self::CONNECT_TIMEOUT,
    	));
    	
    	if( !$result = curl_exec($ch) )
    	{
            return $this->curl_error($ch);
    	} 
    	else
    	{			
            return $this->output($result, $this->is_bitfinex_error($ch));
    	}
    }
}

?>