Docs.

Read a price correctly

// Read any Robinhood Chain stock price correctly. ethers v6.
// Get the feed proxy from gitstock: GET /<SYMBOL>/stock.json → feed.proxy
import { ethers } from "ethers";
const feed = new ethers.Contract(feedProxy, [
  "function latestRoundData() view returns (uint80,int256,uint256,uint256,uint80)",
  "function decimals() view returns (uint8)"
], provider);

const dec = await feed.decimals();        // read it, don't hardcode
const rd  = await feed.latestRoundData();
const price = Number(ethers.formatUnits(rd.answer, dec)); // token price (stock × multiplier)
const stale = now - Number(rd.updatedAt) > 86400;      // 24h heartbeat = the guard
// do NOT gate on the L2 sequencer feed — it's hardwired to 'down' on this chain.

Prefer viem?

// Same read, with viem
import { createPublicClient, http, parseAbi } from "viem";

const client = createPublicClient({ transport: http(RPC) });
const abi = parseAbi([
  "function latestRoundData() view returns (uint80,int256,uint256,uint256,uint80)",
  "function decimals() view returns (uint8)"
]);

const [, answer, , updatedAt] = await client.readContract({
  address: feedProxy, abi, functionName: "latestRoundData" });
const dec = await client.readContract({ address: feedProxy, abi, functionName: "decimals" });

const price = Number(answer) / 10 ** dec;   // token price — already × uiMultiplier
const stale = now - Number(updatedAt) > 86400; // the real guard

React (wagmi)

// React — wagmi, ticking every 30s
const { data } = useReadContract({
  address: feedProxy,
  abi,
  functionName: "latestRoundData",
  query: { refetchInterval: 30_000 },
});

README badge

A live price badge for your repo — refreshes every few minutes, links back to the token's page.

<!-- live price badge for your README — swap NVDA for any symbol -->
[![NVDA](https://gitstock.io/NVDA/badge.svg)](https://gitstock.io/NVDA)

The SDK

Everything below, wrapped: npmjs.com/package/gitstock — typed, zero dependencies, plus the on-chain constants (FEED_ABI, ADDRESSES, isStale).

# zero-dep client — works in Node ≥18, browsers, edge
npm i gitstock

import { getStock, getRegistry, isStale, FEED_ABI, ADDRESSES } from "gitstock";

const nvda = await getStock("NVDA");
nvda.price.usd     // guarded live price (already stock × multiplier)
nvda.feed.proxy    // canonical Chainlink proxy for on-chain reads
nvda.fieldNotes    // the quirks that break integrations

const { tokens } = await getRegistry(); // all factory-verified tokens

Consume gitstock (no RPC)

Every token is machine-readable. Point at these and skip the on-chain plumbing entirely.

// One token, fully resolved (no RPC):
GET https://gitstock.io/NVDA/stock.json

// The whole registry (all tokens, addresses, feed proxies):
GET https://gitstock.io/registry.json

// Watch new tokens pairing against stocks (newest first):
GET https://gitstock.io/dependents.json

// The guarded price series (30-day retention):
GET https://gitstock.io/NVDA/history.json

/<SYMBOL>/stock.json returns metadata, guarded live price, holders, pool TVL, dependents, field notes and the sequencer state. /registry.json lists every token with its canonical feed proxy. /<SYMBOL>/history.json returns the indexed price series. CORS is open — fetch these from any origin, browser or server. Also: /llms.txt for AI assistants, /dependents.rss to watch new pairings in your feed reader.

Verify it yourself

Don't trust gitstock either. Every real stock token was created by the factory below — match the token's TokenCreated event, never a symbol. Impostor tokens with identical tickers exist on this chain.

The quirks — what the docs don't tell you