YieldGetProviders

List DeFi protocols available through the Trails earn system

POST /rpc/Trails/YieldGetProviders

YieldGetProviders returns available Yield providers.

cURL

curl --request POST \
  --url https://api.example.com/rpc/Trails/YieldGetProviders \
  --header 'Content-Type: application/json' \
  --data '
{
  "limit": 123,
  "offset": 123
}
'

200

{
  "items": [
    {
      "name": "<string>",
      "id": "<string>",
      "logoURI": "<string>",
      "description": "<string>",
      "website": "<string>",
      "tvlUsd": {},
      "type": "<string>",
      "supportsBeneficiary": true,
      "references": [
        "<string>"
      ]
    }
  ],
  "total": 123,
  "offset": 123,
  "limit": 123
}

Overview

YieldGetProviders returns the DeFi protocols (providers) available through Trails’ earn system — Aave, Morpho, Yearn, and others. Use the returned provider IDs as filter values for YieldGetMarkets.

The SDK’s useEarnProviders hook wraps this endpoint — prefer it in React apps.

Request Parameters

All fields are optional.

Field	Type	Description
limit	number	Number of providers to return
offset	number	Pagination offset

Response

Returns payload containing an array of provider objects. Each provider includes:

Field	Description
id	Provider identifier — use as the provider filter in YieldGetMarkets
name	Human-readable protocol name
url	Protocol website
logoUrl	Protocol logo image URL

Examples

List all providers

const response = await fetch('https://trails-api.sequence.app/rpc/Trails/YieldGetProviders', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Access-Key': 'YOUR_ACCESS_KEY',
  },
  body: JSON.stringify({}),
})

const { payload } = await response.json()
const providers = JSON.parse(payload)

providers.forEach(provider => {
  console.log(`${provider.id}: ${provider.name}`)
})

SDK alternative

In React, use the useEarnProviders hook:

import { useEarnProviders } from '0xtrails'

const { data: providers } = useEarnProviders()

See also

• YieldGetMarkets — Filter markets by provider ID
• Markets & Providers — SDK hooks reference

Body

application/json

limit · number

offset · number

Response

200

application/json

OK

items · object[] · required

[]YieldProvider

Show child attributes

total · number · required

offset · number · required

limit · number · required