Skip to main content
Returns the live position value from Jupiter Lend or Kamino for the given wallet — queried directly from the protocol, without internal position IDs. 
GET /yield/earnings
1

Query parameters

All parameters are required:
ParameterTypeDescription
walletstringUser’s Solana public key
assetstringToken symbol (e.g. USDC)
providerstringjupiter_lend or kamino
chain_namestringNetwork (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>'
2

Expected response

{
  "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
      }
    ]
  }
}
FieldDescription
position_on_protocolCurrent balance/value on the protocol for that wallet
earnings_statusok when the lookup succeeded
earnings_detailsError context when earnings_status is not ok
Earnings are read from the protocol directly. If the wallet has no position on the selected provider, position_on_protocol may be null and earnings_status reflects the failure reason.