History of Changes
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) andv
(value). - Trades section:
- Addition of the fields
mo
,to
, andt
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
ands
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 arebook
andcurrency
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
andlookup_orders
services, thestatus
response object field now lists the possible valuepartially filled
instead ofpartial-fill
.
2021-07-19
- Fixed a documentation inconsistency between the REST API service and the implementation:
- In the
user_trades
service, the parameterbook
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 fieldmake_side
changed tomaker_side
. - In this same service, we upgraded the
created_at
field format from2021-06-11T09:25:05+0000
to2021-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}/
Updated 8 days ago