Basics
- Base URL https://usestakehouse.xyz
- All endpoints are GET and return JSON with underscore keys. SOL amounts are numbers in SOL, times are ISO strings.
- Books refresh every hour at the snapshot. Menu and cut responses are cached for 30 seconds.
- Errors return a status code and { "error": "..." }.
Want the rules behind the numbers? Read the house rules.
GET
/api/v1/menuThe menu
Every cut on the menu with its served totals.
| Param | In | Meaning |
|---|---|---|
| sort | query, optional | served (default), total, tables, cheapest or newest |
| q | query, optional | Filter by symbol, name or exact mint |
| Field | Type | Meaning |
|---|---|---|
| mint | string | Coin mint |
| sol_served_24h | number | SOL served from this cut's grill in the last 24 hours |
| total_served_sol | number | SOL served since it went on the menu |
| tables_filled | number | Seated tables, up to tables_total |
| cheapest_table_weight | number | Weight held by rank 100, or 0 while tables are open |
| grill_sol | number | SOL waiting on the grill |
| chefs_tip_pct | number | Creator share of each serving |
| creator | string | Wallet that put the cut on the menu |
curl https://usestakehouse.xyz/api/v1/menu?sort=servedResponse 200
{
"count": 0,
"cuts": []
}GET
/api/v1/cuts/{mint}One cut
Pool, grill balance, the next serving, splits and tables filled.
| Param | In | Meaning |
|---|---|---|
| mint | path | Coin mint |
| Field | Type | Meaning |
|---|---|---|
| pool | string | Raydium LaunchLab curve pool |
| stage | string | curve or graduated |
| cpmm_pool | string | Raydium pool after graduation |
| grill_sol | number | SOL waiting on the grill |
| next_serving | object | SOL released next hour and its split |
| splits | object | Service charge, chef's tip and dining room percentages |
| platform_fee_vault | string | This coin's own fee vault |
curl https://usestakehouse.xyz/api/v1/cuts/So11111111111111111111111111111111111111112Response 404 · Live response right now: no cut is on the menu yet, so every mint returns 404.
{
"error": "This coin is not on the menu"
}GET
/api/v1/cuts/{mint}/bookThe reservation book
The latest hourly ranking: rank, wallet, weight and doneness.
| Param | In | Meaning |
|---|---|---|
| mint | path | Coin mint |
| limit | query, optional | Rows to return, 1 to 1000, default 150 |
| Field | Type | Meaning |
|---|---|---|
| rank | number | 1 is the heaviest wallet |
| weight | number | Rare balance plus locked coins times doneness |
| rare_balance | number | Lowest plain balance over the last 6 snapshots |
| locked | number | Coins in eligible Jupiter Lock escrows |
| doneness | string | rare, medium_rare, medium or well_done (best lock) |
| seated | boolean | Rank 100 or better |
| chefs_table | boolean | Rank 10 or better |
curl https://usestakehouse.xyz/api/v1/cuts/So11111111111111111111111111111111111111112/book?limit=3Response 404
{
"error": "This coin is not on the menu"
}GET
/api/v1/wallets/{address}/seatsSeats for a wallet
Every cut where the wallet holds weight, served SOL and what it can collect.
| Param | In | Meaning |
|---|---|---|
| address | path | Wallet address |
| Field | Type | Meaning |
|---|---|---|
| owed_sol | number | SOL ready to collect across all cuts |
| total_served_sol | number | All SOL ever served to this wallet |
| collected_sol | number | SOL already collected |
| seats | array | Rank, weight, doneness, served SOL and locks per cut |
curl https://usestakehouse.xyz/api/v1/wallets/Bx1vNvUb53nRcgbEcxVRCGukqEbsiHQgMqWFxYorZ5DA/seatsResponse 200
{
"wallet": "Bx1vNvUb53nRcgbEcxVRCGukqEbsiHQgMqWFxYorZ5DA",
"owed_sol": 0,
"owed_lamports": "0",
"total_served_sol": 0,
"collected_sol": 0,
"chefs_tips_sol": 0,
"seats": []
}GET
/api/v1/servedServed rows
Fee claims and Collect payouts, newest first, each with its transaction signature.
| Param | In | Meaning |
|---|---|---|
| mint | query, optional | Only fee claims for this cut |
| wallet | query, optional | Only Collect payouts to this wallet |
| limit | query, optional | 1 to 200, default 50 |
| Field | Type | Meaning |
|---|---|---|
| kind | string | claim or collect |
| signature | string | Transaction signature, verify on Solscan |
| sol_to_grill | number | SOL a claim added to the grill (claims) |
| sol | number | SOL sent (collects) |
curl https://usestakehouse.xyz/api/v1/served?limit=3Response 200
{
"count": 0,
"rows": []
}