Funding Offers

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'
  [
    [
      OFFER_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

Term	Type	Description
CHAN_ID	int	Identification number for the channel subscribtion. Funding events are always sent through the account information channel with CHAN_ID = 0
TYPE	string	'fos' (funding offers snapshot), 'fon' (funding offer new), 'fou' (funding offers update), 'foc' (funding offer cancel (cancelled or fully executed))
OFFER_ID	integer	Offer ID
SYMBOL	string	The currency of the offer (fUSD, etc)
MTS_CREATED	int	Millisecond Time Stamp when the offer was created
MSG_UPDATED	int	Millisecond Time Stamp when the offer was updated
AMOUNT	float	Amount the offer is for
AMOUNT_ORIG	float	Amount the offer was entered with originally
OFFER_TYPE	string	"LIMIT" or "FRRDELTAVAR"
FLAGS	object	See https://docs.bitfinex.com/v2/docs/flag-values.
STATUS	string	Offer Status: ACTIVE, EXECUTED, PARTIALLY FILLED, CANCELED
RATE	float	Rate of the offer
PERIOD	int	Period of the offer
NOTIFY	int	0 if false, 1 if true
HIDDEN	int	0 if false, 1 if true
RENEW	int	0 if false, 1 if true