History of Changes

2024-12-16

In the article 03 Validation Errors, added the following error message:

0379: Insufficient balance

2024-12-05

In the article 02 Authentication Errors, added the following error message:

0216: Your account has been restricted; please get in touch with your contact at Bitso
Users with a PTS line might get this message, and their contact is a member of the Market Maker support team.

2024-10-07

Added the article Understand Bitso's Auth Mechanism.

2024-10-04

The endpoint Update an Order was released.

2024-09-26

In the article 07 Account Errors, added the following error messages:

0729: Error saving external bank account
0730: Invalid external bank account
0731: Error getting external bank account list
0732: Error getting external bank account

2024-09-18

The method GET /api/v4/currency_conversions/{conversion_id}\ added a fourth possible state: queued.

2024-09-04

In the article Trades Channel, the table explaining the returned payload had the t entry incorrectly labeled as Maker side. It was changed to Trader side. The t stands for trader.

2024-04-11

In the article 02 Authentication Errors, added error code 0215: Incorrect request signature.

2023-05-09

In the article 02 Authentication Errors, added error code 0214: Invalid reCAPTCHA.

2023-04-10

In the article 03 Validation Errors, added the following error messages:

0377: Order matched, but trade records still being processed
0378: Order has not been matched yet

2023-04-10

Added the following information to the documentation of the WebSocket API to align with the code:

In the General article, the section Fields Included in Messages.
In the Trades Channel, Orders Channel, and Diff-Orders Channel articles, the field sent to the example message.

2023-04-05

In the endpoint balance, the following updates were made to align with the code:

Added the next fields to the response-body table and sample response:

pending_deposit
pending_withdrawal

Updated the endpoint's URL so that it points to sandbox.

2023-03-29

Added the following information to the documentation of the Websocket API to align with the code:

Trades section:

Addition of the field x to the table.
Modification of the server messages payload to show field added.

Diff-Orders section:

Addition of the field z to the table.
Modification of the server messages payload of cancelled orders to show field added.

2023-03-16

In the endpoint open_orders, the following updates were made to align with the code:

Added the next fields to the response-body table and sample response:

origin_id
time_in_force

Added the query parameter source.
Updated the endpoint's URL so that it points to sandbox.

2023-03-16

In the endpoint order_trades, the following updates were made to align with the code:

Added the next fields to the response-body table and sample response:

minor_currency
major_currency

Changed the type of the tid field from long to string.
Updated the endpoint's URL so that it points to sandbox.

2023-03-16

In the endpoint /fees/, the following updates were made to align with the code:

Added the next fields to the response-body table and sample response:

volume_currency
current_volume
next_volume
next_maker_fee_percent
next_taker_fee_percent
nextVolume
nextFee
nextTakerFee
deposit_fees

Updated the endpoint's URL so that it points to sandbox.

2023-03-14

Updated the URL of the endpoint /orders/ so that it points to sandbox.

2023-03-14

In the endpoint user_trades, the following updates were made to align with the code:

Added the next fields to the response-body table and sample response:

minor_currency
major_currency

Changed the type of the tid field from long to string.
Updated the endpoint's URL so that it points to sandbox.

2023-03-10

In the endpoint available_books, the following changes were made to align with the code:

Added the next fields to the response-body table and sample response:

default_chart
fees
tick_size

Updated the endpoint's URL so that it points to sandbox.

2023-03-10

In the endpoint /ticker/ the following changes were made to align with the code:

Added the next fields to the response-body table and sample response:

change_24
rolling_average_change

Updated the endpoint's URL so that it points to sandbox.

2023-03-10

Added the documentation of the /currency_conversions/ endpoint, responsible for requesting and executing quotes:

POST /api/v3/currency_conversions: Request a conversion quote
PUT /api/v3/currency_conversions/{quoteId}: Execute a conversion quote
GET /api/v3/currency_conversions/{quoteId}: Retrieve the details of a conversion quote

2023-03-03

Added the following information to the documentation of the Websocket API to align with the code:

General section:

Was: Remove it, in which case it does not have an a field (amount).
Changed to: Cancel it, in which case it does not have the fields a (amount) and v (value).

Trades section:

Addition of the fields mo, to, and t to the payload of the server messages.

Diff-Orders section:

Addition of the field s to the table.
Modification of the server messages payload of open orders to show field added.
Addition of a sample payload for cancelled orders.

Orders section:

Addition of the fields o and s to the table.
Modification of the server messages payload to show fields added.

2023-03-02

The article Diff-Orders Channel incorrectly documented the t field as follows:

0 indicates sell
1 indicates buy

The code has it the other way around. Docs were aligned with the code.

2022-08-18

Added a new error code, '0506'.
Added documentation for the new withdrawal endpoints.
Added documentation for the new withdrawal methods endpoints.
Deprecated the Crypto withdrawal endpoints.
Deprecated the SPEI withdrawal endpoints.

2022-03-10

Added new error codes, '0414' - '0417'.

2022-01-18

Added new error codes to indicate when trading or conversions are disabled on your account.

2021-11-24

Fixed a documentation inconsistency between the REST API service and the implementation:

In the open_orders service, the request parameters were wrong; presently, the parameters are book and currency as defined in the service implementation.

2021-09-27

Updated the URL in General > Developer Testing Server to point to the newly configured sandbox environment.

2021-07-27

Fixed a documentation inconsistency between the REST API service and the implementation:

In the open_orders and lookup_orders services, the status response object field now lists the possible value partially filled instead of partial-fill.

2021-07-19

Fixed a documentation inconsistency between the REST API service and the implementation:

In the user_trades service, the parameter book changed to non-required.

2021-06-25

An inconsistency existed in the documentation of the Diff-Orders and Orders channels. It described the t field as number 0 for selling and 1 for buying, but the correct implementation is the opposite. To make the documentation consistent with the implementation, we updated the field to number 0 for buying and 1 for selling. This update was for documentation only; nothing changed on the consumer side.

2021-06-24

Fixed documentation inconsistencies between the REST API service and the implementation:

In the order_trades service, the response object field make_side changed to maker_side.
In this same service, we upgraded the created_at field format from 2021-06-11T09:25:05+0000 to 2021-06-11T09:25:05.000+00:00.

2020-08-21

Deleted some old API errors from v2 and migrated to v3 errors in some cases:

20 to 0301: Unknown Order book, if book is not valid
22 to 0408: Incorrect amount value, it must be a non-zero positive value
0410 is documented now: Trading not enabled
0411 is documented now: Trading not enabled for market orders
22 to 0302: Incorrect time frame (not ‘hour’ or 'minute’), when the time_in_force parameter is not valid
22 to 0407: Invalid precision, when price parameter is not present
22 to 0407: Invalid precision, when tick_size is not valid
20 to 0201: Invalid Nonce or Invalid Credentials when user_id isn't present

2020-06-10

Added the ability to query a withdrawal by its origin ID:

GET /v3/withdrawals?origin_ids={origin_id},{origin_id},{origin_id}

2020-06-09

Deprecated the endpoint /v3/{api_method}/client_id/{client_id}:

GET /v3/order_trades/client_id/{client_id}
GET /v3/orders/client_id/{client_id}-{client_id}-{client_id}/
DELETE /v3/orders/client_id/{client_id}-{client_id}-{client_id}/