# three.ws Mint-to-Mesh Batch

> three.ws Mint-to-Mesh Batch is a paid API for AI agents from three.ws, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Resolves 1–10 Solana SPL mint addresses to themed binary glTF cube meshes (GLB) in a single paid batch call, returning base64-encoded GLB bytes per mint.

## Facts

- Endpoint: POST https://three.ws/api/x402/mint-to-mesh-batch
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-16961dea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_53Az2ZVbQmdxU3g3ZF4Ih

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 three-ws-16961dea -d '<json body>'
```

Example prompt: Convert these 5 Solana SPL mint addresses into 3D glTF cubes for me in one batch call: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v, So11111111111111111111111111111111111111112, mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So, 7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs, DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 — I need base64-encoded GLB output ready for Three.js.

## When to prefer this

Use this endpoint when you need to convert multiple Solana SPL mint addresses (up to 10) into ready-to-render 3D glTF cube assets in a single network call. Prefer it over single-mint resolution when you have 2–10 mints to process simultaneously and want parallel processing with per-mint fault isolation. Ideal for 3D token explorers, NFT galleries, or any agent embedding Solana token visuals into a Three.js/Babylon.js/model-viewer scene.

## Known failure modes

- Invalid or non-existent Solana mint address — individual mint returns ok:false with error detail
- Solana RPC unreachable — affected mint(s) return ok:false, rest of batch succeeds
- Off-chain metadata URL returns 404 — affected mint returns ok:false
- Batch size exceeds 10 mints — likely 400 error or rejection
- Payment failure (USDC x402) — entire call fails before processing
- Malformed request body — 400/422 validation error

## How this service works

three.ws Mint-to-Mesh (Batch) — resolve 1–10 Solana SPL mints to themed binary glTF cubes in a single paid call. Each mint is processed in parallel; per-mint failures (bad mint, RPC unreachable, off-chain metadata 404) report ok:false individually rather than failing the whole batch. Output is base64 JSON-safe GLB bytes ready for Three.js / Babylon.js / model-viewer.

## Output

An array of per-mint results, each containing either base64-encoded GLB bytes of a themed glTF cube mesh ready for Three.js/Babylon.js/model-viewer, or an ok:false error object if the individual mint failed (bad mint address, RPC unreachable, or off-chain metadata 404).

## Example request

```json
{
 "mints": [
  "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "So11111111111111111111111111111111111111112",
  "mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So"
 ]
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mints": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 44,
    "minLength": 32
   },
   "maxItems": 10,
   "minItems": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 2,
  "results": [
   {
    "ok": true,
    "glb": {
     "bytes": 583452,
     "base64": "Z2xURgIAAAAc5wgA...",
     "mimeType": "model/gltf-binary"
    },
    "mint": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump",
    "theme": {
     "name": "three.ws",
     "color": [
      0.235,
      0.382,
      0.865
     ],
     "symbol": "three",
     "hasImage": true
    }
   },
   {
    "ok": false,
    "mint": "THREEsynthetic1111111111111111111111111111",
    "error": "invalid_mint",
    "error_description": "invalid mint address"
   }
  ],
  "indexed_at": "2026-05-14T17:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-16961dea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from three.ws](https://www.zero.xyz/host/three.ws/llms.txt)