Skip to main content
GET
/
yield
/
earnings
curl --request GET \
  --url 'https://api.starkfi.io/yield/earnings?wallet=FmTGYpzX27fDqaiytXUdFVaphC5o68G61Q3uhVM2d8bm&asset=USDC&provider=jupiter_lend&chain_name=solana' \
  --header 'x-api-key: <api_key>'

{
  "statusCode": 200,
  "success": true,
  "status": "get_earnings_position",
  "message": "Get earnings wallet position",
  "data": {
    "earnings": [
      {
        "provider": "jupiter_lend",
        "asset": "USDC",
        "wallet": "FmTGYpzX27fDqaiytXUdFVaphC5o68G61Q3uhVM2d8bm",
        "chain_name": "solana",
        "position_on_protocol": 1150.75,
        "earnings_status": "ok",
        "earnings_details": null
      }
    ]
  }
}
​
x-api-key
string
required
Your StarkFi API key.
​
wallet
string
required
User wallet public key.
​
asset
string
required
Token symbol (e.g. USDC).
​
provider
enum<string>
required
jupiter_lend or kamino.
​
chain_name
string
required
Enabled chain, e.g. solana.
curl --request GET \
  --url 'https://api.starkfi.io/yield/earnings?wallet=FmTGYpzX27fDqaiytXUdFVaphC5o68G61Q3uhVM2d8bm&asset=USDC&provider=jupiter_lend&chain_name=solana' \
  --header 'x-api-key: <api_key>'

{
  "statusCode": 200,
  "success": true,
  "status": "get_earnings_position",
  "message": "Get earnings wallet position",
  "data": {
    "earnings": [
      {
        "provider": "jupiter_lend",
        "asset": "USDC",
        "wallet": "FmTGYpzX27fDqaiytXUdFVaphC5o68G61Q3uhVM2d8bm",
        "chain_name": "solana",
        "position_on_protocol": 1150.75,
        "earnings_status": "ok",
        "earnings_details": null
      }
    ]
  }
}

​
Response

​
data.earnings
array
required
One entry per query. Reads the live balance directly from the protocol — no internal position ID required.
​
data.earnings[].position_on_protocol
number
Current value reported by the provider for that wallet and asset.
​
data.earnings[].earnings_status
string
ok on success, or an error code when the protocol lookup failed.