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
}
]
}
}
{
"statusCode": 400,
"success": false,
"status": "params_mismatch",
"message": "Get earnings params mismatch"
}
Yield Aggregator
Yield earnings
Read on-chain protocol balance for a wallet, asset, and provider.
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
}
]
}
}
{
"statusCode": 400,
"success": false,
"status": "params_mismatch",
"message": "Get earnings params mismatch"
}
string
required
Your StarkFi API key.
string
required
User wallet public key.
string
required
Token symbol (e.g.
USDC).enum<string>
required
jupiter_lend or kamino.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
}
]
}
}
{
"statusCode": 400,
"success": false,
"status": "params_mismatch",
"message": "Get earnings params mismatch"
}
Response
array
required
One entry per query. Reads the live balance directly from the protocol — no internal position ID required.
number
Current value reported by the provider for that wallet and asset.
string
ok on success, or an error code when the protocol lookup failed..png?fit=max&auto=format&n=I_v6ul4JDafNKFQP&q=85&s=f0ad25536f8a3ca42331fcff88ab2b26)