PUBLIC API

1. Get Exchange Info

Return all the Information about bitspay

https://api.bitspay.global/info

Return data example:

{"name":"Bitspay","description":"Bitspay exchange is a Honest Exchange platform that provides trading services for Bitcoin, Ethereum, USDT,USDC and other main stream cryptocurrencies.","location":"London","logo":"https://www.bitspay.global/assets/images/latest_header.png","website":"https://www.bitspay.global/","version":"1.0","telegram":"https://t.me/Bitspay_Global","twitter":"Bitspay_Global","linkedin":"https://www.linkedin.com/company/bitspay/?viewAsMember=true","capability":{"markets":true,"trades":true,"tradesSocket":false,"orders":true,"ordersSocket":false,"ordersSnapshot":true,"candles":true,"tradesByTimestamp":false}}

2.Get All Vendors info in Exchange

Return all the vendor information listed bitspay

https://api.bitspay.global/assets/all

https://api.bitspay.global/getVendorInfo/

Return data example:

{"status":1,"message":"Success","result":{"BTC":{"name":"BITCOIN","ticker":"BTC","unified_cryptoasset_id":"1","lastUpdateTimestamp":"2022-12-08T09:22:52.009Z","can_withdraw":true,"can_deposit":true,"min_withdraw":0.0013,"max_withdraw":0.15,"maker_fee":0.0015,"taker_fee":0.0015},..]}

3.Get Selected Vendor info

Return info about the selected vendor listed bitspay

https://api.bitspay.global/assets/BTC

Return data example:

{"status":1,"message":"Success","unified_cryptoasset_id":"1","lastUpdateTimestamp":"2022-12-08T09:23:27.947Z","name":"BITCOIN","can_withdraw":true,"can_deposit":true,"min_withdraw":0.0013,"max_withdraw":0.15,"maker_fee":0.0015,"taker_fee":0.0015}

4.Get All Market Pairs

Return all the trading pairs supported by bitspay Market.

https://api.bitspay.global/getavailablepairs/

Return data example:

{"status":1,"message":"Success","combinations":["BNB_BTC","BSV_BTC","BUSD_BTC","ETC_BTC","ETH_BTC","LTC_BTC","TRX_BTC","TUSD_BTC","USDC_BTC","USDT_BTC","BCH_ETH","BNB_ETH","BSV_ETH","BTC_ETH","BUSD_ETH","ETC_ETH","LTC_ETH","TRX_ETH","TUSD_ETH","USD_ETH","USDC_ETH","USDT_ETH","XRP_ETH","BNB_USDT","BSV_USDT","BTC_USDT","BUSD_USDT","ETC_USDT","ETH_USDT","TRX_USDT","USDC_USDT","XRP_USDT","BCH_USDC","BNB_USDC","BSV_USDC","BTC_USDC","BUSD_USDC","ETC_USDC","ETH_USDC","LTC_USDC","TRX_USDC","TUSD_USDC","USD_USDC","USDT_USDC","XRP_USDC","BCH_BSV","BNB_BSV","BTC_BSV","BUSD_BSV","ETC_BSV","ETH_BSV","LTC_BSV","TRX_BSV","USDT_BSV","XRP_BSV","BCH_XRP","BNB_XRP","BSV_XRP","BTC_XRP","ETC_XRP","ETH_XRP","LTC_XRP","TRX_XRP","TUSD_XRP","USDT_XRP","BCH_EUR","BNB_EUR","BSV_EUR","BTC_EUR","BUSD_EUR","EOS_EUR","ETC_EUR","ETH_EUR","LTC_EUR","TRX_EUR","TUSD_EUR","USDC_EUR","USDT_EUR","XRP_EUR","BCH_USD","BNB_USD","BSV_USD","BTC_USD","BUSD_USD","ETC_USD","ETH_USD","LTC_USD","TRX_USD","TUSD_USD","USDT_USD","XRM_USD","XRP_USD","BCH_LTC","BNB_LTC","BSV_LTC","BTC_LTC","BUSD_LTC","ETC_LTC","ETH_LTC","TRX_LTC","TUSD_LTC","USDC_LTC","USDT_LTC","XRP_LTC","DSS_ETH","XRP_BTC","LTC_USDT","BCH_BTC","BCH_USDT","OMG_BTC","OMG_ETH","OMG_USDT","TUSD_USDT","ETH_BUSD","XRP_BUSD","LTC_BUSD","BCH_BUSD","USDT_BUSD","OMG_USDC","OMG_BUSD","USDC_BUSD","BSV_BUSD","BNB_BUSD","TRX_BUSD","ETC_BUSD","TUSD_BUSD","BTC_BUSD"]}

5.Get Market id's

Return all the available market references in bitspay

https://api.bitspay.global/markets/

Return data example:

{"status":1,"message":"Success","combinations":[{"id":"BNB_BTC","base":"BNB","quote":"BTC"},{"id":"BSV_BTC","base":"BSV","quote":"BTC"},{"id":"BUSD_BTC","base":"BUSD","quote":"BTC"},{"id":"ETC_BTC","base":"ETC","quote":"BTC"},{"id":"ETH_BTC","base":"ETH","quote":"BTC"},{"id":"LTC_BTC","base":"LTC","quote":"BTC"},{"id":"TRX_BTC","base":"TRX","quote":"BTC"},{"id":"TUSD_BTC","base":"TUSD","quote":"BTC"},{"id":"USDC_BTC","base":"USDC","quote":"BTC"},{"id":"USDT_BTC","base":"USDT","quote":"BTC"},{"id":"BCH_ETH","base":"BCH","quote":"ETH"},{"id":"BNB_ETH","base":"BNB","quote":"ETH"},{"id":"BSV_ETH","base":"BSV","quote":"ETH"},...]}

6. 24 Hours Market Trade Details

https://api.bitspay.global/getMarketDetails/
https://api.bitspay.global/ticker/all

Return data example:

{"status":1,"message":"Success","stage":"22","marketdetails":[{"pair":"XRP_USDT","last":"0.3863537700","lowsale":"0.3853332300","highsale":"0.3896263600","24hrhigh":"0.3896263600","name":"USDT","baseVolume":"1310852.9694317733","min_buy":"2.0000000000","min_sell":"2.0000000000","sellfee":"0.0015000000","buyfee":"0.0015000000","cmcid":"825"},{"pair":"XRP_USDC","last":"0.3862373700","lowsale":"0.3786085100","highsale":"0.3817834000","24hrhigh":"0.3817834000","name":"USDC","baseVolume":"540819.2480679972","min_buy":"2.0000000000","min_sell":"2.0000000000","sellfee":"0.0015000000","buyfee":"0.0015000000","cmcid":"3408"},{"pair":"XRP_ETH","last":"0.0003133000","lowsale":"0.0003110200","highsale":"0.0003174800","24hrhigh":"0.0003174800","name":"ETH","baseVolume":"1203.6057582536","min_buy":"0.0035000000","min_sell":"0.0035000000","sellfee":"0.0015000000","buyfee":"0.0015000000","cmcid":"1027"},{"pair":"XRP_BUSD","last":"0.3864722300","lowsale":"0.3766705100","highsale":"0.3989930400","24hrhigh":"0.3989930400","name":"BUSD","baseVolume":"672485.5544867091","min_buy":"0.0001000000","min_sell":"0.0001000000","sellfee":"0.0015000000","buyfee":"0.0015000000","cmcid":"4687"},{"pair":"XRP_BTC","last":"0.0000229400","lowsale":"0.0000227100","highsale":"0.0000231500","24hrhigh":"0.0000231500","name":"BTC","baseVolume":"106.6824359421","min_buy":"0.0001000000","min_sell":"0.0001000000","sellfee":"0.0015000000","buyfee":"0.0015000000","cmcid":"1"},...]}

7.All Market Details Information

Return complete list of trading pairs with 0 volume as well.

https://api.bitspay.global/getCompleteMarkets/

Return data example:

{"status":1,"message":"Success","stage":"22","marketdetails":[{"pair":"XRP_USDT","last":"0.3863537700","lowsale":"0.3853332300","highsale":"0.3896263600","24hrhigh":"0.3896263600","name":"USDT","baseVolume":"1310852.9694317733","min_buy":"2.0000000000","min_sell":"2.0000000000","sellfee":"0.0015000000","buyfee":"0.0015000000","cmcid":"825"},{"pair":"XRP_USDC","last":"0.3862373700","lowsale":"0.3786085100","highsale":"0.3817834000","24hrhigh":"0.3817834000","name":"USDC","baseVolume":"540819.2480679972","min_buy":"2.0000000000","min_sell":"2.0000000000","sellfee":"0.0015000000","buyfee":"0.0015000000","cmcid":"3408"},{"pair":"XRP_ETH","last":"0.0003133000","lowsale":"0.0003110200","highsale":"0.0003174800","24hrhigh":"0.0003174800","name":"ETH","baseVolume":"1203.6057582536","min_buy":"0.0035000000","min_sell":"0.0035000000","sellfee":"0.0015000000","buyfee":"0.0015000000","cmcid":"1027"},{"pair":"XRP_BUSD","last":"0.3864722300","lowsale":"0.3766705100","highsale":"0.3989930400","24hrhigh":"0.3989930400","name":"BUSD","baseVolume":"672485.5544867091","min_buy":"0.0001000000","min_sell":"0.0001000000","sellfee":"0.0015000000","buyfee":"0.0015000000","cmcid":"4687"},{"pair":"XRP_BTC","last":"0.0000229400","lowsale":"0.0000227100","highsale":"0.0000231500","24hrhigh":"0.0000231500","name":"BTC","baseVolume":"106.6824359421","min_buy":"0.0001000000","min_sell":"0.0001000000","sellfee":"0.0015000000","buyfee":"0.0015000000","cmcid":"1"},...]}

8.Seleted Market Information

Return the most recent analytics for selected pair

https://api.bitspay.global/getSelectedMarket/BTC_USDT

Return data example:

{"status":1,"message":"Success","marketdetails":[{"pair":"BTC_USDT","last":16839.75527337,"lowsale":16846.71194735,"highsale":16884.35054195,"24hrhigh":16884.35054195,"name":"USDT","baseVolume":15620668.074185936,"min_buy":2,"min_sell":2,"sellfee":0.0015,"buyfee":0.0015}]}

9.Pending Orders of Selected Combination

Return all the pending orders for selected trade pair in bitspay

https://api.bitspay.global/getOrderBook/BTC_USDT

Return data example:

{"status":1,"message":"Success","orderbook":[{"orders_id":455133390,"vendorticker":"BTC","marketticker":"USDT","ordertype":"Buy Order","coins":"0.06433651","cost":"16829.66051831"},{"orders_id":455123099,"vendorticker":"BTC","marketticker":"USDT","ordertype":"Buy Order","coins":"0.00683866","cost":"16829.05069653"},{"orders_id":455112430,"vendorticker":"BTC","marketticker":"USDT","ordertype":"Buy Order","coins":"0.00935892","cost":"16828.80741392"},{"orders_id":455129754,"vendorticker":"BTC","marketticker":"USDT","ordertype":"Buy Order","coins":"0.04675586","cost":"16828.07356060"},{"orders_id":455138729,"vendorticker":"BTC","marketticker":"USDT","ordertype":"Buy Order","coins":"0.01237118","cost":"16827.96579251"},{"orders_id":455133392,"vendorticker":"BTC","marketticker":"USDT","ordertype":"Buy Order","coins":"0.07620860","cost":"16827.37396971"},{"orders_id":455121586,"vendorticker":"BTC","marketticker":"USDT","ordertype":"Buy Order","coins":"0.02545582","cost":"16826.54968683"},{"orders_id":455127133,"vendorticker":"BTC","marketticker":"USDT","ordertype":"Buy Order","coins":"0.02216622","cost":"16826.50378233"},..]}

10.Pending Orders of Selected Combination

Return all the pending orders for selected trade pair in bitspay (JSON) separated with buy and sell

https://api.bitspay.global/orderbook/BTC_USDT

https://api.bitspay.global/depth/BTC_USDT

Return data example:

{"status":1,"message":"Success","asks":[{"price":"16830.69431438","quantity":"0.6186775808651559"},{"price":"16831.15028196","quantity":"0.059217106304654155"},{"price":"16831.76229856","quantity":"0.04595281979456142"},{"price":"16832.01259515","quantity":"0.07191837605455358"},{"price":"16833.68298009","quantity":"0.09539849431323244"},{"price":"16834.95968881","quantity":"0.08868285023168501"},{"price":"16836.35761140","quantity":"0.07737298255515218"},{"price":"16837.57792855","quantity":"0.04203435779381764"},{"price":"16838.05911164","quantity":"0.07200686729787334"},{"price":"16846.02746898","quantity":"0.0498214543461136"},{"price":"16847.83621619","quantity":"0.04765613395387859"},{"price":"16850.24968683","quantity":"0.050652878576562"},{"price":"16853.63217507","quantity":"0.3565060807327968"},{"price":"16855.14983166","quantity":"0.39630333088588815"},{"price":"16855.32401273","quantity":"0.15349160603873913"},{"price":"16855.63124622","quantity":"0.5444060644481666"},{"price":"16855.65568995","quantity":"0.164297751955095"},{"price":"16856.24018427","quantity":"0.563121418106527"},{"price":"16856.36239920","quantity":"0.15349519023083721"},{"price":"16857.25178563","quantity":"0.1625533899424141"},{"price":"16857.75741932","quantity":"0.06019144763799729"},{"price":"16858.35680939","quantity":"0.20298355488565567"},{"price":"16858.58753348","quantity":"0.4807972320394785"},{"price":"16858.60449758","quantity":"0.4617930490996407"},...]}

11.Trade history of Selected Combination

Return all the trades in bitspay for selected pair

https://api.bitspay.global/getTradeBook/BTC_USDT

Return data example:

{"status":1,"message":"Success","orderbook":[{"id":"0x1B20E67C","type":"Sell Order","amount":"0.02742432","cost":"16832.13486674","processedon":"2022-12-08T09:22:46.000Z"},{"id":"0x1B20E678","type":"Sell Order","amount":"0.05367552","cost":"16832.13515289","processedon":"2022-12-08T09:22:45.000Z"},{"id":"0x1B20E675","type":"Buy Order","amount":"0.07057028","cost":"16832.13482634","processedon":"2022-12-08T09:22:45.000Z"},...]}

12.Trade history for Selected Pairs

Return all the trades in bitspay for selected pair(JSON)

https://api.bitspay.global/trades/BTC_USDT

Return data example:

{"status":1,"message":"Success","orderbook":[{"trade_id":"0x1B20EF09","type":"buy","base_volume":"0.08570998","price":"16829.91463334","quote_volume":"16829.91463334","time":"2022-12-08T09:26:19.000Z","timestamp":1670491579000,"isBuyerMaker":false},{"trade_id":"0x1B20EE79","type":"sell","base_volume":"0.16129488","price":"16829.91509784","quote_volume":"16829.91509784","time":"2022-12-08T09:26:05.000Z","timestamp":1670491565000,"isBuyerMaker":false},{"trade_id":"0x1B20E67C","type":"sell","base_volume":"0.02742432","price":"16832.13486674","quote_volume":"16832.13486674","time":"2022-12-08T09:22:46.000Z","timestamp":1670491366000,"isBuyerMaker":false},{"trade_id":"0x1B20E678","type":"sell","base_volume":"0.05367552","price":"16832.13515289","quote_volume":"16832.13515289","time":"2022-12-08T09:22:45.000Z","timestamp":1670491365000,"isBuyerMaker":false},..]}

13.Analytics for Selected Pairs

Returns low, high, open, close with the volume based on timeslots

https://api.bitspay.global/getChartData/BTC_USDT

Return data example:

{"status":1,"message":"Success","analytics":[{"analytics_id":12182398,"x":"2022-12-08T09:25:00.000Z","high":16833.92539737,"low":16832.13448465,"open":16832.43962165,"close":16832.13486674,"volume":44906.811403214895},{"analytics_id":12182333,"x":"2022-12-08T09:20:00.000Z","high":16833.41606161,"low":16831.55872694,"open":16832.47536049,"close":16833.41606161,"volume":44796.07675132695},{"analytics_id":12182268,"x":"2022-12-08T09:15:00.000Z","high":16835.43798058,"low":16832.4753588,"open":16835.23176885,"close":16832.4753588,"volume":26986.61436998529},..]}

14. Available Pair (Coingecko)

provides a summary on cryptoasset trading pairs available on bitspay Exchange

https://api.bitspay.global/coingecko/pairs

Return data example:

{"status":1,"message":"Success","supportedcombinations":[{"ticker_id":"BNB_BTC","base":"BNB","target":"BTC"},{"ticker_id":"BSV_BTC","base":"BSV","target":"BTC"},{"ticker_id":"BUSD_BTC","base":"BUSD","target":"BTC"},{"ticker_id":"ETC_BTC","base":"ETC","target":"BTC"},{"ticker_id":"ETH_BTC","base":"ETH","target":"BTC"},{"ticker_id":"LTC_BTC","base":"LTC","target":"BTC"},{"ticker_id":"TRX_BTC","base":"TRX","target":"BTC"},{"ticker_id":"TUSD_BTC","base":"TUSD","target":"BTC"},{"ticker_id":"USDC_BTC","base":"USDC","target":"BTC"},{"ticker_id":"USDT_BTC","base":"USDT","target":"BTC"},{"ticker_id":"BCH_ETH","base":"BCH","target":"ETH"},{"ticker_id":"BNB_ETH","base":"BNB","target":"ETH"},{"ticker_id":"BSV_ETH","base":"BSV","target":"ETH"},{"ticker_id":"BTC_ETH","base":"BTC","target":"ETH"},{"ticker_id":"BUSD_ETH","base":"BUSD","target":"ETH"},.....]}

15. Market Info (Coingecko)

provides a summary on cryptoasset trading pairs available on bitspay Exchange

https://api.bitspay.global/coingecko/tickers

Return data example:

{"status":1,"message":"Success","marketdetails":[{"ticker_id":"XRP_USDT","base_currency":"XRP","target_currency":"USDT","last_price":"0.3863537700","bid":"0.3863537700","ask":"0.3863537700","high":"0.3896263600","low":"0.3853332300","target_volume":"1311812.9666458950","base_volume":"3395158.67342825560000"},{"ticker_id":"XRP_USDC","base_currency":"XRP","target_currency":"USDC","last_price":"0.3862373700","bid":"0.3862373700","ask":"0.3862373700","high":"0.3817834000","low":"0.3786085100","target_volume":"543562.4090854154","base_volume":"1407248.24608769240000"},{"ticker_id":"XRP_ETH","base_currency":"XRP","target_currency":"ETH","last_price":"0.0003133000","bid":"0.0003133000","ask":"0.0003133000","high":"0.0003174800","low":"0.0003110200","target_volume":"1204.5054291900","base_volume":"3844601.09076745300000"},..]}

16. Pending order book with depth details (Coingecko)

provides order book information with depth (depth specified/2 ) returned for a given combination.

https://api.bitspay.global/coingecko/orderbook?ticker_id=BTC_ETH&depth=100

Return data example:

{"status":1,"message":"Success","ticker_id":"BTC_ETH","timestamp":1670491745,"asks":[["13.65257185","0.07812654"],["13.65386411","0.03961905"],["13.65408001","0.07936358"],["13.65500288","0.05475211"],["13.65510431","0.04842154"],["13.65564597","0.08548741"],["13.65575707","0.06079096"],["13.65702800","0.08483468"],["13.65862560","0.04334200"],["13.65906184","0.08860055"],["13.65935455","0.04548728"],["13.66006467","0.04756621"],["13.66047598","0.03966068"],["13.66057358","0.04442377"],["13.66057577","0.06588525"],["13.66190484","0.04279283"],["13.66212368","0.08866173"],["13.66223097","0.06184932"],["13.66238491","0.53882885"],["13.66320329","0.26781026"],["13.66383202","0.05435159"],["13.66398709","0.09370965"],["13.66398959","0.09279115"],["13.66406322","0.57245629"],["13.66495501","0.09118068"],["13.66519541","0.18837906"],["13.66640125","0.58236988"],["13.66640481","0.27979907"],["13.66641250","0.37175583"],["13.66691750","0.39252622"],["13.66799922","0.33853315"],["13.66845903","0.19082925"],["13.66856988","0.48169843"],["13.66872086","0.43134294"],["13.66904016","0.25849147"],["13.66917479","0.35400161"],["13.66979961","0.20861475"],["13.67007374","0.34664690"],["13.67069908","0.42108432"],["13.67087518","0.19480088"],["13.67107851","0.39055221"],["13.67110728","0.55701529"],["13.67115338","0.11057820"],["13.67117156","0.42545191"],["13.67117605","0.55861682"],["13.67145210","0.18273137"],["13.67146158","0.37062802"],["13.67165788","0.44990451"],["13.67167914","0.12533910"],["13.67176615","0.19434433"]],"bids":[["13.65197371","0.08152163"],["13.65164283","0.07874628"],["13.65068639","0.05190231"],["13.65051826","0.06204285"],["13.65012608","0.05954142"],["13.64956882","0.05643181"],["13.64878553","0.04816107"],["13.64799725","0.08302615"],["13.64799471","0.07247614"],["13.64744573","0.07113931"],["13.64704393","0.09217167"],["13.64658815","0.04277134"],["13.64648310","0.06062031"],["13.64588316","0.04622337"],["13.64551059","0.05338445"],["13.64504952","0.06352368"],["13.64428108","0.03463767"],["13.64382444","0.08165957"],["13.64379902","0.05983919"],["13.64349117","0.05316783"],["13.64332959","0.05762826"],["13.64283498","0.45759824"],["13.64249187","0.05325546"],["13.64240004","0.06370133"],["13.64238431","0.07956905"],["13.64237612","0.09097731"],["13.64237135","0.06730786"],["13.64149022","0.05729362"],["13.64111774","0.05207037"],["13.64044604","0.10135711"],["13.64029496","0.03429189"],["13.63985514","0.08078117"],["13.63956986","0.03922432"],["13.63937386","0.04401524"],["13.63922243","0.08390843"],["13.63918778","0.09776466"],["13.63860207","0.04160718"],["13.63775953","0.05937577"],["13.63771987","0.22728375"],["13.63728957","0.38840821"],["13.63623350","0.31569486"],["13.63560285","0.43851622"],["13.63531485","0.40494657"],["13.63491482","0.03708206"],["13.63491247","0.10414330"],["13.63488426","0.31508706"],["13.63458095","0.40323645"],["13.63452981","0.39078571"],["13.63388632","0.31503954"],["13.63363580","0.51142714"]]}

17. Trade history with depth details (Coingecko)

provides order book information with depth (depth specified/2 ) returned for a given combination.

https://api.bitspay.global/coingecko/tradebook/?ticker_id=BTC_ETH&limit=100

Return data example:

{"status":1,"message":"Success","orderbook":[{"id":"0x1B20F0D7","type":"Sell Order","amount":"0.16554680","cost":"13.65236650","processedon":"2022-12-08T09:27:31.000Z"},{"id":"0x1B20F0B1","type":"Sell Order","amount":"0.30764161","cost":"13.65236513","processedon":"2022-12-08T09:27:19.000Z"},{"id":"0x1B20F020","type":"Sell Order","amount":"0.12713849","cost":"13.65236584","processedon":"2022-12-08T09:26:52.000Z"},{"id":"0x1B20EFC6","type":"Sell Order","amount":"0.60525663","cost":"13.65236552","processedon":"2022-12-08T09:26:39.000Z"},{"id":"0x1B20EEC4","type":"Sell Order","amount":"0.47105360","cost":"13.65256907","processedon":"2022-12-08T09:26:12.000Z"},{"id":"0x1B20ECA7","type":"Buy Order","amount":"0.20608235","cost":"13.65170038","processedon":"2022-12-08T09:25:31.000Z"},..]}

18. Error code

Error codes details from system

Error codes Details
0 Invalid request
1 Success
2 Invalid request
3 Invalid request
4 Too many attempts
5 Currency is not supported
6,7 Currency is not supported
8 Empty params
9 Internal error, please report to administrator
10 Invalid User