Skip to main content
GET
https://starknet.api.avnu.fi
/
staking
/
v3
/
pools
/
{poolAddress}
/
members
/
{userAddress}
curl "https://starknet.api.avnu.fi/staking/v3/pools/0x123abc/members/0x0456def..."
{
  "tokenAddress": "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
  "tokenPriceInUsd": 0.25,
  "poolAddress": "0x0abc123def456789...",
  "userAddress": "0x0123456789abcdef...",
  "amount": "0x4563918244f40000",
  "amountInUsd": 1250.00,
  "unclaimedRewards": "0x1bc16d674ec80000",
  "unclaimedRewardsInUsd": 50.00,
  "unpoolAmount": "0x0",
  "unpoolAmountInUsd": 0,
  "unpoolTime": null,
  "totalClaimedRewards": "0x6f05b59d3b20000",
  "totalClaimedRewardsHistoricalUsd": 180.50,
  "totalClaimedRewardsUsd": 200.00,
  "userActions": [
    {
      "blockNumber": 123456,
      "date": "2024-10-15T10:30:00Z",
      "userAddress": "0x0123456789abcdef...",
      "transactionHash": "0xabc123...",
      "type": "StakingStake",
      "metadata": {
        "delegationPoolAddress": "0x0abc123def456789...",
        "oldDelegatedStake": "0x0",
        "newDelegatedStake": "0x4563918244f40000"
      }
    },
    {
      "blockNumber": 125000,
      "date": "2024-11-01T14:00:00Z",
      "userAddress": "0x0123456789abcdef...",
      "transactionHash": "0xdef456...",
      "type": "StakingClaimRewards",
      "metadata": {
        "delegationPoolAddress": "0x0abc123def456789...",
        "rewardAddress": "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
        "amount": "0x6f05b59d3b20000"
      }
    }
  ],
  "totalUserActionsCount": 2,
  "expectedYearlyStrkRewards": "0x8ac7230489e80000",
  "aprs": [
    {
      "date": "2024-11-01T00:00:00Z",
      "apr": 0.085
    },
    {
      "date": "2024-10-31T00:00:00Z",
      "apr": 0.082
    }
  ]
}

Overview

Returns detailed information about a user’s staking position in a specific pool.

Path Parameters

poolAddress
string
required
Pool contract address
userAddress
string
required
User’s wallet address

Response

tokenAddress
string
required
The staking token address
tokenPriceInUsd
number
required
The token price in USD
poolAddress
string
required
The pool contract address
userAddress
string
required
The user’s wallet address
amount
string
required
The staked amount (hex format)
amountInUsd
number
The staked amount in USD
unclaimedRewards
string
required
Unclaimed rewards amount (hex format)
unclaimedRewardsInUsd
number
Unclaimed rewards in USD
unpoolAmount
string
required
Amount pending withdrawal (hex format)
unpoolAmountInUsd
number
Pending withdrawal amount in USD
unpoolTime
string
Timestamp when withdrawal will be available (ISO 8601 format)
totalClaimedRewards
string
required
Total rewards claimed historically (hex format)
totalClaimedRewardsHistoricalUsd
number
Total claimed rewards in USD at historical prices
totalClaimedRewardsUsd
number
required
Total claimed rewards in current USD value
userActions
array
required
Array of user staking actions
totalUserActionsCount
integer
required
Total count of user actions
expectedYearlyStrkRewards
string
required
Expected yearly STRK rewards (hex format)
aprs
array
required
Historical APR data
curl "https://starknet.api.avnu.fi/staking/v3/pools/0x123abc/members/0x0456def..."
{
  "tokenAddress": "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
  "tokenPriceInUsd": 0.25,
  "poolAddress": "0x0abc123def456789...",
  "userAddress": "0x0123456789abcdef...",
  "amount": "0x4563918244f40000",
  "amountInUsd": 1250.00,
  "unclaimedRewards": "0x1bc16d674ec80000",
  "unclaimedRewardsInUsd": 50.00,
  "unpoolAmount": "0x0",
  "unpoolAmountInUsd": 0,
  "unpoolTime": null,
  "totalClaimedRewards": "0x6f05b59d3b20000",
  "totalClaimedRewardsHistoricalUsd": 180.50,
  "totalClaimedRewardsUsd": 200.00,
  "userActions": [
    {
      "blockNumber": 123456,
      "date": "2024-10-15T10:30:00Z",
      "userAddress": "0x0123456789abcdef...",
      "transactionHash": "0xabc123...",
      "type": "StakingStake",
      "metadata": {
        "delegationPoolAddress": "0x0abc123def456789...",
        "oldDelegatedStake": "0x0",
        "newDelegatedStake": "0x4563918244f40000"
      }
    },
    {
      "blockNumber": 125000,
      "date": "2024-11-01T14:00:00Z",
      "userAddress": "0x0123456789abcdef...",
      "transactionHash": "0xdef456...",
      "type": "StakingClaimRewards",
      "metadata": {
        "delegationPoolAddress": "0x0abc123def456789...",
        "rewardAddress": "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
        "amount": "0x6f05b59d3b20000"
      }
    }
  ],
  "totalUserActionsCount": 2,
  "expectedYearlyStrkRewards": "0x8ac7230489e80000",
  "aprs": [
    {
      "date": "2024-11-01T00:00:00Z",
      "apr": 0.085
    },
    {
      "date": "2024-10-31T00:00:00Z",
      "apr": 0.082
    }
  ]
}