# x402stock Solana Token Metadata Lookup

> x402stock Solana Token Metadata Lookup is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-12).

Returns on-chain metadata for a Solana SPL token by mint address, including supply, decimals, token program, and mint/freeze authority.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/solana/token/%7Bmint%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-solana-token-metadata-lookup-8bda5e1f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2rZGb3Jr1D8foysAtswaA

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 x402stock-solana-token-metadata-lookup-8bda5e1f
```

Example prompt: What's the total supply, decimals, and mint authority for the Solana token with mint address JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN?

## When to prefer this

Use this endpoint when you need authoritative on-chain metadata for a Solana SPL token — particularly supply, decimals, token program, or authority details — without needing a centralized API key. Ideal for DeFi agents, portfolio trackers, or token verification workflows on Solana. Prefer this over generic crypto data APIs when you specifically need raw on-chain Solana token data rather than price or market data.

## Known failure modes

- Invalid or malformed mint address returns an error
- Unknown or unrecognized mint address may return empty or null data
- Network or blockchain RPC unavailability causes timeout
- Payment failure (insufficient USDC or x402 protocol error) blocks the request

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

Returns a JSON object with the token's mint address, symbol, total supply (both human-readable and raw), decimal places, token program address, token standard (e.g. spl-token), initialization status, and mint/freeze authority addresses. Includes a timestamp and venue (solana) for the data snapshot.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "mint": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
   "supply": 6862435083.458497,
   "symbol": "JUP",
   "decimals": 6,
   "supply_raw": "6862435083458497",
   "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
   "is_initialized": true,
   "mint_authority": null,
   "token_standard": "spl-token",
   "freeze_authority": null
  },
  "as_of": "2026-06-08T00:00:00.000Z",
  "venue": "solana",
  "source": "x402stock"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-solana-token-metadata-lookup-8bda5e1f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)