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.
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.