Position API Endpoints
GET /api/v1/positions/:wallet
Get all positions for a wallet address.
bash
curl https://api.nester.finance/api/v1/positions/GBXYZ...json
{
"success": true,
"data": {
"wallet": "GBXYZ...",
"total_value_usd": 5250.50,
"total_yield_earned": 250.50,
"positions": [
{
"vault_id": "vault_balanced_01",
"vault_name": "Balanced",
"shares": 5000,
"value_usd": 5250.50,
"deposited_usd": 5000,
"yield_earned": 250.50,
"apy": 9.5,
"deposited_at": "2026-01-15T10:30:00Z",
"maturity_at": "2026-04-15T10:30:00Z",
"maturity_status": "locked",
"days_remaining": 24
}
]
}
}GET /api/v1/yields
Historical yield data for charting.
bash
curl https://api.nester.finance/api/v1/yields?vault_id=vault_balanced_01&period=30djson
{
"success": true,
"data": {
"vault_id": "vault_balanced_01",
"period": "30d",
"snapshots": [
{ "date": "2026-02-20", "apy": 9.2, "tvl": 520000 },
{ "date": "2026-02-21", "apy": 9.5, "tvl": 535000 },
{ "date": "2026-02-22", "apy": 9.3, "tvl": 548000 }
]
}
}