Skip to main content
GET
https://partners-backend-1038109371738.europe-west1.run.app
/
api
/
v1
/
{chain_id}
/
{token_address}
/
protocols
curl "https://partners-backend-1038109371738.europe-west1.run.app/api/v1/8453/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913/protocols"

{
  "protocols": [
    {
      "name": "aave",
      "available": true,
      "description": "Aave v3 lending protocol",
      "tvl": 1500000000,
      "apy": 5.5,
      "pools": [
        {
          "name": "USDC",
          "apy": 5.5
        }
      ],
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-20T12:00:00Z"
    },
    {
      "name": "compound",
      "available": true,
      "description": "Compound v3 lending protocol",
      "tvl": 800000000,
      "apy": 4.8,
      "pools": [
        {
          "name": "USDC",
          "apy": 4.8
        }
      ],
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-20T12:00:00Z"
    },
    {
      "name": "moonwell",
      "available": true,
      "description": "Moonwell lending protocol",
      "tvl": 200000000,
      "apy": 6.2,
      "pools": [],
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-20T12:00:00Z"
    }
  ]
}
SDK Alternative: Use giza.agent.getProtocols() for a simpler TypeScript interface. See SDK docs

​
Description

Retrieves the list of available DeFi protocols for a specific token on a chain, including their current APY and TVL.

​
Path Parameters

​
chain_id
integer
required
The blockchain chain ID
​
token_address
string
required
The token address (e.g., USDC address)

​
Response

​
protocols
array
List of available protocols
curl "https://partners-backend-1038109371738.europe-west1.run.app/api/v1/8453/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913/protocols"

{
  "protocols": [
    {
      "name": "aave",
      "available": true,
      "description": "Aave v3 lending protocol",
      "tvl": 1500000000,
      "apy": 5.5,
      "pools": [
        {
          "name": "USDC",
          "apy": 5.5
        }
      ],
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-20T12:00:00Z"
    },
    {
      "name": "compound",
      "available": true,
      "description": "Compound v3 lending protocol",
      "tvl": 800000000,
      "apy": 4.8,
      "pools": [
        {
          "name": "USDC",
          "apy": 4.8
        }
      ],
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-20T12:00:00Z"
    },
    {
      "name": "moonwell",
      "available": true,
      "description": "Moonwell lending protocol",
      "tvl": 200000000,
      "apy": 6.2,
      "pools": [],
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-20T12:00:00Z"
    }
  ]
}