# three.ws Skill Call API

> three.ws Skill Call API is a paid API for AI agents from three.ws, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Fetches a skill definition (tools, content, metadata) from the three.ws marketplace by skill slug, charged per call via x402 micropayment

## Facts

- Endpoint: GET https://three.ws/api/x402/skill-call
- Price: $0.01/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-skill-call-api-79399628
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IupZHGs2n0QuPJn_XZAfm

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-skill-call-api-79399628
```

Example prompt: Pull the skill definition for 'wallet-balance' from the three.ws marketplace — I need its tool specs and content so I can wire it into my agent.

## When to prefer this

Use this endpoint when you need to dynamically load a named skill's tool definitions and content from the three.ws marketplace at runtime, especially when building or orchestrating 3D AI agents that need to discover available capabilities on demand. Prefer this over hardcoding skill specs, or when you need to pay-per-use rather than subscribing.

## Known failure modes

- Invalid or unknown skill slug returns an error or empty result
- Missing required 'skill' query parameter causes a 400-level error
- x402 payment not provided or insufficient causes a 402 Payment Required response
- Network timeout if the marketplace backend is slow
- Skill may be deprecated or removed from catalog, returning not-found

## How this service works

Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.

## Output

Returns a JSON object with ok:true, the skill's id/slug/name/category/description, an array of tool function definitions (type, function name, description), the skill's markdown content, and a calledAt timestamp. Costs $0.01 USDC per call via x402.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "skill"
     ],
     "properties": {
      "skill": {
       "type": "string",
       "maxLength": 128,
       "minLength": 1,
       "description": "Unique skill slug from the marketplace_skills catalog."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "ok",
      "skill",
      "calledAt"
     ],
     "properties": {
      "ok": {
       "type": "boolean",
       "const": true
      },
      "skill": {
       "type": "object",
       "required": [
        "id",
        "slug",
        "name"
       ],
       "properties": {
        "id": {
         "type": "string"
        },
        "name": {
         "type": "string"
        },
        "slug": {
         "type": "string"
        },
        "category": {
         "type": "string"
        },
        "description": {
         "type": "string"
        }
       }
      },
      "tools": {
       "type": "array",
       "items": {
        "type": "object"
       }
      },
      "content": {
       "type": "string"
      },
      "calledAt": {
       "type": "string",
       "format": "date-time"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "skill": {
   "id": "fc504e4a-6667-4757-9157-2bcc35434e6c",
   "name": "Wallet Balance",
   "slug": "wallet-balance",
   "category": "crypto",
   "description": "Check ETH and ERC-20 token balances for any Ethereum address."
  },
  "tools": [
   {
    "type": "function",
    "function": {
     "name": "get_balance",
     "description": "Fetch balances."
    }
   }
  ],
  "content": "# Wallet Balance\n\nUse get_balance to fetch ...",
  "calledAt": "2026-05-31T18:48:09.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-skill-call-api-79399628/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)