Back to Website

Articles in this section

Market History: Mark Price

This endpoint returns the most recent 100 Mark Price entries or the 1000 Mark Price entries since a specified time.

Authentication is not required.

Note: This endpoint only returns values since 27th of May, 2021. 

Endpoint

 Request Type Permissible API Keys
/api/history/v2/market/{symbol}/price GET N/A
Argument Type Required Description
symbol
 string Yes The symbol of the Futures, see Ticker Symbols
since
 positive integer No UNIX timestamp in milliseconds. Returns 1000 Mark Price entries from the specified since value
continuationToken
 string <base64> No Continuation token provided from a prior response which can be used in call to return the next set of available results
Sample Call

https://www.cryptofacilities.com/api/history/v2/market/pi_xbtusd/price 

https://www.cryptofacilities.com/api/history/v2/market/pi_ethusd/price

https://www.cryptofacilities.com/api/history/v2/market/pi_xbtusd/price?since=1622565463000 
Sample Return if Successful

{
   "elements": [
          {
              "uid": "",
              "timestamp": 1622564476188,
              "event": {
                            "MarkPriceChanged": {
                                                "price": "2573.87500000000"
                                                 }
                           }
          },
          {
              "uid": "",
              "timestamp": 1622564475143,
              "event": {
                            "MarkPriceChanged": {
                                                 "price": "2573.92500000000"
                                                  }
                           }
          },

...

                   ],
                    "len": 100,
}

Field

 Type Description
uid string Always undefined
timestamp positive integer Unix timestamp in milliseconds (UTC)
event set of structures Structures containing mark price change data
MarkPriceChanged structure Structure containing mark price data
price string <decimal> Updated Mark Price
len positive integer Length of response

 

Sample Return if Unsuccessful
{
       "reason": "Resource was not found.",
       "status": "not_found"
}

Field

 Type Description
reason
 string

Reason for error:

  • Resource was not found:  Unable to locate resource
  • The request could not be understood by the server due malformed syntax: syntax in one or more arguments is unreadable
status
 string

Status of request:

  • not_found: Unable to find requested resource
  • bad_request: Request unable to be processed due to requestor error