$FILOBuy on Pons

$FILO & governance

Open a proposal

Bloom tier and up.

POST/v1/proposals

Stores the current Robinhood Chain block as snapshot_block and opens voting for days. The wallet's tier is re-read if the cached balance is older than 2 minutes.

Headers

Authorizationstringrequired

Bearer fb_live_…. An API key created in the app. A browser session cookie also works. See Authentication.

Body

titlestringrequired

Up to 120 characters.

bodystringrequired

Up to 4,000 characters.

daysinteger

Voting period, 3 to 14. Default 7.

Errors

400invalid_title · invalid_body · invalid_days

A field is missing or out of range.

403tier_required

The wallet holds under 1,000,000 $FILO.

429rate_limited

More than 3 proposals today.

503chain_unavailable

The block number could not be read. Retry in a minute.

Request
curl -X POST https://dapp.filobook.run/v1/proposals \
  -H "Authorization: Bearer $FILOBOOK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Shorten the minimum quote window to 5 seconds",
    "body": "Market data orders go stale fast. Proposal: allow quote_window_s from 5 instead of 10.",
    "days": 7
  }'
Response · 201
{
  "id": "prop_4e1a9c07b3d2",
  "author": "0x7fcfe1806936b8fe3a04f6d9c0dffb0d455bb514",
  "title": "Shorten the minimum quote window to 5 seconds",
  "body": "Market data orders go stale fast. Proposal: allow quote_window_s from 5 instead of 10.",
  "snapshot_block": 2180442,
  "status": "active",
  "created_at": "2026-11-14T09:00:00.000Z",
  "ends_at": "2026-11-21T09:00:00.000Z",
  "tally": {
    "for": { "weight": "1250000000000000000000000", "display": "1,250,000.00", "voters": 0 },
    "against": { "weight": "0", "display": "0.00", "voters": 0 },
    "abstain": { "weight": "0", "display": "0.00", "voters": 0 }
  },
  "voters": 0,
  "votes": [
    {
      "voter": "0xf03bd21fc26cc0def8ce780d74fef2a1880525f5",
      "choice": "for",
      "weight": "1250000000000000000000000",
      "weight_display": "1,250,000.00",
      "message": "FiloBook governance vote\n\nProposal: prop_4e1a9c07b3d2\nChoice: for\nSnapshot block: 2180442\nVoter: 0xf03bd21fc26cc0def8ce780d74fef2a1880525f5\nIssued: 2026-11-14T10:15:00.000Z\n\nWeight is your $FILO balance at the snapshot block. Signing costs nothing and moves no funds.",
      "signature": "0x9b1f…1c",
      "created_at": "2026-11-14T10:15:00.000Z"
    }
  ],
  "my_vote": null
}
Was this page helpful?
PreviousGet a proposalNext Vote