# ForgeMesh Stock Token Info

> ForgeMesh Stock Token Info is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Returns on-chain metadata for a Robinhood Chain stock token by ticker symbol, including contract address, ERC-20 details, total supply, and oracle price snapshot.

## Facts

- Endpoint: POST https://x402.forgemesh.io/stock-token-info
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-stock-token-info-b293fcb9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZPTDtKemxY24OneO--3kV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability forgemesh-stock-token-info-b293fcb9 -d '<json body>'
```

Example prompt: What are the on-chain details for the NVDA stock token on Robinhood Chain — I need the contract address, total supply, decimals, and current oracle price?

## When to prefer this

Use this endpoint when you need authoritative on-chain metadata for a tokenized stock on Robinhood Chain, including contract address verification, supply figures, and oracle-sourced price data. Prefer this over general stock price APIs when the use case specifically involves blockchain/DeFi context, smart contract integration, or verifying token authenticity on-chain.

## Known failure modes

- Unknown or unsupported ticker symbol returns an error or empty result
- Network or chain node unavailability may cause timeouts
- Stale oracle data if the price snapshot has not been recently updated
- Malformed symbol input (though case-insensitive matching is applied)

## How this service works

On-chain metadata for a Robinhood Chain stock token: verified contract address, ERC-20 name and decimals, total supply in both raw and human units, plus the token's oracle price snapshot. Case-insensitive symbol matching; large integers returned as strings to survive JSON round-trips without precision loss.

## Output

Returns verified ERC-20 contract address, token name, decimals, total supply in raw and human-readable units, and an oracle price snapshot for the requested stock ticker token on Robinhood Chain. Large integers are returned as strings to preserve precision.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "symbol": {
   "type": "string",
   "description": "Ticker symbol, e.g. AAPL, NVDA, SPY (case-insensitive)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "kind": "stock",
  "found": true,
  "price": {
   "usd": "328.93373112",
   "stale": false,
   "updated_at": "2026-07-16T00:37:55.000Z"
  },
  "token": {
   "address": "0xaF3D76f1834A1d425780943C99Ea8A608f8a93f9",
   "decimals": 18
  },
  "symbol": "AAPL"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-stock-token-info-b293fcb9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)