Staking

Stake $RUN to earn $CEO rewards. CeosCard NFT holders receive boosted APY based on their card tier.

Tier Multipliers

CeosCard Tier	Multiplier	Effective APY (at 12.5% base)
Black (1-1000)	5x	62.5%
Gold (1001-4000)	3x	37.5%
Silver (4001-10000)	2x	25.0%
None	1x	12.5%

GET /api/staking/position/[wallet]

Returns a wallet’s staking position in the $RUN pool. Reads on-chain from StakingRewardsV2.

Parameters

Parameter	In	Type	Required	Description
`wallet`	path	string	Yes	Ethereum address (0x…)

Response


{
  "success": true,
  "data": {
    "wallet": "0x1234...",
    "stakedRun": "50000000000000000000000",
    "effectiveStake": "250000000000000000000000",
    "pendingCeo": "1200000000000000000",
    "tier": "BLACK",
    "multiplier": 5,
    "baseApy": 12.5,
    "effectiveApy": 62.5
  }
}

Field	Type	Description
`stakedRun`	string	Raw $RUN staked (wei)
`effectiveStake`	string	Stake after multiplier (wei)
`pendingCeo`	string	Unclaimed $CEO rewards (wei)
`tier`	string	`BLACK`, `GOLD`, `SILVER`, or `NONE`
`multiplier`	number	CeosCard tier multiplier (1-5)
`baseApy`	number	Base APY before multiplier
`effectiveApy`	number	Actual APY with tier boost


curl https://ceos.run/api/staking/position/0x1234567890abcdef1234567890abcdef12345678

Error Codes

Status	Code	Description
400	BAD_REQUEST	Invalid wallet address

GET /api/staking/stats

Returns global staking statistics from on-chain contracts.

Response


{
  "success": true,
  "data": {
    "totalStakedRun": "5000000000000000000000000",
    "ceoPerSecond": "100000000000000000",
    "totalCeoDistributed": "8640000000000000000000",
    "currentBaseApy": 12.5,
    "poolCount": 1
  }
}

Field	Type	Description
`totalStakedRun`	string	Total effective supply in pool (wei)
`ceoPerSecond`	string	$CEO emission rate (wei/second)
`totalCeoDistributed`	string	Total $CEO supply minted (wei)
`currentBaseApy`	number	Base APY percentage
`poolCount`	number	Number of active staking pools


curl https://ceos.run/api/staking/stats