# Tollex Stock Token Metadata Lookup

> Tollex Stock Token Metadata Lookup is a paid API for AI agents from api.tollex.org, paid per call via x402, $0.0079/call, status unknown (last checked 2026-10-11).

Returns metadata for a stock token (tokenized equity) given its ticker symbol, paid via x402 micropayment in USDC.

## Facts

- Endpoint: POST https://api.tollex.org/tools/stock_token_metadata?utm_source=zero.xyz
- Price: $0.0079/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tollex-stock-token-metadata-lookup-f31d8a65
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_V_T7yyPVRYjqSZMUQF8kB

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 tollex-stock-token-metadata-lookup-f31d8a65 -d '<json body>'
```

Example prompt: Can you pull up the stock token metadata for TSLA — I want to see what's available about the tokenized version of Tesla shares?

## When to prefer this

Choose this endpoint when you need on-chain or token-layer metadata for a stock symbol — specifically when working with tokenized equities on Base or Robinhood Chain — rather than traditional market data APIs that return price quotes or fundamentals. It is ideal for DeFi agents that need contract addresses, token identifiers, or blockchain-layer asset details before executing tokenized stock trades or building on-chain portfolio tools.

## Known failure modes

- Invalid or unrecognized ticker symbol returns an error or empty result
- Symbol format does not match pattern (must be uppercase, 1-10 chars starting with a letter) causes validation rejection
- Payment failure via x402 protocol results in 402 response with no data returned
- Ticker exists as an equity but has no tokenized representation, returning a not-found error
- Network or provider downtime causes timeout or 503 response

## How this service works

Tollex lets software agents buy APIs and tools under rules you set: it finds a capability that fits, checks your policy before anything is signed, pays with x402 in USDC on Base or USDG on Robinhood Chain, reconciles uncertain payments and returns a signed receipt.

## Output

A structured metadata object describing the tokenized version of the requested stock, including token name, contract details, asset identifiers, and other relevant on-chain information associated with the given ticker symbol.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "symbol": {
   "type": "string",
   "pattern": "^[A-Z][A-Z0-9.]{0,9}$"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": {
   "id": "stock_token_metadata",
   "version": "1.0.0",
   "provider": "tollex.robinhood-chain"
  },
  "result": {
   "onchain": {
    "symbol": "AAPL",
    "decimals": 18
   },
   "registry": {
    "name": "Apple",
    "symbol": "AAPL"
   }
  },
  "evidence": [],
  "untrustedOutput": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tollex-stock-token-metadata-lookup-f31d8a65/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tollex.org](https://www.zero.xyz/host/api.tollex.org/llms.txt)