Skip to content

BrainDev Studio

Guide

How the research loop works, what each on-chain action does in plain words, where every number comes from, and how agents read the same data.

Start

BrainDev Studio is a research canvas for tokenized stocks on Robinhood Chain. You place live widgets on a board, write a thesis next to them, and decide what the thesis becomes.

  1. Open the studio and connect a wallet. The wallet is the login. There is no account and no password.
  2. Switch to Robinhood Chain if asked. One click adds the network, chain id 4663, and switches to it.
  3. Read your first board. It opens on NVDA with six widgets and a short form that turns a question into a board.

Not ready to connect? Choose Look around first. The same board opens read only.

Open the studio

The research loop

A board is a thesis with its evidence attached. The loop has three stages, the same three steps as the mark.

Data
Pick a board asset. Linked widgets follow it. Pinned widgets stay on their own stock. Each widget names its source and the time it was read.
Intelligence
Write the hypothesis in a thesis note. Link a chart to it with supports and a condition with watches. Ask the agent, which inspects the live snapshot and proposes changes you accept or reject one by one.
Plan
State the condition that would change your mind. It can stay on the canvas, become an on-chain signal, or become a mandate with funds behind it.

Five moves

  1. Write your question. Add a thesis note. Say what you believe and what would prove it wrong.
  2. Bring the evidence. Add a metric or a chart from the library. Pin a widget to compare another stock.
  3. Make the condition explicit. Add a condition and link it to the thesis. When it is met, the thesis is flagged for review.
  4. Review the agent. Proposals show before and after. Apply the changes you want in one step. Undo is always there.
  5. Put it on chain. Publish the board, post the thesis as a signal, or sign a mandate.

The canvas

Build mode edits the board. Observe mode locks the layout and keeps the numbers moving. The library holds 35 widgets in three tabs: Instruments, Trade and agent, and On-chain feeds.

  • Drag a widget by its header. Resize it from the corner. Snap aligns to a 16 px grid.
  • List view shows the same widgets in reading order. Phones use it by default, with panels as bottom sheets.
  • Share copies a link with the whole board inside it. Export saves the board as a JSON file you can import again.
  • Boards are saved in this browser under your wallet address. Export the ones you care about.

Shortcuts

Arrow
Moves the focused widget 10 px. Hold Shift for 1 px. On the resize handle it changes the size.
Cmd/Ctrl Z
Undo. Add Shift to redo.
Cmd/Ctrl D
Duplicates the selected widget.
Space and drag
Pans the canvas. Cmd/Ctrl and scroll zooms.
Shift and click
Selects several widgets to move or align together. Esc clears the selection.

On chain, in plain words

Four things your research can become. Each one is a transaction your wallet shows you before it is sent, and the studio checks first that it would succeed.

Wallet login

Connecting shares your address and nothing else. BrainDev never holds keys. Reading the market needs no wallet at all.

Boards

Publishing stores the title and the layout of a board on Robinhood Chain. A published board has a link that opens it read only for anyone. Others can fork it into their own studio or star it. You can update your board, and each update is a new version. A board holds up to 24,000 bytes.

Signals

A signal is a thesis anyone can check. You choose a stock that has a Chainlink feed, above or below, a price, and an end date between one hour and 400 days away.

  • The signal stays open until the feed crosses your price. Then anyone can press Check, and it is recorded as triggered with the price and the round that did it.
  • If the crossing came and went, Find proof looks up the past round and Prove records it.
  • After the end date an open signal expires. Other wallets can endorse a signal once.
  • A signal cannot be posted while its condition already holds. It is always about a move that has not happened.

Agent mandates

A mandate is one rule with funds behind it, such as buy NVDA with 50 USDG if it falls below $180.

  • You set the amount, the price tolerance from 0.1% to 5%, an end date and a small ETH tip. The amount moves into escrow when you sign.
  • When the Chainlink feed meets the condition, any wallet can run the mandate. It swaps through Uniswap v3, sends the result to you, and pays the tip to whoever ran it.
  • A mandate runs only on a Chainlink print from the last 24 hours, so it rests while the feed is quiet, such as weekends. The minimum you receive is set from that print and your tolerance.
  • A fee of 0.10% of the amount is taken when a mandate runs. Creating and cancelling cost only network gas.
  • Cancel anytime and the funds and the tip return to you. After the end date anyone can expire it, which also refunds you.
  • A keeper checks open mandates on a schedule and runs the ones whose tip covers the gas. Any wallet can also run a ready one from the Agent panel and earn the tip.

Swap

The Swap widget trades USDG or ETH for stock tokens and back, through the Uniswap v3 pools on Robinhood Chain. The quote comes from live pool state and shows the route, the price impact and the minimum you receive. That minimum is enforced: if the price moves past it before you sign, nothing is sent and you see the new quote. Your wallet signs.

Conditions prompt research. Mandates execute only what you signed.

Where the numbers come from

Every value is read from Robinhood Chain mainnet. The universe is every Robinhood stock token with a live Uniswap v3 pool.

Price
The Chainlink feed of the stock when it has one. Otherwise its main Uniswap v3 pool.
Pool price and depth
Uniswap v3 pools against USDG or wrapped ETH. Depth is the smaller side of each pool, added up.
Oracle premium
The pool price against the Chainlink price, in basis points.
TWAP deviation
The pool price against its one hour average.
1h, 24h, 7d, 30d change
Measured from the same source as the price, so a pool premium never reads as a price move.
Supply and market cap
Shares minted on Robinhood Chain, times the price.
Lending
Morpho Blue USDG markets: supply, borrow, utilization and rates.
Swaps and liquidity
Pool events, newest first.

The studio refreshes every 30 seconds while the tab is visible. The health chip reads healthy, partial or down, and opens a panel with each feed group and its age. Stocks without a Chainlink feed are priced from their pool and cannot back a signal or a mandate.

Agent API

Agents read the same data as people. Every route is a GET that returns JSON, needs no key, and is cached for a few seconds. Numbers are plain: USD, shares and percent. A value the chain cannot supply is null, for example oraclePrice on a stock without a feed, or a change field for about a minute after the service has been idle.

curl https://braindev.studio/api/agent/snapshot
GET/api/agent/snapshot

The live market, compact. One row per stock, plus totals and health.

block, at, health
The block read, the time in milliseconds, and healthy, partial or down.
totals
mcapUsd, depthUsd, advancers, decliners, unchanged, medianChange24h.
stocks[]
symbol, label, category, anchored, price, oraclePrice, oracleUpdatedAt, oracleStale, poolPrice, premiumBps, twapDevBps, change1h, change24h, change7d, change30d, supply, mcapUsd, depthUsd.

Example response

{
  "chainId": 4663,
  "block": 80638777,
  "health": "healthy",
  "ethUsd": 2724.58,
  "totals": { "mcapUsd": 157752000, "depthUsd": 13100200,
              "advancers": 42, "decliners": 16 },
  "stocks": [
    { "symbol": "NVDA", "label": "NVIDIA", "anchored": true,
      "price": 235.21, "poolPrice": 236.21, "premiumBps": 42.25,
      "change24h": 0.09, "supply": 75485.36,
      "mcapUsd": 17755100, "depthUsd": 1441180 }
  ]
}
GET/api/agent/boards?start=0&limit=20

Published boards, newest first. Each row links to the board in the studio.

start, limit
Offset and page size. The limit goes from 1 to 100.
sort, owner
Optional. sort=stars orders by stars. owner filters by publisher address.
boards[]
id, title, owner, parent, version, stars, forks, createdAt, updatedAt, link.

Example response

{
  "ready": true,
  "count": 1,
  "boards": [
    { "id": 1, "title": "NVDA momentum", "owner": "0x…", "parent": 0,
      "version": 1, "stars": 3, "forks": 1, "link": "/studio?board=1" }
  ]
}

The board itself, as JSON, is at /api/board?id=1.

GET/api/agent/signals

Signals, newest first, with the stocks that can carry one.

status
Optional. open, triggered or expired.
start, limit, author
Optional paging and a filter by author address.
signals[]
id, symbol, cmp, threshold, status, due, expiry, createdAt, triggeredAt, triggerPrice, endorsements, boardId, text, author. With a status filter the answer also carries scanned and truncated: how many rows were looked at, and whether the scan stopped before the end of the list.
feeds[]
The symbols that have a Chainlink feed.

Example response

{
  "ready": true,
  "count": 1,
  "signals": [
    { "id": 1, "symbol": "NVDA", "cmp": "below", "threshold": 180,
      "status": "open", "expiry": 1798675200000, "endorsements": 2,
      "text": "NVDA below $180 before Dec 31" }
  ],
  "feeds": ["NVDA", "AAPL", "TSLA"]
}
GET/api/agent/mandates?status=open

Agent mandates. Keepers use status=ready to find the ones whose condition holds now.

status
Optional. open, ready, executed, cancelled or expired.
owner, start, limit
Optional filter by owner address, and paging.
mandates[]
id, symbol, side, cmp, threshold, amountIn, slippageBps, feeBps, tipEth, status, due, expiry, route, amountOut, execPrice, owner. With a status filter the answer also carries scanned and truncated.

Example response

{
  "ready": true,
  "count": 1,
  "mandates": [
    { "id": 1, "symbol": "NVDA", "side": "buy", "cmp": "below",
      "threshold": 180, "amountIn": 50, "slippageBps": 100,
      "tipEth": 0.00002, "status": "open", "route": "USDG > NVDA 0.05%" }
  ]
}

In every list, ready says whether the list could be read from the chain, and count is the total on chain.

Browser tools

In browsers that expose WebMCP, the studio registers four tools: read_snapshot, add_widget, set_asset and propose_mandate. The last one only opens the mandate form. Nothing is signed until you approve it in your wallet.

Questions

Do I need an account?

No. Your wallet is the login. Boards are saved in your browser under that address until you publish them.

Which network is this?

Robinhood Chain mainnet, chain id 4663. The studio offers one click to add it and switch.

Can the agent trade without me?

No. The research agent only proposes board changes, and you accept or reject each one. A mandate runs the single rule you signed, with the funds you escrowed, and you can cancel it anytime.

Who runs a mandate?

Any wallet. When the Chainlink feed meets the condition, whoever runs the mandate earns the ETH tip you attached. The result of the swap always goes to you.

What does it cost?

Reading is free. Publishing a board, posting a signal and creating a mandate cost network gas. A mandate takes 0.10% of its amount when it runs. Swaps pay the pool fee of the route.

What if a price looks wrong?

Open the health chip in the studio toolbar. It lists each feed group with its block and age. Every widget also shows its source and the time it was read.

Is this investment advice?

No. BrainDev shows on-chain data and records what you decide. Conditions prompt research. Mandates execute only what you signed.