> For the complete documentation index, see [llms.txt](https://docs.circular.bot/circular-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.circular.bot/circular-docs/api/tools/tips/transactions-1.md).

# Gains

## Endpoint

<mark style="color:green;">`GET`</mark>[ `https://pro.circular.bot/market/tips/by/gains`](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**

<pre class="language-json"><code class="lang-json"><strong>{
</strong>    "Content-Type": "application/json",
    "x-api-key": "your-api-key"
}
</code></pre>

**Parameters**

```json
{
    "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**

{% tabs %}
{% tab title="200" %}

```json
{
  "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.
      }
    }
  }
}
```

{% endtab %}
{% endtabs %}

**Informations:**

* Requests per minute: 10
* Available plans: [**PREMIUM**](https://www.circular.bot/plans), [**PRO**](https://www.circular.bot/plans)
* More technical information [here](https://pro.circular.bot/documentation#operation/tips_by_gains_market_tips_by_gains_get)