Skip to main content
Version: mainnet (v0.71)

Get market data history​

Get market data history for a market ID between given dates

Path Parameters
    marketId string required

    Market ID to request data history for, required field.

Query Parameters
    startTimestamp int64

    Optional Unix time in nanoseconds.

    endTimestamp int64

    Optional Unix time in nanoseconds.

    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

    Newest records first, older records last, default is true.

Responses

A successful response.

Schema
    marketData object

    Page of market data history with the corresponding page information.

    edges object[]

    Page of market data items and their corresponding cursors.

    cursor string
    node object

    Data generated by a market when open.

    auctionEnd int64
    auctionStart int64
    bestBidPrice string
    bestBidVolume uint64
    bestOfferPrice string
    bestOfferVolume uint64
    bestStaticBidPrice string
    bestStaticBidVolume uint64
    bestStaticOfferPrice string
    bestStaticOfferVolume uint64
    extensionTrigger Auction triggers indicate what condition triggered an auction (if market is in auction mode)

    Possible values: [AUCTION_TRIGGER_UNSPECIFIED, AUCTION_TRIGGER_BATCH, AUCTION_TRIGGER_OPENING, AUCTION_TRIGGER_PRICE, AUCTION_TRIGGER_LIQUIDITY, AUCTION_TRIGGER_LIQUIDITY_TARGET_NOT_MET, AUCTION_TRIGGER_UNABLE_TO_DEPLOY_LP_ORDERS]

    indicativePrice string
    indicativeVolume uint64
    lastTradedPrice string
    liquidityProviderFeeShare object[]

    Equity like share of liquidity fee for each liquidity provider.

    averageEntryValuation string
    averageScore string
    equityLikeShare string
    party string
    markPrice string
    market Market ID for the data
    marketState Current state of the market

    Possible values: [STATE_UNSPECIFIED, STATE_PROPOSED, STATE_REJECTED, STATE_PENDING, STATE_CANCELLED, STATE_ACTIVE, STATE_SUSPENDED, STATE_CLOSED, STATE_TRADING_TERMINATED, STATE_SETTLED]

    marketTradingMode Trading mode the market is currently running, also referred to as 'market state'

    Possible values: [TRADING_MODE_UNSPECIFIED, TRADING_MODE_CONTINUOUS, TRADING_MODE_BATCH_AUCTION, TRADING_MODE_OPENING_AUCTION, TRADING_MODE_MONITORING_AUCTION, TRADING_MODE_NO_TRADING]

    marketValueProxy string
    midPrice string
    nextMarkToMarket int64
    openInterest uint64
    priceMonitoringBounds object[]

    One or more price monitoring bounds for the current timestamp.

    maxValidPrice string
    minValidPrice string
    referencePrice string
    trigger object

    Price monitoring trigger associated with the bounds.

    auctionExtension int64
    horizon int64
    probability string
    staticMidPrice string
    suppliedStake string
    targetStake string
    timestamp int64
    trigger Auction triggers indicate what condition triggered an auction (if market is in auction mode)

    Possible values: [AUCTION_TRIGGER_UNSPECIFIED, AUCTION_TRIGGER_BATCH, AUCTION_TRIGGER_OPENING, AUCTION_TRIGGER_PRICE, AUCTION_TRIGGER_LIQUIDITY, AUCTION_TRIGGER_LIQUIDITY_TARGET_NOT_MET, AUCTION_TRIGGER_UNABLE_TO_DEPLOY_LP_ORDERS]

    pageInfo object

    Page information that is used for fetching further pages.

    endCursor string
    hasNextPage boolean
    hasPreviousPage boolean
    startCursor string
GET /api/v2/market/data/:marketId

Request

Base URL
https://vega-mainnet-data.commodum.io
marketId — path required
startTimestamp — query
endTimestamp — query
pagination.first — query
pagination.after — query
pagination.last — query
pagination.before — query
pagination.newestFirst — query
curl / cURL
curl -L -X GET 'https://vega-mainnet-data.commodum.io/api/v2/market/data/:marketId' \
-H 'Accept: application/json'