Skip to main content
Version: testnet (v0.76)

List liquidity provisions

GET 
/api/v2/liquidity/provisions

DEPRECATED: When a liquidity provider amends a provision, and it's accepted by the network, the pending provision is returned by the API instead of the provision that is currently active. Use ListAllLiquidityProvisions instead.

Request​

Query Parameters

    marketId string

    Restrict liquidity provisions to those placed on the given market.

    partyId string

    Restrict liquidity provisions to those placed by the given party.

    reference string

    Restrict liquidity provisions to those with the given order reference.

    live boolean

    Whether to include live liquidity provisions. If not set, live orders will not be included.

    pagination.first int32

    Number of records to be returned that sort greater than row identified by cursor supplied in 'after'.

    pagination.after string

    If paging forwards, the cursor string for the last row of the previous page.

    pagination.last int32

    Number of records to be returned that sort less than row identified by cursor supplied in 'before'.

    pagination.before string

    If paging forwards, the cursor string for the first row of the previous page.

    pagination.newestFirst boolean

    Whether to order the results with the newest records first. If not set, the default value is true.

Responses​

A successful response.

Schema
    liquidityProvisions object

    Page of liquidity provisions data and corresponding page information.

    edges object[]

    Page of liquidity provisions data and their corresponding cursors.

  • Array [
    • cursor string

    Cursor that can be used to fetch further pages.

    node object

    Data corresponding to a liquidity provider's commitment.

    buys object[]

    Set of liquidity buy orders to meet the liquidity provision obligation.

  • Array [
    • liquidityOrder object

    Liquidity order from the original submission.

    offset string

    Offset/amount of units away for the order. This field is an unsigned integer scaled using the market's decimal places.

    proportion int64

    Relative proportion of the commitment to be allocated at a price level.

    reference Pegged reference defines which price point a pegged order is linked to - meaning the price for a pegged order is calculated from the value of the reference price point

    Possible values: [PEGGED_REFERENCE_UNSPECIFIED, PEGGED_REFERENCE_MID, PEGGED_REFERENCE_BEST_BID, PEGGED_REFERENCE_BEST_ASK]

    Default value: PEGGED_REFERENCE_UNSPECIFIED

    Pegged reference point for the order.

    orderId string

    Unique ID of the pegged order generated to fulfil this liquidity order.

  • ]
    • commitmentAmount string

    Specified as a unitless number that represents the amount of settlement asset of the market. This field is an unsigned integer scaled to the asset's decimal places.

    createdAt int64

    Timestamp in Unix nanoseconds for when the liquidity provision was created.

    fee string

    Nominated liquidity fee factor, which is an input to the calculation of taker fees on the market, as per setting fees and rewarding liquidity providers.

    id string

    Unique ID for the liquidity provision.

    marketId string

    Market ID for the liquidity provision.

    partyId string

    Unique party ID for the creator of the provision.

    reference string

    Reference shared between this liquidity provision and all its orders.

    sells object[]

    Set of liquidity sell orders to meet the liquidity provision obligation.

  • Array [
    • liquidityOrder object

    Liquidity order from the original submission.

    offset string

    Offset/amount of units away for the order. This field is an unsigned integer scaled using the market's decimal places.

    proportion int64

    Relative proportion of the commitment to be allocated at a price level.

    reference Pegged reference defines which price point a pegged order is linked to - meaning the price for a pegged order is calculated from the value of the reference price point

    Possible values: [PEGGED_REFERENCE_UNSPECIFIED, PEGGED_REFERENCE_MID, PEGGED_REFERENCE_BEST_BID, PEGGED_REFERENCE_BEST_ASK]

    Default value: PEGGED_REFERENCE_UNSPECIFIED

    Pegged reference point for the order.

    orderId string

    Unique ID of the pegged order generated to fulfil this liquidity order.

  • ]
    • status vegaLiquidityProvisionStatus

    Possible values: [STATUS_UNSPECIFIED, STATUS_ACTIVE, STATUS_STOPPED, STATUS_CANCELLED, STATUS_REJECTED, STATUS_UNDEPLOYED, STATUS_PENDING]

    Default value: STATUS_UNSPECIFIED

    Status of this liquidity provision.

    updatedAt int64

    Timestamp in Unix nanoseconds for when the liquidity provision was updated.

    version uint64

    Version of this liquidity provision.

  • ]
    • pageInfo object

    Page information that is used for fetching further pages.

    endCursor string

    End cursor.

    hasNextPage boolean

    Indicator if there is a next page.

    hasPreviousPage boolean

    Indicator if there is a previous page.

    startCursor string

    Start cursor.

Loading...