Skip to content

Economics API

API for staking, rewards, and payments.


Staking

Get Stake Info

GET /economics/stake/{wallet}
{
  "wallet": "...",
  "stakedAmount": 50000,
  "pendingUnstake": 0,
  "unstakeTimestamp": null,
  "pendingRewards": 125.5,
  "totalEarned": 2450.0
}

Stake Tokens

POST /economics/stake
{
  "amount": 10000,
  "nodeId": "node-001"
}

Begin Unstake

POST /economics/unstake
{
  "amount": 5000
}

Rewards

Get Pending Rewards

GET /economics/rewards/pending

Claim Rewards

POST /economics/rewards/claim

Reward History

GET /economics/rewards/history?days=30

Pricing

Get Current Pricing

GET /economics/pricing
{
  "tiers": {
    "free": { "limit": 1000, "pricePerQuery": 0 },
    "basic": { "limit": 50000, "pricePerQuery": 0.001 },
    "pro": { "limit": 1000000, "pricePerQuery": 0.0008 }
  },
  "multipliers": {
    "complexity": { "get_account": 1.2, "search": 2.0 },
    "sla": { "10ms": 1.5, "5ms": 2.0 }
  }
}

Calculate Query Cost

POST /economics/pricing/calculate
{
  "queryType": "get_account",
  "tier": "pro",
  "sla": "10ms",
  "paymentToken": "STRM"
}

Credits

Get Balance

GET /economics/credits

Add Credits

POST /economics/credits
{
  "amount": 1000,
  "paymentToken": "SOL"
}