Maker Statistics

Retrieves historical performance data of market makers (MMs) in Vertex for a specified product, epoch, and time range.

Rate limits

• 240 requests/min or 40 requests/10secs per IP address. (weight = 10)

See more details in API Rate limits

Request

Rewards

POST [ARCHIVE_ENDPOINT]

Body

{
  "maker_statistics": {
    "product_id": 4,
    "epoch": 1,
    "interval": 1800
  }
}

Request Parameters

Parameter	Type	Required	Description
product_id	number	Yes	Id of product to fetch maker statistics for.
epoch	number	Yes	Discrete time period (1-6) used to calculate and distribute maker rewards. Refer to the trading rewards page for detailed information.
interval	number	Yes	In seconds, determines the time range of the returned data, where the data fetched is between [current_time - interval, current_time]; if epoch is in the past, represents the number of seconds from the epochs' end time.

Response

{
  "reward_coefficient": 0.9483040058174318,
  "makers": [
    {
      "address": "0xf8d240d9514c9a4715d66268d7af3b53d6196425",
      "data": [
        {
          "timestamp": "1683000408",
          "maker_fee": "0.19562185914350788",
          "uptime": "0.6886257093510979",
          "sum_q_min": "650890342170.0813",
          "q_score": "2695501770744552500000000",
          "maker_share": "0.07999740017646266",
          "expected_maker_reward": "599980.5013234699"
        },
        {
          "timestamp": "1683001488",
          "maker_fee": "0.19554813527795115",
          "uptime": "0.6887001477104875",
          "sum_q_min": "652105067151.318",
          "q_score": "2728562079704242000000000",
          "maker_share": "0.0798616824959354",
          "expected_maker_reward": "598962.6187195155"
        },
      ]
    },
    {
      "address": "0xf8d240d9514c9a4715d66268d7af3b53d6196425",
      "data": [
        {
          "timestamp": "1683000408",
          "maker_fee": "0.3904355312617341",
          "uptime": "0.8724401677769553",
          "sum_q_min": "4891203667747.313",
          "q_score": "26137645446994395000000000",
          "maker_share": "0.7757159372654193",
          "expected_maker_reward": "5817869.529490645"
        },
        {
          "timestamp": "1683000424",
          "maker_fee": "0.3904068168333055",
          "uptime": "0.8724559023066486",
          "sum_q_min": "4891460132249.739",
          "q_score": "26156541776239450000000000",
          "maker_share": "0.7756616559903383",
          "expected_maker_reward": "5817462.419927537"
        },
      ]
    }
  ]
}

• reward_coefficient: A dynamic, relative metric indicating the amount of $VRTX earned per market, with 1.00 being average. Higher token allocation to a market results in an increased reward coefficient.

• maker_fee: % of maker fees this MM contributed.

• uptime: % of uptime from the start of the epoch.

• sum_q_min: sum(q_min, across all minutes).

• q_score: A performance metric assessing a market maker's contributions and effectiveness within a specific epoch.

• maker_share: % of q_score this MM contributed.

• expected_maker_reward: Expected amount of tokens this MM can get from the makers program.