Documentation

Overview

A stock brain is one Robinhood stock token on Robinhood Chain (chain 4663), read live from every Uniswap v3 pool it trades in. One Multicall3 call reads the price, liquidity, both balances and the 30 minute time-weighted average of every pool of every stock token in the universe, plus the WETH/USDG pool that turns WETH prices into dollars. From that one read each brain works out a price, its drift, its spread, its depth and a plain read.

A basket brain weights up to eight stock brains in basis points. You can price any basket over the API, and you can publish one to the BrainStudio contract so others can rent it by the day.

Quick start

curl https://brainstocks.network/api/v1/brains/NVDA

const res = await fetch("https://brainstocks.network/api/v1/brains/NVDA");
const { block, brain } = await res.json();
console.log(block, brain.priceUsd, brain.read, brain.why);

Brain API endpoints

Base URL https://brainstocks.network/api/v1. Every endpoint is a plain GET that answers JSON, needs no key and allows any origin.

Fields

Reads and rules

A pool is live when both of its sides hold at least $200 and it has liquidity at its current price. The read is the first rule that matches, in this order. The thresholds come back in every answer under rules.

A read describes the pools at one block. It is not a forecast and not advice.

Basket brains

Write a basket as SYMBOL:WEIGHT pairs joined by commas: 1 to 8 legs, whole basis points above 0, adding up to exactly 10000, no stock twice. The answer prices it as an index that is 100 at the 30 minute average:

index = 100 * sum(weight * priceUsd / twapUsd)
capacityUsd = min over legs of depthUsd / weight

capacityUsd is roughly how many dollars the whole basket could move before its thinnest leg runs out of depth. thin lists legs that read thin or offline.

Errors and limits

Errors answer {"ok": false, "error": "..."} in plain words: 400 for a bad basket, 404 for an unknown symbol, 502 when the chain did not answer in time. Answers are computed at most once every twelve seconds and cached at the edge for ten, so polling faster than that returns the same block.

BrainStudio contract

BrainStudio is a registry on Robinhood Chain. Anyone can deploy a basket brain: a name, 1 to 8 stock tokens from the allow-list, weights in basis points adding up to 10000, and a daily price in ETH (zero for free). Anyone can rent a brain for 1 to 365 days by paying exactly the price times the days. A rental extends the one you already hold. The creator is credited 95% and the BrainStocks treasury 5% (the fee is read from the contract and capped at 10%), and both withdraw on their own. The owner can change the allow-list, the fee (up to the cap) and the treasury, and can never move anyone's balance.

Functions

Events

BrainDeployed, Rented, PriceSet, Retired, Withdrawn, StockSet, plus the ownership and fee events. The site reads state through view functions and never needs to scan logs.

Robinhood Chain

The console adds the chain to your wallet when you connect, if it is not there yet.