Skip to main content

Apps Overview

Apps are mini-dashboards and tools you describe in plain English — Bankr writes the manifest, the scripts, and the UI for you, then drops it into your Apps sidebar. No project scaffolding, no build pipeline, no hosting to set up. You talk, Bankr ships.

Build an app by asking​

Open the chat and tell Bankr what you want. The more specific you are about the data, layout, and refresh cadence, the closer the first build lands to what you imagined.

build me a polymarket alpha terminal — show curated picks bankr's
reasoning, trending markets, ending-soon markets, and my open
positions. refresh every 15 minutes. share it as a public link i
can post on twitter.

Bankr designs the data model, writes the backend scripts, drafts the HTML with charts and tables, picks a refresh schedule, and installs the app under your wallet. When it's done, the app shows up in your Apps sidebar — click it and the dashboard renders inside the app panel. Free accounts can have one app at a time. Bankr Club removes the limit.

You can also ask for tools that aren't dashboards: a calculator, a step-by-step trade builder, a watchlist with a paste-in field, a portfolio snapshot. If the agent has the right permissions and the data is reachable, it can probably build it.

App Building Terms​

The first time you ask the agent to build, edit, fork or run an app — or to deploy or manage an x402 endpoint through chat — it shows the App Building Terms and pauses until you reply exactly I agree. The key point: you're responsible for any wallets, keys or funds your apps create or use, so never send funds to an address an app or the agent generates while building. You accept once per version of the terms; automations and webhooks can't accept on your behalf.

Refine by chatting​

Every installed app keeps the chat open right next to it. To change something, just say what you want changed.

add a column for entry price between symbol and size

change the schedule to every 5 minutes

split the curated section into two panels — long and short

show 24h volume next to each market

stop showing my solana positions, only base

Bankr edits the app in place. It only touches the parts you asked about — your existing layout, naming, and color choices stay. If something breaks, say so ("the trending panel is empty after the last edit") and Bankr will read its own scripts, find the issue, and patch it.

You don't need to think about which file to edit. The agent owns the manifest, the scripts, the HTML, and the schedule, and figures out the smallest change that satisfies your request.

Running scripts on demand​

Each app's backend logic lives in scripts — small functions that run on a server-side runtime when invoked. Most are wired up to a schedule that fires automatically (every 15 minutes, every hour, daily, whatever you ask for); some are triggered from buttons in the app's UI; some are run on demand.

Without Bankr Club, scheduled runs are capped at 1,000 a day (UTC) across all of a wallet's apps, failed runs included; past the cap, scheduled runs are skipped until the next day.

Club or not, an app nobody has opened, edited or run outside its schedule for 14 days has its schedules paused until someone does; a visitor opening a shared app counts.

If you own the app, the panel header has a Scripts button that opens a drawer listing every script. Each row has:

  • The script name and its schedule (or on-demand for unscheduled scripts).
  • An Open button that jumps you into the file editor with the script's source loaded.
  • A Run button that fires the script immediately, as if its schedule had just ticked. The result (or error) renders inline.

Useful for testing edits, refreshing data immediately instead of waiting for the next scheduled run, or seeing exactly what a script returns.

Apps can call paid HTTP endpoints from the iframe using the x402 payment protocol. When a button needs to spend money — an AI image generator, a premium per-query data lookup, a gated upstream feed — the app calls bankr.x402.fetch(url, options). The host pops a confirmation dialog showing the URL and the endpoint's price, the visitor's wallet pays, and the upstream response renders. Each call goes through its own confirm; nothing settles silently.

build me an image generator app where each render charges the visitor
$0.10 to call x402.bankr.bot/0xowner/image-gen

The agent adds the pay:x402 permission, pins the endpoint hostname in an allowedHosts allowlist, and writes the iframe code. A per-(visitor, app) rate limit of 10 calls/minute caps abuse.

If you want to publish a paid endpoint that other apps and agents can consume — not just consume one — see x402 Cloud. For the wire-level details on consuming x402 from inside an app see Permissions and the SDK reference.

Sharing & forking​

note

We're re-evaluating how app sharing and forking work. Sharing an owner-mode app works today; forking someone else's app and opening viewer-mode apps to visitors are paused for now.

Apps default to private. To share one:

make this app public
make this app unlisted, give me the share link
  • Unlisted apps are accessible to anyone with the URL.
  • Public apps are listed in Bankr's app directory and discoverable by anyone.

Anyone visiting your shared dashboard sees the same data you see — scripts run as the owner so visitors get a consistent view. Forking someone else's app is turned off for now, so a visitor who wants the same view of their own data asks Bankr to build them their own app.

Apps can also run in "viewer mode", where each visitor's own wallet drives the scripts (per-user calculators, viewer-specific trade builders). Viewer mode is closed to visitors for now: a viewer-mode app opens only for its owner and can't be made public or unlisted. See Permissions for the details.

Before flipping an app to public or sharing the unlisted link, walk the public-app checklist — it covers the small set of rules that catch the most common breakage (most often: an iframe reads a key the manifest never declared, and anonymous viewers get a 403).

Fullscreen​

The app panel has a fullscreen icon next to Refresh. Click it and the app fills the viewport, hiding the sidebar. Press Esc or click the icon again to return. Great for dense dashboards — heat-maps, depth charts, long position tables.

Where to next​

  • Permissions — what an app can read, write, and execute on your behalf.
  • SDK Reference — the methods available to your app's frontend HTML and backend scripts, plus the manifest format and where app files live in your filesystem.