GET
/
v1
/
api
/
deals
curl --request GET \
  --url https://earn.turtle.vision/v1/api/deals
{
  "deals": [
    {
      "protocol": "<string>",
      "token": {
        "address": "<string>",
        "name": "<string>",
        "symbol": "<string>",
        "logos": [
          "<string>"
        ],
        "decimals": 123,
        "chain": 123,
        "price": 123
      },
      "underlying_tokens": [
        {
          "address": "<string>",
          "name": "<string>",
          "symbol": "<string>",
          "logos": [
            "<string>"
          ],
          "decimals": 123,
          "chain": 123,
          "price": 123
        }
      ],
      "metadata": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "description": "<string>",
        "iconUrl": "<string>"
      },
      "data": {
        "apy": 123,
        "apy_base": 123,
        "apy_reward": 123,
        "tvl": 123
      }
    }
  ],
  "metadata": {}
}

Query Parameters

​
campaign_id
string

Optional campaign ID to filter deals belonging to a specific campaign.

​
id_filter
string

Optional deal ID to filter for a specific deal.

​
protocol_filter
string

Optional protocol name to filter deals by protocol (case-insensitive).

Response

200 - application/json; charset=utf-8

Represents a complete list of DeFi deals (tokens) with their metadata and performance data.