Documentation
AstroMax is a read-only research agent for Robinhood Chain and US equities. This page explains what it does, where every fact comes from, how the AI layer is constrained, and what it deliberately does not claim.
AstroMax answers research questions about contracts, tokens, NFTs and US stocks with facts retrieved from public sources. It is read-only: it never sends transactions, never requests a signature, and works without a wallet. Public research needs no account.
AstroMax is an independent tool. It is not an official OpenAI or Robinhood product and is not affiliated with or endorsed by either company.
Validate an address, confirm bytecode exists, and read token metadata, ownership signals, proxy slots, and every view function exposed by a verified ABI. Results are pinned to a block.
Search by ticker or company, read the last quote with its exchange timestamp, and chart real historical prices. Delayed, previous-close, and stale data are labeled as such.
Look up a token by address, see which pool supplies its price, inspect every indexed pool, and read liquidity, volume, and pool age from indexers that cover Robinhood Chain.
Detect the standard, resolve tokenURI or uri with correct {id} substitution, fetch metadata through hardened gateways, and check ownerOf or balanceOf for a wallet.
Every result names its source, the fetch time and, for chain reads, the block. These are the providers behind each fact.
You provide an address, a symbol, a token id or a question. Inputs are validated before anything is fetched.
Providers supply the facts: RPC reads pinned to a block, verification matches, indexed pools, quotes with timestamps.
Deterministic checks run in code: interface detection, proxy slots, selector scans, liquidity thresholds. No model is involved.
When configured, the AI only interprets the retrieved results. It must cite them, cannot invent values, and its model id is shown.
Without an AI key every screen still works; only the natural-language summary is absent, and the interface says so.
Checks are deterministic observations (a selector is present, a slot is set, a call reverted). They describe what was seen at one block and never rate a contract as safe.
When a provider does not return a field, AstroMax shows a dash and lists the field under "Not returned by the source". It never substitutes 0.
A reverted or timed-out call means the fact could not be determined, not that the condition is false. Unreachable and nonexistent are reported separately.
Fully diluted value uses total supply. Market cap needs a circulating-supply figure; when no source supplies one, market cap is not shown.
Stock prices carry the provider's quote timestamp separately from the fetch time. Outside regular sessions the price is the previous close and is labelled that way.
Pool indexers cover a subset of Robinhood Chain liquidity. A token with no indexed pool is "not indexed", not worthless, and rankings publish their formula and coverage.
ownerOf applies to ERC-721 only. For ERC-1155 the reader reports balanceOf for a wallet you supply.
Token metadata comes from third-party servers. It is rendered as plain text, media is proxied and sanitised, and nothing in it is treated as a fact about the chain.
Every variable is optional. Without keys, chain reads and pool data work through public endpoints; stocks and AI show honest “not configured” states. Names and purposes are listed here; values are never exposed, and the status page reports only presence.
| Name | Purpose | Required for |
|---|---|---|
| ROBINHOOD_RPC_URL | Dedicated mainnet JSON-RPC endpoint (server-only). The public endpoint is used when empty. | Optional |
| ROBINHOOD_TESTNET_RPC_URL | Dedicated testnet JSON-RPC endpoint (server-only). The public endpoint is used when empty. | Optional |
| OPENAI_API_KEY | Credential for the AI engine (server-only). | AI summaries and the research chat |
| OPENAI_MODEL | Exact model id passed to the API. No default; the deployment must opt in explicitly. | AI summaries and the research chat |
| OPENAI_REASONING_EFFORT | low | medium | high. Defaults to low. | Optional |
| AI_DAILY_REQUEST_BUDGET | Maximum AI answers per UTC day for this deployment. Defaults to 400. | Optional (spending control) |
| TWELVEDATA_API_KEY | Twelve Data credential for a licensed US equity feed (server-only). Without it the US Stock Monitor uses Yahoo Finance's unofficial key-free endpoint and says so on every result. | Optional (licensed stock feed) |
| UPSTASH_REDIS_REST_URL | Upstash Redis REST endpoint for durable rate limits and the AI budget counter. | Recommended in production |
| UPSTASH_REDIS_REST_TOKEN | Upstash Redis REST token. | Recommended in production |
| IPFS_GATEWAYS | Comma-separated IPFS gateways tried in order for NFT metadata and media. | Optional (defaults provided) |
| ARWEAVE_GATEWAYS | Comma-separated Arweave gateways tried in order. | Optional (defaults provided) |
| NEXT_PUBLIC_ASTRO_TOKEN_ADDRESS | $ASTRO contract address on Robinhood Chain. Empty shows "CA: Soon"; set with npm run token:ca. | Token section on the landing page |
| NEXT_PUBLIC_SITE_URL | Public site URL used for metadata and social cards. | Optional |
| ASTROMAX_DEV_FIXTURES | Enables explicitly labelled development fixtures. Never active in production builds. | Development only |
Only two networks are supported. Testnet data is never presented as real-value market data; pool indexers are wired for mainnet only.
The public endpoint is rate limited. A dedicated provider can be set server-side with ROBINHOOD_RPC_URL.
The public endpoint is rate limited. A dedicated provider can be set server-side with ROBINHOOD_TESTNET_RPC_URL.
The watchlist lives in your browser’s local storage. It is never uploaded, synced or tied to an account; export it as JSON if you want to move it.
The server does not store your queries. Requests pass through a rate limiter that keeps short-lived counters keyed by client address, and an AI budget counter that stores only a daily total. No addresses, symbols or questions are logged beyond that.