Liquidity Provider / Market Maker RPCs

Here are the RPCs and subscriptions that are useful for liquidity providers that are available on the State Chain.

The following RPCs are only available on chainflip-node.

WebSocket subscriptions

Example usages are using a Websocket utility such as Websocat (opens in a new tab):

`cf_subscribe_scheduled_swaps`

Subscribes to a stream of all swaps that are scheduled to be executed in the next few blocks in a given pool. Note that all Chainflip swaps get scheduled 2 State Chain blocks after the deposit that triggers it is witnessed, so there is approximately 12 seconds between a swap first appearing in the subscription and it being executed. The subscription is designed to help liquidity providers see what swaps are coming in and prepare for them.

Parameters:

base_asset: Asset
quote_asset: Asset

Returns:

A websocket notification is returned on every State Chain block, each of which is a json object containing:

block_hash: string
block_number: number
swaps: Array<ScheduledSwap>

where ScheduledSwap contains the following details of an upcoming swap as a json object:

swap_id: number
swap_request_id: number - Each swap request might be broken up into multiple chunks, each with their own swap_id.
base_asset: Asset
quote_asset: Asset
side: Side
amount: Amount - The size of the swap chunk.
source_asset: Asset (optional)
source_amount: Amount (optional)
execute_at: number
remaining_chunks: number - The number of swap chunks of the same size that are remaining for this request.
chunk_interval: number - The number of blocks between each swap chunk (a new chunk will not be scheduled until the previous one succeeds). Each block is 6 seconds.

Example

wscat -c ws://localhost:9944
>

Subscribe:

{
   "id":1,
   "jsonrpc":"2.0",
   "method":"cf_subscribe_scheduled_swaps",
   "params":{
      "base_asset":{
         "chain":"Ethereum",
         "asset":"ETH"
      },
      "quote_asset":{
         "chain":"Ethereum",
         "asset":"USDC"
      }
   }
}

Here we subscribe to all swaps involving the FLIP/USDC pool. Say users request the swaps FLIP->USDC and BTC->FLIP and their corresponding deposits have just been witnessed. The subscription returns one websocket notification on every State Chain block. Here is what a possible notification for block 84 might look like:

{
    "block_hash":"0x00d717c77802650d08267f5c2d90efcf4dccde271ea9d69359d30f3de2f3e32e",
    "block_number":84,
    "swaps": [
        {
            "swap_id":1,
            "swap_request_id":1,
            "base_asset":{
                "chain":"Ethereum",
                "asset":"FLIP"
            },
            "quote_asset":{
                "chain":"Ethereum",
                "asset":"USDC"
            },
            "side":"sell",
            "amount":"0x1ad5814560a6c1005b",
            "execute_at":85,
            "remaining_chunks":0,
            "chunk_interval":0
        },
        {
            "swap_id":2,
            "swap_request_id":2,
            "base_asset":{
                "chain":"Ethereum",
                "asset":"FLIP"
            },
            "quote_asset":{
                "chain":"Ethereum",
                "asset":"USDC"
            },
            "side":"buy",
            "amount":"0x1d540d83",
            "source_asset":{
                "chain":"Bitcoin",
                "asset":"BTC"
            },
            "source_amount":"0x4b877c",
            "execute_at":86,
            "remaining_chunks":0,
            "chunk_interval":0
        }
    ]
}

Note that the FLIP->USDC swap will be executed in the next block (85). Note also that only the second leg (USDC->FLIP) of the BTC->FLIP is returned since it is the one that involves the pool we requested. IMPORTANT: while the amount field in the first swap is the exact amount that will be executed, the amount in the second swap cannot be known precisely before the corresponding first leg (BTC->USDC) is executed, and thus we only return an approximate amount computed by simulating all scheduled swaps given the current state of the liquidity pool. All swaps with approximate amounts additionally include source_asset and source_amount fields to give liquidity providers an option to use a custom method for approximating intermediate amounts.

The notification for the next block (85) would look like the following under this example:

{
    "block_hash":"0xcd3e34680895f3f98a0fb7f74265cc0b23ed8dc89cddb0cd3e6c60700985d74e",
    "block_number":85,
    "swaps": [
        {
            "swap_id":2,
            "request_id":2,
            "base_asset":{
                "chain":"Ethereum",
                "asset":"FLIP"
            },
            "quote_asset":{
                "chain":"Ethereum",
                "asset":"USDC"
            },
            "side":"buy",
            "amount":"0x1d540d83",
            "source_asset":{
                "chain":"Bitcoin",
                "asset":"BTC"
            },
            "source_amount":"0x4b877c",
            "execute_at":86,
            "remaining_chunks":0,
            "chunk_interval":0
        }
    ]
}

Using swap_id to identify swaps, swap 1 has already been executed and is thus not present. However, swap 2 appears again as it is still scheduled for execution in the next block. In practice a swap can be expected to appear in at least two websocket notifications. Note that in the rare case of swaps failing (e.g. due to insufficient liquidity in the pool), they will be re-scheduled for the next block, and will appear again in the subscription.

`cf_subscribe_prewitness_swaps`

THIS SUBSCRIPTION IS DEPRECATED. Use cf_subscribe_scheduled_swaps instead.

Subscribes to all potential incoming swaps of a particular direction. Swaps are only executed after a certain number of block confirmations for each chain, so this RPC allows you to see swaps that are potential but not yet confirmed. This is useful for liquidity providers to see what swaps are coming in and prepare for them.

WARNING: Because these are witnessed before confirmation, they are not guaranteed to be executed at all or at that time, since blockchains can re-org.

The current number of confirmations (where 0 confirmations is just in mempool and not in a block) required for each chain are:

Mainnet (Berghain)

Chain	Confirmations
Bitcoin	3
Ethereum	7
Arbitrum	2
Polkadot	Finalisation
Solana	Finalisation

Testnet (Perseverance)

Chain	Confirmations
Bitcoin	6
Ethereum	7
Arbitrum	2
Polkadot	Finalisation
Solana	Finalisation

For Bitcoin and Ethereum we use probabilistic finality, for Polkadot and Solana we use deterministic finality.

Parameters:

base_asset: Asset
quote_asset: Asset
side: Side

Returns:

block_hash: string
block_number: number
base_asset: Asset
quote_asset: Asset
side: Side
amounts: Array<Amount>

Example

Subscribe:

{
   "jsonrpc":"2.0",
   "id":"1",
   "method":"cf_subscribe_prewitness_swaps",
   "params":{
      "base_asset":{
         "chain":"Bitcoin",
         "asset":"BTC"
      },
      "quote_asset":{
         "chain":"Ethereum",
         "asset":"USDC"
      },
      "side":"buy"
   }
}

Notification:

{
   "jsonrpc":"2.0",
   "method":"cf_subscribe_prewitness_swaps",
   "params":{
      "subscription":"KoWRLlMJ2CX1WxmY",
      "result":{
         "block_hash":"0x552e6b5daf12347375e5cea885c7398e1cbae1ad0cdbdd0a8e92c2b308c56141",
         "block_number":4074,
         "base_asset":{
            "chain":"Bitcoin",
            "asset":"BTC"
         },
         "quote_asset":{
            "chain":"Ethereum",
            "asset":"USDC"
         },
         "side":"buy",
         "amounts":[
            "0x989680"
         ]
      }
   }
}

`cf_subscribe_pool_price`

Subscribes to the current price of a pair in a particular direction. This is useful for liquidity providers to see the current price of a pool. Note {"from_asset": "BTC", "to_asset": "USDC } is not equivalent to {"from_asset": "USDC", "to_asset": "BTC"}, therefore the prices maybe different.

It returns the price at the time of beginning the subscription as the first item in the stream. Subsequent items are only returned if there is a change in the price.

Parameters:

from_asset: Asset
to_asset: Asset

Returns:

price: Price
sqrt_price: Square Root Price
tick: Tick

Example

Subscribe:

{
   "jsonrpc":"2.0",
   "id":"1",
   "method":"cf_subscribe_pool_price",
   "params":{
      "from_asset":{
         "chain":"Bitcoin",
         "asset":"BTC"
      },
      "to_asset":{
         "chain":"Ethereum",
         "asset":"USDC"
      }
   }
}

Notification:

{
    "jsonrpc": "2.0",
    "method": "cf_subscribe_pool_price",
    "params": {
        "subscription": "zynJAJ4qG4mIvBEl",
        "result": {
            "price": "0x101487bee1c17ddb45ce0badfbe6eff13",
            "sqrt_price": "0x100a4096906976f1080c4042d",
            "tick": 50
        }
    }
}

`cf_subscribe_pool_price_v2`

Subscribes to the current pool price. Note that, at the time of writing, all pools are quoted in USDC, so the quote_asset will always be USDC.

It returns an update at every block, even if there are no price changes.

Parameters:

base_asset: Asset
quote_asset: Asset

Returns:

block_hash: string
block_number: number
sell: Option<Square Root Price>
buy: Option<Square Root Price>
range_order: Square Root Price

Example

Subscribe:

{
   "jsonrpc":"2.0",
   "id":"1",
   "method":"cf_subscribe_pool_price_v2",
   "params":{
      "base_asset":{
         "chain":"Bitcoin",
         "asset":"BTC"
      },
      "quote_asset":{
         "chain":"Ethereum",
         "asset":"USDC"
      }
   }
}

Notification:

{
   "jsonrpc":"2.0",
   "method":"cf_subscribe_pool_price_v2",
   "params":{
      "subscription":"F4pKA7E8C3Br63pA",
      "result":{
         "block_hash":"0x12c3662b220472de6d839a8a73dfe6ca873835bc202e282e6d008821dca0ac25",
         "block_number":1209,
         "base_asset":{
            "chain":"Bitcoin",
            "asset":"BTC"
         },
         "quote_asset":{
            "chain":"Ethereum",
            "asset":"USDC"
         },
         "sell":"0x10b09273676d13f5d254e20a20",
         "buy":"0x10b09273676d13f5d254e20a20",
         "range_order":"0x10b09273676d13f5d254e20a20"
      }
   }
}

RPC requests

Examples are using curl.

optional last parameter

at: Block Hash as string (Optional)

This defaults to the last block if not provided, it is useful to specify this argument in case it is required to query the chain at an old state.

`cf_required_asset_ratio_for_range_order`

Returns the ratio of assets that would be required to create a range order at the specified tick range.

Parameters:

base_asset: Asset.
quote_asset: Asset.
tick_range: Range<Tick>
at: Block Hash as string (Optional)

Where Range is defined as follow:

{
    "start": "Tick",
    "end": "Tick"
}

Return:

base: Amount
quote: Amount

The ratio of these two amounts is the needed ratio for range orders over the same range given the current price, i.e. the asset composition of all range orders with the same range will match this ratio.

Example

Request:

curl -H "Content-Type: application/json" -d '
{
   "id":1,
   "jsonrpc":"2.0",
   "method":"cf_required_asset_ratio_for_range_order",
   "params":{
      "base_asset":{
         "chain":"Ethereum",
         "asset":"ETH"
      },
      "quote_asset":{
         "chain":"Ethereum",
         "asset":"USDC"
      },
      "tick_range":{
         "start":-400000,
         "end":400000
      }
   }
}' http://localhost:9944

Response:

{
   "jsonrpc":"2.0",
   "result":{
      "base":"0x48fdda050e625251db12baf14c6258c",
      "quote":"0x13979e2ae923a625b6119832"
   },
   "id":1
}

`cf_pool_info`

Returns the fees percentages LP's earn in the given pool.

Parameters:

base_asset: Asset.
quote_asset: Asset.
at: Block Hash as string (Optional)

Return:

limit_order_fee_hundredth_pips: number
range_order_fee_hundredth_pips: number
range_order_total_fees_earned: PoolPairsMap<Amount>
limit_order_total_fees_earned: PoolPairsMap<Amount>
range_total_swap_inputs: PoolPairsMap<Amount>
limit_total_swap_inputs: PoolPairsMap<Amount>

where PoolPairsMap is defined as follows:

{
    "base": "Amount",
    "quote": "Amount"
}

The fees are represented in hundredth's of a pip, i.e. 1 = 0.00001%.

Example

Request:

curl -H "Content-Type: application/json" -d '
{
   "id":1,
   "jsonrpc":"2.0",
   "method":"cf_pool_info",
   "params":{
      "base_asset":{
         "chain":"Ethereum",
         "asset":"ETH"
      },
      "quote_asset":{
         "chain":"Ethereum",
         "asset":"USDC"
      }
   }
}' http://localhost:9944

Response:

{
   "jsonrpc":"2.0",
   "result":{
      "limit_order_fee_hundredth_pips":20,
      "range_order_fee_hundredth_pips":20,
      "range_order_total_fees_earned":{
         "base":"0x92d398d746f9a",
         "quote":"0x50925"
      },
      "limit_order_total_fees_earned":{
         "base":"0x0",
         "quote":"0x0"
      },
      "range_total_swap_inputs":{
         "base":"0x70047cb8257ef2652",
         "quote":"0x3d7844834"
      },
      "limit_total_swap_inputs":{
         "base":"0x0",
         "quote":"0x0"
      }
   },
   "id":1
}

`cf_pool_depth`

Returns depth of a specified pool between two prices.

Parameters:

base_asset: Asset.
quote_asset: Asset.
tick_range: Range<Tick> Representing the range of prices over which depth will be calculated. The first number should always be less than the second.
at: Block Hash as string (Optional)

Where Range is defined as follow:

{
    "start": "Tick",
    "end": "Tick"
}

Return:

asks: UnidirectionalPoolDepth<UnidirectionalSubPoolDepth>
bids: UnidirectionalPoolDepth<UnidirectionalSubPoolDepth>

Where UnidirectionalPoolDepth is defined as follows:

{
    "limit_orders": {
        "price": "Option<Amount>",
        "depth": "Amount",
    },
    "range_orders": {
        "price": "Option<Amount>",
        "depth": "Amount"
    }
}

The Amount of each of the pool's two assets available for sale inside the given price range. The depth of limit orders and range orders are separately stated.

Example

Request:

curl -H "Content-Type: application/json" -d '
{
   "id":1,
   "jsonrpc":"2.0",
   "method":"cf_pool_depth",
   "params":{
      "base_asset":{
         "chain":"Ethereum",
         "asset":"ETH"
      },
      "quote_asset":{
         "chain":"Ethereum",
         "asset":"USDC"
      },
      "tick_range":{
         "start":0,
         "end":10000
      }
   }
}' http://localhost:9944

Response:

{
  "jsonrpc": "2.0",
  "result": {
    "base": {
      "limit_orders": { "price": null, "depth": "0x0" },
      "range_orders": {
        "price": "0x15d21b1217b76a34437fca3a9",
        "depth": "0x8c3f38916066"
      }
    },
    "pair": {
      "limit_orders": { "price": null, "depth": "0x0" },
      "range_orders": { "price": "0x15d21b1217b76a34437fca3a9", "depth": "0x0" }
    }
  },
  "id": 1
}

`cf_pool_liquidity`

Returns all the liquidity available for swaps in a particular pool.

Parameters:

base_asset Asset.
quote_asset Asset.
at: Block Hash as string (Optional)

Return:

limit_orders: AskBidMap<Array<LimitOrderLiquidity>>
range_orders: AskBidMap<Array<RangeOrderLiquidity>>

Where AskBidMap is defined as follows:

{
    "asks": [ .. ],
    "bids": [ .. ],
}

while LimitOrderLiquidity and RangeOrderLiquidity are respectively:

{
	"tick": "Tick",
	"amount": "Amount",
}

{
	"tick": "Tick",
	"liquidity": "Amount",
}

For limit orders two lists of prices (as Tick) and the amount/depth (Amount) available at those prices.

For range orders, an ordered list of pairs. The first element of the pair is a tick/price and the second is the liquidity between that tick and the next tick in the list. Forming a histogram of the liquidity in the range order pool.

Example

Request:

curl -H "Content-Type: application/json" -d '
{
   "id":1,
   "jsonrpc":"2.0",
   "method":"cf_pool_liquidity",
   "params":{
      "base_asset":{
         "chain":"Ethereum",
         "asset":"ETH"
      },
      "quote_asset":{
         "chain":"Ethereum",
         "asset":"USDC"
      }
   }
}' http://localhost:9944

Response:

{
  "jsonrpc": "2.0",
  "result": {
    "limit_orders": {
        "asks": [
            {
               "tick":"-195688",
               "amount":"0x1"
            },
            ..
            {
               "tick":"-193196",
               "amount":"0x1"
            }
        ],
        "bids": [
            {
               "tick":"-199528",
               "amount":"0x1"
            },
            ..
            {
               "tick":"-195587",
               "amount":"0x1"
            }
        ]
    },
    "range_orders": [
        {
            "tick":"-887272",
            "liquidity":"0x1edb6ec1a04b32"
        },
        ..
        {
            "tick":"887272",
            "liquidity":"0x0"
        }
    ]
  },
  "id": 1
}

`cf_pool_orders`

Returns all the orders associated with a specified account in a particular pool.

Parameters:

base_asset: Asset
quote_asset: Asset
lp: The account to return the orders of.
at: Block Hash as string (Optional)

Return:

limit_orders: AskBidMap<Array<LimitOrder>>
range_orders: Array<RangeOrder>

Where AskBidMap is defined as follows:

{
    "asks": [ .. ],
    "bids": [ .. ],
}

Where LimitOrder is defined as follows:

{
    "lp": "Account",
	"id": "Amount",
	"tick": "Tick",
	"sell_amount": "Amount",
	"fees_earned": "Amount",
	"original_sell_amount": "Amount",
}

Where RangeOrder is defined as follows:

{
    "lp": "Account",
    "id": "Amount",
    "range": "Range<Tick>",
    "liquidity": "Liquidity",
    "fees_earned": "PoolPairsMap<Amount>",
}

Example

Request:

curl -H "Content-Type: application/json" -d '
{
   "id":1,
   "jsonrpc":"2.0",
   "method":"cf_pool_orders",
   "params":{
      "base_asset":{
         "chain":"Ethereum",
         "asset":"ETH"
      },
      "quote_asset":{
         "chain":"Ethereum",
         "asset":"USDC"
      },
      "lp":"cFPdef3hF5zEwbWUG6ZaCJ3X7mTvEeAog7HxZ8QyFcCgDVGDM"
   }
}' http://localhost:9944

Response:

{
   "jsonrpc":"2.0",
   "result":{
      "limit_orders":{
         "asks":[
            {
               "lp":"cFLGvPhhrribWCx9id5kLVqwiFK4QiVNjQ6ViyaRFF2Nrgq7j",
               "id":"0x0",
               "tick":-195623,
               "sell_amount":"0x56d3a03776ce8ba0",
               "fees_earned":"0x0",
               "original_sell_amount":"0x56d3a03776ce8ba0"
            },
            ..
         ],
         "bids":[
            {
               "lp":"cFLGvPhhrribWCx9id5kLVqwiFK4QiVNjQ6ViyaRFF2Nrgq7j",
               "id":"0x0",
               "tick":-195622,
               "sell_amount":"0x4a817c800",
               "fees_earned":"0x0",
               "original_sell_amount":"0x4a817c800"
            },
            ..
         ]
      },
      "range_orders":[
         {
            "lp":"cFPdef3hF5zEwbWUG6ZaCJ3X7mTvEeAog7HxZ8QyFcCgDVGDM",
            "id":"0x0",
            "range":{
               "start":-887272,
               "end":887272
            },
            "liquidity":3161961432402363,
            "fees_earned":{
               "base":"0xd251bdbd8c558",
               "quote":"0xcd376"
            }
         }
      ]
   },
   "id":1
}

`cf_pool_orderbook`

Returns an orderbook representation of all the liquidity in the specified pool. For example if you make a request with an orders count of 1, it will return 1 ask and 1 bid that each represent the sum of all asks and bids respectively. The returned ask's and bid's prices will be approximately in an logarithm distribution going from the best price to the worst, for example it could be something like the first ask/bid represents all liquidity within 0.01% of the best price, then the next all liquidity between 0.01%->0.1% of the best price, then next between 0.1%->1.0%, and so on until there is no more liquidity.

Parameters:

base_asset: Asset
quote_asset: Asset
orders: The number of orders to return. As this is increased the returned orderbook representation will more accurately reflect the pool's liquidity distribution. This number is inclusively bounded between 1 and 16384.
at: Block Hash as string (Optional)

Return:

bids: PoolOrder
asks: PoolOrder

Where PoolOrder is defined as follows:

{
	"amount": "Amount",
	"sqrt_price": "SqrtPrice",
}

A list of asks and a list of bids. The number of asks and bids will be equal to or less than the specified number of orders. There may be zero asks or bids if no liquidity exists to either ask or bid. Each ask and bid has two properties a sqrt_price and an amount.

The amount is quoted in the base asset's smallest unit, i.e. for ETH that is 10^-18 ETH.
The sqrt_price is the sqrt of the price in units of the quote asset, represented as a fixed point number with 96 fractional bits. Note prices are in each asset's smallest unit i.e. for ETH 10^-18, and for USDC 10^-6, so the price 10000 USDC/ETH represented as sqrt_price would be round(sqrt(10000 * 10^18 / 10^6)*2^96) ≈ 7.9228162E36. We use this representation as it ensures a high degree of precision across a large range of possible prices.

Example

Request:

curl -H "Content-Type: application/json" -d '
{
   "id":1,
   "jsonrpc":"2.0",
   "method":"cf_pool_orderbook",
   "params":{
      "base_asset":{
         "chain":"Ethereum",
         "asset":"ETH"
      },
      "quote_asset":{
         "chain":"Ethereum",
         "asset":"USDC"
      },
      "orders":10
   }
}' http://localhost:9944

Response:

{
    "jsonrpc": "2.0",
    "result": {
        "asks": [
            {
                "amount": "0x54b2cec31723f8b04",
                "sqrt_price": "0x2091b342e50d7f26cdc582"
            },
            {
                "amount": "0x5b475d13fc0374e",
                "sqrt_price": "0x1e38a26ccc8cad8ff5ed7d0e"
            },
            {
                "amount": "0x625ecb4a48690",
                "sqrt_price": "0x1c0ae64c925b19f39a41ff17bd"
            },
            {
                "amount": "0x6a03445844f",
                "sqrt_price": "0x1a055f3578ef64659516605ff66d"
            },
            {
                "amount": "0x723fbd69d",
                "sqrt_price": "0x18252720d1c42e3ba5952fd2fe89fb"
            },
            {
                "amount": "0x7b20059",
                "sqrt_price": "0x16678d870594b3379bb55bece63777cb"
            },
            {
                "amount": "0x84b0d",
                "sqrt_price": "0x14ca1409cb331360845a79ebe43373e18e"
            },
            {
                "amount": "0x8ef",
                "sqrt_price": "0x134b7afbfbb5777da858f99704921055bfe0"
            },
            {
                "amount": "0x9",
                "sqrt_price": "0x12848533e1997da57a9773adec9795a3626203"
            }
        ],
        "bids": [
            {
                "amount": "0x9a488cdb615edf25fd",
                "sqrt_price": "0x62bac2a2b8f0b98b9ceb"
            },
            {
                "amount": "0x1217d98319cd00bc28de",
                "sqrt_price": "0x349e212a7a008282ff9"
            },
            {
                "amount": "0x21f2ffe1f3cc8bebab567",
                "sqrt_price": "0x1c0ae0758c0acee837"
            },
            {
                "amount": "0x3fb3690cb0511666161b4d",
                "sqrt_price": "0xef1f790088e3f323"
            },
            {
                "amount": "0x77868270bada4c06b5c9e64",
                "sqrt_price": "0x7f7094efc08a808"
            },
            {
                "amount": "0xe045b383a1b21969cebb4976",
                "sqrt_price": "0x43eaad48a59f17"
            },
            {
                "amount": "0x1a4d08d014973bf8ba1c33904f",
                "sqrt_price": "0x241d6cfa0a79c"
            },
            {
                "amount": "0x3159920b20889ed50eabfa6edc8",
                "sqrt_price": "0x123884db5748"
            }
        ]
    },
    "id": 1
}

`cf_pool_range_order_liquidity_value`

Returns the value of a hypothetical range order, e.g. the assets which would be returned to an LP's free balance if they were to close/cancel such a range order.

Parameters:

base_asset Asset.
quote_asset Asset.
tick_range: Range<Tick> Representing the start and end of the price range the order is over as ticks. The first number should always be less than the second.
liquidity: The liquidity of the range order as an amount.
at: Block Hash as string (Optional)

Return:

base: Amount
quote: Amount

The value of the hypothetical range order if it where burnt now, in amounts of the base and pair assets.

Example

Request:

curl -H "Content-Type: application/json" -d '
{
   "id":1,
   "jsonrpc":"2.0",
   "method":"cf_pool_range_order_liquidity_value",
   "params":{
      "base_asset":{
         "chain":"Ethereum",
         "asset":"ETH"
      },
      "quote_asset":{
         "chain":"Ethereum",
         "asset":"USDC"
      },
      "tick_range":[
         0,
         1000
      ],
      "liquidity":10000000000
   }
}' http://localhost:9944

Response:

{
   "jsonrpc":"2.0",
   "result":{
      "base":"0x1d116fb8",
      "quote":"0x0"
   },
   "id":1
}

`cf_asset_balances` `cf_free_balances`

Returns the free balances of all assets for a specified account. It doesn't keep into account the balance used in open positions.

Currently in order to calculate the total assets balances you need to:

call cf_asset_balances to get the free balances
call cf_pool_orders for each asset. the "sell_amount" in "asks" is the amount of base asset in the pool, the "sell_amount" in the "bids" is the amount of USDC in the pool. "original_sell_amount" is just there to see how many percent of that order have been filled, the "fees_earned" are for information purposes only and are already reflected in the free balance

Parameters:

account_id: The account_id to return the balances of.
at: Block Hash as string (Optional)

Return:

A JSON object containing the list of Chains as keys. Each chain is a JSON object containing a list of assets for that chain and their respective balances (as Amount).

Example

Request:

curl -H "Content-Type: application/json" -d '
{
   "id":1,
   "jsonrpc":"2.0",
   "method":"cf_asset_balances",
   "params":{
      "account_id":"cFPdef3hF5zEwbWUG6ZaCJ3X7mTvEeAog7HxZ8QyFcCgDVGDM"
   }
}' http://localhost:9944

Response:

{
   "jsonrpc":"2.0",
   "result":{
      "Ethereum":{
         "ETH":"0x45939e6733a79d71",
         "FLIP":"0x128d484779ed9a9b",
         "USDC":"0x45dde576d3",
         "USDT":"0x9d2687"
      },
      "Polkadot":{
         "DOT":"0x25c7d0cb6"
      },
      "Bitcoin":{
         "BTC":"0x18c12"
      },
      "Arbitrum":{
         "ETH":"0x303467cadd3773",
         "USDC":"0x9dc14c"
      }
   },
   "id":1
}

`cf_scheduled_swaps`

Returns all scheduled swaps in a pool. Works similarly to cf_subscribe_scheduled_swaps.

Parameters:

base_asset Asset.
quote_asset Asset.
at: Block Hash as string (Optional)

Return:

Array<ScheduledSwap>

Where ScheduledSwap is defined as follow:

{
	"swap_id": "number",
	"base_asset": "Asset",
	"quote_asset": "Asset",
	"side": "Side",
	"amount": "Amount",
	"source_asset": "Option<Asset>",
	"source_amount": "Option<Amount>",
	"execute_at": "number",
}

Example:

Request:

curl -H "Content-Type: application/json" -d '
{
   "id":1,
   "jsonrpc":"2.0",
   "method":"cf_scheduled_swaps",
   "params":{
      "base_asset":{
         "chain":"Ethereum",
         "asset":"FLIP"
      },
      "quote_asset":{
         "chain":"Ethereum",
         "asset":"USDC"
      }
   }
}' http://localhost:9944

Response:

{
    "jsonrpc":"2.0",
    "result":[
        {
            "swap_id":1,
            "base_asset":{
                "chain":"Ethereum",
                "asset":"FLIP"
            },
            "quote_asset":{
                "chain":"Ethereum",
                "asset":"USDC"
            },
            "side":"sell",
            "amount":"0x1ad5814560a6c1005b",
            "execute_at":170
        }
    ],
    "id":1
}

LP API Working Example

Liquidity Provider / Market Maker RPCs

WebSocket subscriptions

cf_subscribe_scheduled_swaps

Example

cf_subscribe_prewitness_swaps

Mainnet (Berghain)

Testnet (Perseverance)

Example

cf_subscribe_pool_price

Example

cf_subscribe_pool_price_v2

Example

RPC requests

optional last parameter

cf_required_asset_ratio_for_range_order

Example

cf_pool_info

Example

cf_pool_depth

Example

cf_pool_liquidity

Example

cf_pool_orders

Example

cf_pool_orderbook

Example

cf_pool_range_order_liquidity_value

Example

cf_asset_balances cf_free_balances

Example

cf_scheduled_swaps

Example:

`cf_subscribe_scheduled_swaps`

`cf_subscribe_prewitness_swaps`

`cf_subscribe_pool_price`

`cf_subscribe_pool_price_v2`

`cf_required_asset_ratio_for_range_order`

`cf_pool_info`

`cf_pool_depth`

`cf_pool_liquidity`

`cf_pool_orders`

`cf_pool_orderbook`

`cf_pool_range_order_liquidity_value`

`cf_asset_balances` `cf_free_balances`

`cf_scheduled_swaps`