EezyBtc Server API


FLOW

  1. Get list of available fiat
  2. Get list of available coins
    1. Present Customer a dropdown of available fiat currencies that we can provide an exchange quote for. Since we do not deal with fiat currencies, these are simply orientative quotes to help customers see what the coins they are spending are approximately worth in the markets.
    2. Present customer with a second dropdown to have them choose a coin they want to use for this transaction.
    3. Present them a form for them to either set the amount they want to send or with an already predetermied amount.
  3. Get Price quote for chosen coin
  4. Submit Purchase
  5. Poll for Transaction results & confirmations


API URL
https://www.eezybtc.com/api/
REQUIRED PARAMETERS
Parameter Name Parameters Required Response
merchant_id Your Merchant Id [ Receive on signup ] yes NO RESPONSE
merchant_key Your Merchant Key [ Receive on signup ] yes NO RESPONSE
LIST OF AVAILABLE FIAT
Parameter Name Parameters Required Response
get_fiat 1 yes

Full list of fiat currencies available for orientative quotes

{"fiatlist":"[{"currcode":"AUD","currname":"Australian Dollar","currsymbol":"$"}]"}
LIST OF AVAILABLE COINS
Parameter Name Parameters Required Response
get_coins 1 yes

Full list of crypto currencies available

{"coinlist":"[{\"code\":\"ETH\",\"name\":\"Ethereum\",\"website\":\"http:\\\/\\\/www.ethereum.org\\\/\",\"btc_value\":\"0.03084855\",\"min\":\"0.00021000\",\"max\":\"0.67285274\",\"logoimg\":\"\\\/img\\\/coin_imgs\\\/eth.png\"}]"}

btc_value: value of the coin against BTC
min: minimum transaction amount accepted with this coin (quoted in BTC)
max: maximum transaction amount accepted with this coin (quoted in BTC)
logoimg: Yes, we provide an image of the logo of the coin. You are welcome to download it and show from your own server.

EXCHANGE VALUE FOR SPECIFIC COIN
Parameter Name Parameters Required Response
fiatquote
currcode
coincode
1
usd
eth
yes
yes
yes

Coin prices quoted against BTC

{"currcode":"usd","coincode":"eth","btc_value":"0.03129390","fiatquote":203.058606564}

We provide a quote as an orientative quote only. You are welcome to provide your client your own quote. We store the quote that we obtain from our sources for reference only.

PURCHASE
Parameter Name Parameters Required Response
purchase
coincode
coinamount
1
eth, btc, etc.
amount in coin
yes
yes
yes

Purchase Information

{"coincode":"dash","coinamount":"1.27","fiatcode":"aud","fiat_amount":"272.22","trans_id":1052,"destination":"1UhsWc6MQ1uwWEqK14Crv395yHXvqDnAS","sendtoaddress":"XsBEMpa3c2ukVyBLDK45LhAP9WCAKsBMNY"}

btc_value: value of the coin against BTC
min: minimum transaction amount accepted with this coin (quoted in BTC)
max: maximum transaction amount accepted with this coin (quoted in BTC)
logoimg: Yes, we provide an image of the logo of the coin. You are welcome to download it and show from your own server.

We provide a quote as an orientative quote only. You are welcome to provide your client your own quote. We store the quote that we obtain from our sources for reference only.

TRANSACTION INFO *
Parameter Name Parameters Required Response
transcheck **
trans_id
txid
trx_date
status
amount
currid
curramount
spotprice
category
coinadd
merch_trx_id
merch_uid
confirmations
user_ip
useremail
username
usernumber
startdate
enddate
1
our trans_id
blockchain txid
transaction date
status (varchar)
transaction amount
currency id
fiat amount
spotprice on transaction date
category (send/receive)
coin address sent to
your trans id
your customer's id
confirmations
your customer ip address
your customer email
your customer name
your customer phone number
startdate range
enddate range
yes
no
no
no
no
no
no
no
no
no
no
no
no
no
no
no
no
no
no
no

Transaction information returned

{"trans_id":"890","txid":"","trx_date":"2018-10-13 04:00:05","last_update":"2018-10-13 04:00:05","status":"completed","amount":"0.00029701","currid":"264","curramount":"1.85964198","spotprice":"6261.21","category":"fee","coinadd":"","merchant_key":"0","merch_trx_id":"0","merch_uid":"0","merchant_id":"1","agent_id":null,"confirmations":"0","user_ip":"000.000.000.000","useremail":null,"username":null,"usernumber":null,"assoc_trans":"889","currcode":"USD"}
trans_id: our trans_id
txid: blockchain txid
trx_date: transaction date
status: status
amount: transaction amount
currid: currency id
curramount: fiat amount
spotprice: spotprice on transaction date
category: category (send/receive)
coinadd: coin address sent to
merch_trx_id: your trans id
merch_uid: your customer's id
confirmations: confirmations
user_ip: your customer ip address
useremail: your customer email
username: your customer name
usernumber: your customer phone number
startdate: startdate range
enddate: enddate range

* This request is rate limited, you should not use this for continuous monitoring of a transaction, use 'poll' (below) instead

** Performing a call with just transcheck set to 1 will return the information for the last transaction performed by the merchant.

POLLING
Use this call to poll a transaction for realtime confirmations and or status
POLLING URL
https://www.eezybtc.com/api/poll.php
Parameter Name Parameters Required Response
merchant_id
merchant_key
trans_id
merch_uid
merch_trx_id
merchant_id
merchant_key
trans_id
merch_uid
merch_trx_id
yes
yes
yes
no
no

Information on the requested transaction

{"merchant_id":"1","trans_id":"1050","status":"failed","amount":"1.27000000","confirmations":"0"}
To Top