# meld402 Solana Token Report

> meld402 Solana Token Report is a paid API for AI agents from meld402.vercel.app, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Returns a comprehensive on-chain and market report for a Solana SPL token, including price, supply, holders, liquidity, and 24h price history, aggregated from multiple sources.

## Facts

- Endpoint: POST https://meld402.vercel.app/api/solana/token-report
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/meld402-solana-token-report-656de066
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_78JnGCrhcL08vL6hiHXM_

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 meld402-solana-token-report-656de066 -d '<json body>'
```

Example prompt: Pull a full token report for the Solana mint address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v — include the top holders and 24-hour price history.

## When to prefer this

Choose this endpoint when you need a comprehensive, multi-dimensional report on a Solana SPL token in a single API call — combining price, holders, liquidity, volume, price history, and social data that would otherwise require multiple separate API integrations. It is especially useful for agents that need to evaluate token quality, check concentration risk, or track market activity on Solana without managing multiple data provider keys. The x402/USDC micropayment model makes it suitable for pay-per-use agent pipelines where subscription overhead is undesirable.

## Known failure modes

- Invalid or malformed mint address returns an error — address must be 32-44 characters
- Unknown or very new token addresses may return no data if not indexed by Birdeye
- Upstream source degradation: the 'meta.degraded' field may indicate partial data if Birdeye is unavailable
- Payment failure via x402/USDC will block the request before data is returned
- Rate limits or provider outages may cause timeouts or empty responses

## How this service works

14 paid data endpoints for autonomous agents and developers. Covers crypto intelligence (token, chain, Solana, gas), markets (FX, market pulse), location (weather), and research (news, brief). Each route aggregates multiple public sources into one stable schema with a single USDC payment over x402 on Base.

## Output

A JSON object containing the token's name, symbol, mint address, decimals, current USD price, market cap, liquidity, 24h volume, supply, price change percentages (1h, 24h, 30d), social metadata (Twitter, website, description), an array of top holders with rank/address/amount/percentage, an optional array of 24h price history data points (timestamp, price, volume, market cap), the data source attribution, and an 'as_of' timestamp indicating when the data was collected.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "maxLength": 44,
   "minLength": 32,
   "description": "SPL token mint address"
  },
  "include_holders": {
   "type": "boolean",
   "default": true,
   "description": "Include top holders"
  },
  "include_price_history": {
   "type": "boolean",
   "default": true,
   "description": "Include 24h price history"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "name": "USD Coin",
   "supply": 35000000000,
   "symbol": "USDC",
   "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
   "socials": {
    "twitter": "https://twitter.com/centre",
    "website": "https://www.centre.io/usdc",
    "description": "USDC is a fully reserved stablecoin."
   },
   "decimals": 6,
   "price_usd": 1,
   "top_holders": [
    {
     "rank": 1,
     "amount": 5000000000,
     "address": "5t...1",
     "percentage": 14.3
    },
    {
     "rank": 2,
     "amount": 3000000000,
     "address": "7x...2",
     "percentage": 8.6
    }
   ],
   "last_updated": "2026-08-23T21:00:00.000Z",
   "liquidity_usd": 1200000000,
   "market_cap_usd": 35000000000,
   "volume_24h_usd": 5000000000,
   "price_history_24h": [
    {
     "price": 1,
     "volume": 200000000,
     "timestamp": "2026-08-23T00:00:00.000Z",
     "market_cap": 35000000000
    },
    {
     "price": 1,
     "volume": 150000000,
     "timestamp": "2026-08-23T12:00:00.000Z",
     "market_cap": 35000000000
    }
   ],
   "price_change_1h_percent": 0,
   "price_change_24h_percent": 0.01,
   "price_change_30d_percent": 0.05
  },
  "meta": {
   "as_of": "2026-08-24T00:00:00.000Z",
   "sources": [
    "birdeye"
   ],
   "degraded": [],
   "attribution": [
    "Token data by Birdeye (birdeye.so)"
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/meld402-solana-token-report-656de066/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from meld402.vercel.app](https://www.zero.xyz/host/meld402.vercel.app/llms.txt)