# AgentKit Data – Solana Wallet Portfolio Snapshot

> AgentKit Data – Solana Wallet Portfolio Snapshot is a paid API for AI agents from x402-apis-production.up.railway.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-20).

Returns a complete Solana wallet portfolio: SOL balance, every SPL/Token-2022 token holding aggregated by mint, USD prices, USD values, frozen status, and total portfolio value sorted by value.

## Facts

- Endpoint: GET https://x402-apis-production.up.railway.app/v1/solana/wallet?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentkit-data-solana-wallet-portfolio-snapshot-9a63b4e4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GDiYjCS9gW9N8gpr14GED

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 agentkit-data-solana-wallet-portfolio-snapshot-9a63b4e4
```

Example prompt: Pull a full portfolio snapshot for the Solana wallet vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg — I want the SOL balance, every SPL token holding with its USD price and value, and the total portfolio value in USD.

## When to prefer this

Choose this endpoint when you need a complete, USD-priced portfolio snapshot of any Solana wallet in a single call — covering both native SOL and all SPL/Token-2022 holdings. It is ideal for portfolio dashboards, whale watching, DeFi analytics, or any agent workflow that needs to know the current value and composition of a Solana wallet without assembling multiple RPC calls. Prefer it over raw Solana RPC queries when USD pricing and aggregation by mint are needed out of the box.

## Known failure modes

- Invalid or malformed Base58 wallet address returns an error response
- Wallet address not found on Solana mainnet returns empty or error
- Tokens with no price data are excluded from pricedTokens count and usdValue may be zero
- limit parameter out of range (not 1-500) may cause a validation error
- Network timeout or RPC unavailability results in a 5xx error
- includeZero not set to 'true' means empty token accounts are excluded by default

## How this service works

Pay-per-call data APIs. Each call is paid with USDC on Base via x402 (HTTP 402). No account or API key.

## Output

A JSON object containing the SOL balance (amount, USD price, USD value), an array of token holdings (each with mint address, amount, decimals, frozen status, program type, number of accounts, USD price, and USD value), the wallet address, total token count, number of priced tokens, and total portfolio USD value. Tokens are sorted by USD value descending.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "limit": {
       "type": "string",
       "description": "Max tokens returned (1-500, default 100)"
      },
      "address": {
       "type": "string",
       "description": "Base58 wallet address"
      },
      "includeZero": {
       "enum": [
        "true",
        "false"
       ],
       "type": "string",
       "description": "Include empty token accounts"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "sol": {
   "amount": 1.25,
   "usdPrice": 104.2,
   "usdValue": 130.25
  },
  "tokens": [
   {
    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": 50,
    "frozen": false,
    "program": "spl-token",
    "accounts": 1,
    "decimals": 6,
    "usdPrice": 1,
    "usdValue": 50
   }
  ],
  "address": "vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg",
  "tokenCount": 1,
  "pricedTokens": 1,
  "totalUsdValue": 180.25
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentkit-data-solana-wallet-portfolio-snapshot-9a63b4e4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-apis-production.up.railway.app](https://www.zero.xyz/host/x402-apis-production.up.railway.app/llms.txt)
