Gains

Endpoint

GET https://pro.circular.bot/market/tips/by/gains

This endpoint retrieves percentile of the percentages of gains allowed to tips grouped by mint, based on a input amount of token range

Headers

{
    "Content-Type": "application/json",
    "x-api-key": "your-api-key"
}

Parameters

{
    "wallets": [ // Optional | filter by a list of wallets, if the field is not specified the data is based on the entire market
        "Ge8xkdPrPU2tP22nKWBHocCZ6ezfHTLGHZzLsPmEtozH",
        ...
    ],
    "inputAmountMin": 0, // Minimum input amount value
    "inputAmountMax": 10000000000000, // Maximum input amount
    "providers": [ // Filter by provider list ("JITO", "FAST", "TEMPORAL", "BLOX", "NEXTBLOCK", "NO_PROVIDER")
        "FAST",
        "JITO",
        ...
    ],
    "maxTimeRange": 900 // Considers transactions from now since (seconds)
}

Response

200

{
  "FAST": {
    "So11111111111111111111111111111111111111112": { // Token used for tips
      "number": 3223, // The total number of transactions where this mint was used for tipping
      "percentiles": {
        "p00": 1000000, // Minimum percentage of gains allowed for tip amounts.
        "p10": 1182033,
        "p20": 1495086,
        "p30": 2047978,
        "p40": 3154260,
        "p50": 4827979, // Median percentage of gains allowed for tip amounts (50th percentile).
        "p60": 6446495,
        "p70": 9217775,
        "p80": 15950023,
        "p90": 40284947,
        "p95": 104138223,
        "p99": 516037929 // 99th percentile of percentages of gains allowed for tip amounts.
      }
    }
  }
}

Informations:

• Requests per minute: 10

• Available plans: PREMIUM, PRO

• More technical information here