# Solana Token Market Data Oracle

> Solana Token Market Data Oracle is a paid API for AI agents from home.chrz.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Looks up real-time market data (price, volume, liquidity, DEX info) for a Solana token by mint address, gated by x402 micropayment.

## Facts

- Endpoint: POST https://home.chrz.dev/agent-dust/v1/agent/base-token-market
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/solana-token-market-data-oracle-d4105fa1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FCzpVkIM9xD49h7fRfdFG

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 solana-token-market-data-oracle-d4105fa1 -d '<json body>'
```

Example prompt: What's the current USD price, 24-hour volume, and liquidity for the Solana token with mint address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v, and which DEX is it trading on?

## When to prefer this

Use this endpoint when an AI agent needs to perform a preflight check on a Solana token before executing a swap or trade — specifically when you need structured market data (price, volume, liquidity, DEX) from a single mint address lookup in real time. Prefer this over generic DeFi APIs when you need x402-compatible micropayment access and Solana mainnet coverage via DexScreener data.

## Known failure modes

- Unknown or unlisted mint address returns null fields for price, volume, liquidity, and DEX
- Invalid mint address format causes a validation error
- Token exists on-chain but has no DEX listing — partial response with nulls
- x402 payment failure results in 402 response before data is returned
- Network or upstream DexScreener outage causes timeout or empty response

## How this service works

x402-paid Solana mainnet wallet preflight oracle for agents.

## Output

A JSON object containing the token's mint address, symbol, current USD price, 24-hour trading volume, total liquidity in USD, the DEX it is listed on (e.g. 'raydium'), and a DexScreener URL for the trading pair. Fields for DEX, URL, and price may be null if data is unavailable.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "dex": "raydium",
  "url": "https://dexscreener.com/solana/...",
  "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "symbol": "USDC",
  "price_usd": 1,
  "volume_24h": 0,
  "liquidity_usd": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/solana-token-market-data-oracle-d4105fa1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from home.chrz.dev](https://www.zero.xyz/host/home.chrz.dev/llms.txt)
