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"
}