# Spraay Gateway Multi-Chain Token Portfolio

> Spraay Gateway Multi-Chain Token Portfolio is a paid API for AI agents from gateway.spraay.app, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-13).

Returns a multi-chain token portfolio (native tokens + ERC-20s) with USD values for a given wallet address

## Facts

- Endpoint: GET https://gateway.spraay.app/api/v1/portfolio/tokens
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gateway-spraay-app-5687c7f4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_r8oE5udybvw2kcFFikQYe

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 gateway-spraay-app-5687c7f4
```

Example prompt: What tokens does wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e hold across all chains, including ERC-20s and native tokens, and what's the total USD value?

## When to prefer this

Use this endpoint when you need a comprehensive, cross-chain view of all token holdings (both native and ERC-20) for a single wallet address, complete with current USD valuations. Prefer this over chain-specific balance endpoints when multi-chain aggregation and fiat valuation are both required in a single call.

## Known failure modes

- Invalid or malformed wallet address returns an error response
- Unsupported network identifier returns an empty or error result
- Rate limiting or payment failure (x402) returns 402 Payment Required
- Network timeout when querying multiple chains returns partial or error data
- Address with no holdings returns empty token array and zero USD value

## How this service works

Multi-chain token portfolio (native + ERC-20) with USD values.

## Output

Returns a JSON object containing the queried wallet address, an array of tokens (each with name, symbol, balance, network, and USD value), the total token count, and the aggregate total USD value across all tokens and chains.

## 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": {
      "address": {
       "type": "string"
      },
      "networks": {
       "type": "string"
      },
      "includeErc20": {
       "type": "boolean"
      },
      "includeNative": {
       "type": "boolean"
      },
      "includePrices": {
       "type": "boolean"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "tokens": {
       "type": "array"
      },
      "address": {
       "type": "string"
      },
      "token_count": {
       "type": "number"
      },
      "total_usd_value": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gateway-spraay-app-5687c7f4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.spraay.app](https://www.zero.xyz/host/gateway.spraay.app/llms.txt)