Funding Offers

Receive a snapshot and updates for any position events on your account.

Subscribe to the account information channel to keep track of your funding offers. The account information channel provides a snapshot and updates on the funding offers in your account. The snapshot is delivered upon subscribing and any changes to your positions will be provided as updates for as long as the channel remains open. Any authenticated connection is automatically subscribed to the account information channel.

Example code to open an authenticated connection can be found on our Authenticated Channels Page.

Funding offer events are sent with CHAN_ID = 0 and can be identified by looking at the TYPE stream field. Funding offer events will use one of the following abbreviations: 'fos' (funding offers snapshot), 'fon' (funding offer new), 'fou' (funding offers update), and 'foc' (funding offer cancel).

[
  CHAN_ID,
  TYPE,  //'fos'
  [
    [
      ID,
      SYMBOL,
      MTS_CREATED,
      MTS_UPDATED,
      AMOUNT,
      AMOUNT_ORIG,
      OFFER_TYPE,
      _PLACEHOLDER,
      _PLACEHOLDER,
      FLAGS,
      STATUS,
      _PLACEHOLDER,
      _PLACEHOLDER,
      _PLACEHOLDER,
      RATE,
      PERIOD,
      NOTIFY,
      HIDDEN,
      _PLACEHOLDER,
      RENEW,
      _PLACEHOLDER,
    ],
    ...
  ]
]
    
[0,"fos",[[41237920,"fETH",1573912039000,1573912039000,0.5,0.5,"LIMIT",null,null,0,"ACTIVE",null,null,null,0.0024,2,0,0,null,0,null]]]
[
  CHAN_ID,
  TYPE, // <'fon', 'fou', 'foc'>
  [
    ID,
    SYMBOL,
    MTS_CREATED,
    MTS_UPDATED,
    AMOUNT,
    AMOUNT_ORIG,
    TYPE,
    _PLACEHOLDER,
    _PLACEHOLDER,
    FLAGS,
    STATUS,
    _PLACEHOLDER,
    _PLACEHOLDER,
    _PLACEHOLDER,
    RATE,
    PERIOD,
    NOTIFY,
    HIDDEN,
    _PLACEHOLDER,
    RENEW,
    RATE_REAL
  ]
]

[0,"fon",[41238747,"fUST",1575026670000,1575026670000,5000,5000,"LIMIT",null,null,0,"ACTIVE",null,null,null,0.006000000000000001,30,0,0,null,0,null]]

Stream Fields

TermTypeDescription
CHAN_IDintIdentification number for the channel subscribtion. Funding events are always sent through the account information channel with CHAN_ID = 0
TYPEstring'fos' (funding offers snapshot), 'fon' (funding offer new), 'fou' (funding offers update), 'foc' (funding offer cancel (cancelled or fully executed))
IDintegerOffer ID
SYMBOLstringThe currency of the offer (fUSD, etc)
MTS_CREATEDintMillisecond Time Stamp when the offer was created
MSG_UPDATEDintMillisecond Time Stamp when the offer was updated
AMOUNTfloatAmount the offer is for
AMOUNT_ORIGfloatAmount the offer was entered with originally
OFFER_TYPEstring"LIMIT" or "FRRDELTAVAR"
FLAGSobjectSee https://docs.bitfinex.com/v2/docs/flag-values.
STATUSstringOffer Status: ACTIVE, EXECUTED, PARTIALLY FILLED, CANCELED
RATEfloatRate of the offer
PERIODintPeriod of the offer
NOTIFYint0 if false, 1 if true
HIDDENint0 if false, 1 if true
RENEWint0 if false, 1 if true