Email form Bitfinex:
Bitfinex is growing faster than ever, and we are pleased that our platform, trading engine, and APIs have remained reliable and performant during these exciting days.
However, in order to continue to be able to accommodate current demand and future scaling, the Bitfinex REST and WebSocket APIs will be upgraded on Thursday, August 31st.
You are receiving this email because it appears you might be a Bitfinex API user and we wish to alert our API users about these changes in particular, as the changes may affect automated trading applications using the APIs.
In order to continue to be able to handle spikes in platform load, we need to make adjustments to how we return historical snapshot messages when authenticating to the WebSocket APIs. Currently, the snapshots hos, hts, hfts, hfos, hfls, and hfcs are returned in the WebSocket feed after authenticating. As of August 31st, these snapshots will no longer be returned via the WebSocket feed (both V1 and V2) after August 31 and equivalent REST endpoints are available as replacements. All update messages will remain unchanged.
If your API application relies on these historical snapshots, these changes may affect your application. Please take the time to review the following and make sure to properly update your code if needed.
CHANGES EFFECTIVE IMMEDIATELY
These changes are preparations for the changes that will be made on August 31.
New restV1: /v1/orders/hist (limited to last 3 days and last 1000 results)
restV1 Authenticated historical orders query (can be called only once per minute)
https://docs.bitfinex.com/v1/reference#rest-auth-orders-historyNew restV1: /v1/offers/hist (limited to last 3 days and last 1000 results)
restV1 Authenticated historical margin funding offers (can be called only once per minute)
https://docs.bitfinex.com/v1/reference#rest-auth-offers-histNew restV1: /v1/mytrades_funding
restV1 Authenticated historical margin funding trades
https://docs.bitfinex.com/v1/reference#rest-auth-mytrades-fundingNew restV2: /v2/platform/status
Status of the platform
- Maintenance mode: trading engine pause / resync (after event 20060 is triggered)
[1] Active: normal operations (after event 20061 is triggered)
https://docs.bitfinex.com/v2/reference#rest-public-platform-statusRestV2 ERR_MAINT will be returned by all API endpoints during the maintenance period.
https://docs.bitfinex.com/v2/docs/rest-general#section-maintenanceNew restV2: /v2/auth/r/funding/credits
Active funding credits (funds used in positions)
https://docs.bitfinex.com/v2/reference#rest-auth-funding-creditsnew restV2: /v2/auth/r/funding/credits/hist
Inactive funding credits (funds used in positions)
https://docs.bitfinex.com/v2/reference#rest-auth-funding-credits-histNew restV2: /v2/auth/r/funding/loans
Active funding loans
https://docs.bitfinex.com/v2/reference#rest-auth-funding-loansnew restV2: /v2/auth/r/funding/loans/hist
Inactive funding loans
https://docs.bitfinex.com/v2/reference#rest-auth-funding-loans-histNew restV2: /v2/auth/r/funding/offers
Active funding offers
https://docs.bitfinex.com/v2/reference#rest-auth-funding-offersnew restV2: /v2/auth/r/funding/offers/hist (limited to 3 days)
Historical funding offers
https://docs.bitfinex.com/v2/reference#rest-auth-funding-offers-histnew restV2: /v2/auth/r/funding/offers/SYMBOL/hist (limited to last 3 days)
Historical funding offers by symbol
https://docs.bitfinex.com/v2/reference#rest-auth-funding-offers-histNew restV2: /v2/auth/r/funding/trades/hist (limited to last 15 days)
Historical funding trades
https://docs.bitfinex.com/v2/reference#rest-auth-funding-tradesNew restV2: /v2/auth/r/funding/trades/SYMBOL/hist (limited to last 15 days)
Historical funding trades by symbol
https://docs.bitfinex.com/v2/reference#rest-auth-funding-tradesNew restV2: /v2/auth/r/orders
Active orders
https://docs.bitfinex.com/v2/reference#rest-auth-ordersNew restV2: /v2/auth/r/orders/hist (limited to 3 days)
Historical orders
https://docs.bitfinex.com/v2/reference#rest-auth-orders-histNew restV2: /v2/auth/r/orders/SYMBOL/hist (limited to last 3 days)
Historical orders by symbol
https://docs.bitfinex.com/v2/reference#rest-auth-orders-histNew restV2: /v2/auth/r/trades/hist (limited to 7 days)
Historical trades
https://docs.bitfinex.com/v2/reference#rest-auth-trades-histNew restV2: /v2/auth/r/trades/SYMBOL/hist (limited to last 7 days)
Historical trades by symbol
https://docs.bitfinex.com/v2/reference#rest-auth-trades-histNew restV2: /v2/auth/r/movements/hist (limited to last 90 days)
Historical movements (deposits/withdrawals) history
https://docs.bitfinex.com/v2/reference#rest-auth-info-fundingNew restV2: /v2/auth/r/movements/CURRENCY/hist (limited to 90 days)
Historical movements (deposits/withdrawals) history by currency
https://docs.bitfinex.com/v2/reference#rest-auth-info-fundingWebSocket event code 20060 now means: Maintenance start
Pause trading is suggested until receiving 20061
Note that there is no change in the behaviour, this is just a more meaningful description
WebSocket event code 20061 now means: Maintenance end
CHANGES DEPLOYED on 2017-08-31
Some of these change can result in backward compatibility issues. Please make sure you will adjust your code to prevent unexpected behavior of your application.
Websocket books (v1 and v2): drop support for F2, F3 frequencies
Endpoint restV2: /v2/auth/r/offers renamed to: /v2/auth/r/funding/offers
Endpoint restV2: /v2/auth/r/funding renamed to: /v2/auth/r/info/funding
Endpoint restV2: /v2/auth/r/trading renamed to: /v2/auth/r/info/trading
Endpoint restV1 /v1/book “timestamp” field will now contain the timestamp at the moment of calculation of the book
The “timestamp” field is deprecated and will be removed in a future update
Endpoint restV1 /v1/lendbook “timestamp” field will now contain the timestamp at the moment of calculation of the book
The “timestamp” field is deprecated and will be removed in a future update
WebSocket v1 and v2 authenticated: historical snapshots hos, hts removed:
https://docs.bitfinex.com/v2/reference#ws-auth-historical-ordersOnly snapshot hos will be removed, while updates on, ou, oc will flow as usual. Historic Order Snapshot can be retrieved via REST calls:
WS V1 users: use /v1/orders/hist
WS V2 users: use /v2/auth/r/orders/hist
or /v2/auth/r/orders/SYMBOL/hist (to filter on specific pair)
https://docs.bitfinex.com/v2/reference#ws-auth-trades Only snapshot hts will be removed, while updates te, tu will flow as usual. Historic Trades Snapshot can be retrieved via REST calls:
WS V1 users: use restV1 /v1/mytrades
WS V2 users: use restV2 /v2/auth/r/trades//hist
or /v2/auth/r/trades/SYMBOL/hist (to filter on specific pair)
WebSocket v2 authenticated: historical snapshots hfts, hfos, hfls, hfcs removed:
https://docs.bitfinex.com/v2/reference#ws-auth-historical-offersOnly snapshot htos will be removed, while updates fon, fou, foc will flow as usual. Historic Funding Offers Snapshot can be retrieved via REST calls:
RestV2: /v2/auth/r/funding/offers/SYMBOL/hist
or /v2/auth/r/funding/offers/SYMBOL/hist (to filter on specific currency)
https://docs.bitfinex.com/v2/reference#ws-auth-historical-creditsOnly snapshot hfcs will be removed, while updates fcn, fcu, fcc will flow as usual. Historic Credits Snapshot can be retrieved via REST calls:
RestV2: /v2/auth/r/funding/credits/hist
or /v2/auth/r/funding/credits/SYMBOL/hist (to filter on specific currency)
https://docs.bitfinex.com/v2/reference#ws-auth-historical-loansOnly snapshot hfls will be removed, while updates fln, flu, flc will flow as usual. Historic Loans Snapshot can be retrieved via REST calls:
RestV2: /v2/auth/r/funding/hist
or /v2/auth/r/funding/loans/SYMBOL/hist (to filter on specific currency)
https://docs.bitfinex.com/v2/reference#ws-auth-funding-tradesOnly snapshot hfts will be removed, while updates fte, ftu will flow as usual. Historic Trades Snapshot can be retrieved via REST calls:
RestV2: /v2/auth/r/funding/trades/hist
or /v2/auth/r/funding/trades/SYMBOL/hist (to filter on specific currency)
These changes will work to ensure optimal API performance, with minimal latency, to the benefit of our users.
If you have any questions or comments regarding this update, please contact support using the ticket form available in the help (?) menu on the website.
With Kind Regards,
bitfinex.com
[email protected]