The first step will be to get your API Keys (for private endpoints). In order to get your API Keys, please refer to their documentation
You will need the following environment variables in your project
BITSO_API_KEY=""
BITSO_API_SECRET=""
BITSO_API_URL="https://api.bitso.com"
When working on integrations, bitso recommends that you use their dev server before running your code against production. The URL for this server is https://api-dev.bitso.com/v3/
npm install bitso-bert-api
usage
try {
const ticker = await BitsoApi.public.getTicker('btc_mxn')
const { book, last, volume, low, high } = ticker
} catch (err) {
const { code, message } = err
}Rate limits are based on one minute windows. For public API requests, the limit is by IP address and allows 60 requests per minute. For private API requests, the limit is by user and allows 300 requests per minute. If you exceed these limits, you will get locked out for one minute. Continuous one minute lockouts may result in a 24-hour block. Order cancellations aren’t subject to API rate limiting.
The API is divided in two sections: public, private and undocumented
| Available Books | ✅ | getAvailableBooks() | ||
| Ticker | ✅ | getTicker('btc_mxn') | ||
| Order Book | ✅ | getOrderBook('btc_mxn', params?) | { aggregate?: boolean } |
|
| Trades | ✅ | getTrades('btc_mxn', params?) | { marker?: string, sort?: 'asc'|'desc', limit?: number } |
| 🔒 | Account Status | ✅ | getAccountStatus() | |
| 🔒 | Document Upload | ☑️ | ||
| 🔒 | Mobile Phone Number Registration | ✅ | mobilePhone.register(phoneNumber) | |
| 🔒 | Mobile Phone Number Verification | ✅ | mobilePhone.verify(verificationCode) | |
| 🔒 | Account Balance | ✅ | getBalance() | |
| 🔒 | Fees | ✅ | getFees() | |
| 🔒 | Ledger | |||
| 🔒 | - all | ✅ | ledger.getLedger(params?) | { marker?: string, sort?: 'asc'|'desc', limit?: number } |
| 🔒 | - trades | ✅ | ledger.getTrades(params?) | { marker?: string, sort?: 'asc'|'desc', limit?: number } |
| 🔒 | - fees | ✅ | ledger.getFees(params?) | { marker?: string, sort?: 'asc'|'desc', limit?: number } |
| 🔒 | - fundings | ✅ | ledger.getFundings(params?) | { marker?: string, sort?: 'asc'|'desc', limit?: number } |
| 🔒 | - withdrawals | ✅ | ledger.getWithdrawals(params?) | { marker?: string, sort?: 'asc'|'desc', limit?: number } |
| 🔒 | Withdrawals | |||
| 🔒 | - all | ✅ | withdrawals.getAll(params?) | { marker?: string, limit?: number, status?: string, method?: string } |
| 🔒 | - by wid | ✅ | withdrawals.getByWid(wid) | |
| 🔒 | - by wids | ✅ | withdrawals.getByWids([wid1, wid2]) | |
| 🔒 | - by origin_ids | ✅ | withdrawals.getByOriginIds([originId1, originId2]) | |
| 🔒 | Fundings | |||
| 🔒 | - all | ✅ | fundings.getAll(params?) | { marker?: string, limit?: number, status?: string, method?: string, txids?: string } |
| 🔒 | - by fid | ✅ | fundings.getByFid(fid) | |
| 🔒 | - by fids | ✅ | fundings.getByFids([fid1, fid2]) | |
| 🔒 | User Trades | |||
| 🔒 | - by book | ✅ | userTrades.getByBook('btc_mxn', params?) | { marker?: string, sort?: 'asc'|'desc', limit?: number } |
| 🔒 | - by id | ✅ | userTrades.getByTid(tid) | |
| 🔒 | - by ids | ✅ | userTrades.getByTids([tid1, tid2]) | |
| 🔒 | Order Trades | |||
| 🔒 | - by oid | ✅ | orderTrades.getByOid(oid) | |
| 🔒 | - by origin id | ✅ | orderTrades.getByOriginId(originId) | |
| 🔒 | Open Orders | ✅ | getOpenOrders(params?) | { marker?: string, sort?: 'asc'|'desc', limit?: number, book?: Book } |
| 🔒 | Lookup Orders | |||
| 🔒 | - by oid | ✅ | lookupOrders.getByOid(oid) | |
| 🔒 | - by list of oids | ✅ | lookupOrders.getByOids([oid1, oid2]) | |
| 🔒 | - by list of origin_ids | ✅ | lookupOrders.getByOriginIds([originId1, originId2]) | |
| 🔒 | Cancel Order | |||
| 🔒 | - all | ✅ | cancelOrder.cancelAll() | |
| 🔒 | - by oid | ✅ | cancelOrder.cancelByOid(oid) | |
| 🔒 | - by list of oids | ✅ | cancelOrder.cancelByOids([oid1, oid2]) | |
| 🔒 | - by list of origin_ids | ✅ | cancelOrder.cancelByOrderIds([originId1, originId2]) | |
| 🔒 | Place an Order (buy, sell) | |||
| 🔒 | - market | ✅ | market(book, amount, currency) | |
| 🔒 | - limit | ✅ | limit(book, amount, currency, price, executionType?) | executionType = 'goodtillcancelled' | 'fillorkill' | 'immediateorcancel' | 'postonly' |
| 🔒 | - stopLoss | ✅ | stopLoss(book, amount, stopPrice) | |
| 🔒 | - stopLimit | ✅ | stopLimit(book, amount, currency, price, stopPrice, executionType?) | executionType = 'goodtillcancelled' | 'fillorkill' | 'immediateorcancel' | 'postonly' |
| 🔒 | Funding Destination | ✅ | getFundingDestination(currency) | |
| 🔒 | Crypto Withdrawals | ☑️ | ||
| 🔒 | SPEI Withdrawal | ☑️ | ||
| 🔒 | Bank Codes | ✅ | getBankCodes() | |
| 🔒 | Debit Card Withdrawal | ☑️ | ||
| 🔒 | Phone Number Withdrawal | ☑️ |
| Charts | ||||
| - Charting Information | ✅ | charts.getChartInfo(book, timeBucket, startDate, endDate) | ||
| - Charting Trades | ✅ | charts.getChartTrades(book, timeframe) | ||
| Catalogues | ||||
| - Available Currency Conversions | ✅ | catalogues.availableCurrencyConversions.public() | ||
| 🔒 | - Available Currency Conversions | ✅ | catalogues.availableCurrencyConversions.private() | |
| - Countries | ✅ | catalogues.getCountries() | ||
| - Currencies | ✅ | catalogues.getCurrencies() | ||
| 🔒 | Tickers | ✅ | getTickers() | |
| 🔒 | Settings | ✅ | getSettings() |
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent