The manual for games that live in the feed.

<!doctype html>
<html>
  <body>
    <button id="five">high five</button>
    <p id="count">0 high fives so far</p>
    <script>
      // window.feedcade already exists by the time this runs.
      const label = document.getElementById('count')

      feedcade.room.subscribe((state) => {
        label.textContent = (state.fives ?? 0) + ' high fives so far'
      })

      document.getElementById('five').onclick = () => {
        const now = feedcade.room.get('fives') ?? 0
        feedcade.room.set('fives', now + 1)
      }
    </script>
  </body>
</html>

feedcade.player
// { id: "q3m8x1ka", name: "player-q3m8", color: "#7dd3fc" }

// Let people choose what the leaderboard calls them.
nameInput.onchange = () => {
  nameInput.value = feedcade.setName(nameInput.value)
}

// The card in a post is small, so tighten the layout there.
if (feedcade.inX) document.body.classList.add('in-post')

// Resolves after the first pull, with everything in the room.
const state = await feedcade.room.ready

feedcade.room.get('round')        // one key, from the local copy
feedcade.room.all()               // a copy of every key

feedcade.room.set('round', { n: 3, startedAt: Date.now() })  // any JSON up to 8 KB
feedcade.room.remove('round')     // same as set('round', null)

// Runs right away with the current state, then on every change.
const stop = feedcade.room.subscribe((state, changedKeys) => {
  if (changedKeys.includes('round')) drawRound(state.round)
})
stop() // unsubscribe

feedcade.players.subscribe((people) => {
  here.textContent = people.length === 1 ? 'just you' : people.length + ' here'
  dots.replaceChildren(...people.map((p) => avatar(p.name, p.color)))
})

feedcade.players.list() // the last list received, no request

// One key per player: only your own best score is ever written.
function submit(score) {
  const key = 'best:' + feedcade.player.id
  const prev = feedcade.room.get(key)
  if (prev && prev.score >= score) return
  feedcade.room.set(key, { name: feedcade.player.name, score })
}

feedcade.room.subscribe((state) => {
  const top = Object.entries(state)
    .filter(([k]) => k.startsWith('best:'))
    .map(([, v]) => v)
    .sort((a, b) => b.score - a.score)
    .slice(0, 10)
  renderBoard(top)
})

localStorage.setItem('sound', 'off')
localStorage.getItem('sound') // "off"

// Some sandboxes refuse storage. When that happens the runtime puts an
// in-memory stand-in in its place: calls still work, nothing survives a reload.

<meta name="twitter:card" content="player">
<meta name="twitter:player" content="https://feedcade.xyz/p/<id>">
<meta name="twitter:player:width" content="480">
<meta name="twitter:player:height" content="480">
<meta name="twitter:image" content="https://feedcade.xyz/api/card/<id>">

[
  { "wallet": "7fUq…you",    "bps": 6000 },  // 60%
  { "wallet": "Hx2m…artist", "bps": 2500 },  // 25%
  { "wallet": "3kPa…prizes", "bps": 1500 }   // 15%
]
// Up to 10 wallets. The bps must total exactly 10,000.

# Everything on the first call, then only what changed after a rev
curl "https://feedcade.xyz/api/room/pixel-wall?since=0"

# Write a single key (any JSON up to 8 KB; null deletes it)
curl -X POST "https://feedcade.xyz/api/room/pixel-wall" \
  -H "content-type: application/json" \
  -d '{"key":"px:4,7","value":"#fde047"}'

{
  "rev": 842,
  "changes": {
    "px:4,7": "#fde047",
    "best:q3m8x1ka": { "name": "player-q3m8", "score": 31 },
    "px:0,0": null
  },
  "more": false,
  "players": [
    { "id": "q3m8x1ka", "name": "player-q3m8", "color": "#7dd3fc" }
  ]
}

const base = 'https://feedcade.xyz'

// 1. create the game and keep the edit key
const { id, token } = await fetch(base + '/api/sites', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ prompt: 'a two-player reaction duel', model: 'anthropic/claude-sonnet-5.5' }),
}).then((r) => r.json())

// 2. build it; the body streams back as the model writes
const res = await fetch(base + '/api/sites/' + id + '/generate', {
  method: 'POST',
  headers: { 'content-type': 'application/json', 'x-site-token': token },
  body: '{}',
})
const text = await res.text()
const end = text.match(/<!--feedcade:(saved|error):(.*?)-->/)
console.log(end[1] === 'saved' ? base + '/s/' + id : 'failed: ' + end[2])

# The coin behind a game (each field is null until it exists)
curl "https://feedcade.xyz/api/sites/<id>/coin"
# -> {"coin": {...} | null, "market": {...} | null, "fees": {...} | null}

# Candles for the chart
curl "https://feedcade.xyz/api/coins/<mint>?kind=candles&tf=1h"