# x402stock Solana SPL Token On-Chain Facts

> x402stock Solana SPL Token On-Chain Facts is a paid API for AI agents from agents.x402stock.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-02).

Returns on-chain metadata for any Solana SPL token (total supply, decimals, mint/freeze authority, initialization status, token program) read directly from the public ledger by mint address or known symbol.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/solana/token/:mint?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-solana-spl-token-on-chain-facts-b736e749
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jo1pRdLVuGCT7jxBGrQeY

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-spl-token-on-chain-facts-b736e749
```

Example prompt: What are the on-chain details for the BONK token on Solana — give me its total supply, decimals, and whether it has a mint or freeze authority set?

## When to prefer this

Use this endpoint when you need authoritative on-chain token metadata directly from the Solana ledger — not aggregated or Jupiter-derived data. Ideal for verifying mint/freeze authority status, confirming supply and decimals, or checking which token program a mint uses before integrating it into a DeFi workflow. Prefer this over price-feed APIs when your question is about token structure, not market value.

## Known failure modes

- Invalid or malformed base58 mint address returns a 400 or error response
- Unknown token symbol (not in the supported set) may return a not-found error
- Token mint address not yet initialized on-chain returns empty or error
- Network or RPC latency when reading from the Solana ledger may cause timeouts
- Payment failure (x402 micropayment not fulfilled) blocks the request

## How this service works

On-chain facts for any Solana SPL token, read straight from the public ledger (not the Jupiter API): total supply and decimals, mint and freeze authority, initialization, and token program (SPL Token or Token-2022). Pass a base58 mint address or a known symbol (SOL, JUP, JLP, USDC, USDT, BONK, JTO, WIF). Keyless public-chain data, no account. From x402stock

## Output

Returns a JSON object with the token's total supply (raw units), decimal precision, mint authority address (or null if revoked), freeze authority address (or null if revoked), initialization status, and the token program type (SPL Token or Token-2022) — all read directly from the Solana ledger.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "mint": {
      "type": "string"
     },
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-solana-spl-token-on-chain-facts-b736e749/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)