agent_example

POST /agents/agent_example/run — Single-turn Claude Sonnet inference endpoint. Input: {question: string, max_tokens: integer (default 1024)}. Output: {success, answer, usage: {input_tokens, output_tokens}, error}. No tool use or agentic loop — direct model call. Use for QA, summarisation, or classification tasks. Cost: $0.0100 USDC per call.

Parameters2

question	string	required	The question or task for the agent to reason about
max_tokens	integer	optional	Maximum tokens for the response (default: 1024)

Raw schema

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "The question or task for the agent to reason about"
    },
    "max_tokens": {
      "type": "integer",
      "description": "Maximum tokens for the response (default: 1024)",
      "default": 1024
    }
  },
  "required": [
    "question"
  ]
}

tool_example

POST /tools/tool_example/run — Stateless text utility for testing x402 payment flows. Input: {text: string}. Output: {original, uppercase, word_count, char_count}. Cost: $0.0010 USDC per call.

Parameters1

text

string

required

Input text to process

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "Input text to process"
    }
  },
  "required": [
    "text"
  ]
}

tool_zar_prices

POST /tools/zar-prices/run — Returns live bid/ask/last prices for crypto/ZAR pairs. Input: {pair: 'BTC/ZAR'|'ETH/ZAR'|'SOL/ZAR'|'USDC/ZAR'|'all'}. Output: array of {exchange, pair, price, bid, ask, timestamp} objects. Sources: VALR (all 4 pairs), Luno (BTC/ZAR + ETH/ZAR only). SOL/ZAR and USDC/ZAR are VALR-only. Fetches all exchanges concurrently. Timestamps are ISO-8601 UTC. Cost: $0.0050 USDC per call.

Parameters1

pair

string

optional

Trading pair to fetch. Use 'all' to fetch every supported pair concurrently.

Raw schema

{
  "type": "object",
  "properties": {
    "pair": {
      "type": "string",
      "enum": [
        "BTC/ZAR",
        "ETH/ZAR",
        "SOL/ZAR",
        "USDC/ZAR",
        "all"
      ],
      "default": "all",
      "description": "Trading pair to fetch. Use 'all' to fetch every supported pair concurrently."
    }
  },
  "required": []
}

tool_data_transformer

POST /tools/tool_data_transformer/run — Extracts structured JSON from raw text using a caller-supplied JSON Schema. Input: {raw_text: string, target_json_schema: object (JSON Schema draft-07)}. Output: {success, extracted_data, extraction_method, validation_passed, error}. extraction_method is one of: 'direct_parse', 'embedded_json', 'regex_extraction'. No LLM involved — pure parsing pipeline. Type coercion applied for integer/number/boolean fields. Works best with flat schemas; deeply nested structures extract less reliably via key-value pass. Cost: $0.0500 USDC per call.

Parameters2

raw_text	string	required	Unstructured or semi-structured text to extract data from. Examples: API response body, email content, log lines, form submissions, scraped web pages, or any text that contains the values you need.
target_json_schema	object	required	A JSON Schema object describing the expected output structure. Define 'properties' with a 'type' for each field you want extracted, and list required fields under 'required'. Example: {"type": "object", "properties": {"name": {"type": "string"}, "age": {"type": "integer"}}, "required": ["name", "age"]}

Raw schema

{
  "type": "object",
  "properties": {
    "raw_text": {
      "type": "string",
      "description": "Unstructured or semi-structured text to extract data from. Examples: API response body, email content, log lines, form submissions, scraped web pages, or any text that contains the values you need."
    },
    "target_json_schema": {
      "type": "object",
      "description": "A JSON Schema object describing the expected output structure. Define 'properties' with a 'type' for each field you want extracted, and list required fields under 'required'. Example: {\"type\": \"object\", \"properties\": {\"name\": {\"type\": \"string\"}, \"age\": {\"type\": \"integer\"}}, \"required\": [\"name\", \"age\"]}"
    }
  },
  "required": [
    "raw_text",
    "target_json_schema"
  ]
}

tool_compute_sandbox

POST /tools/tool_compute_sandbox/run — Executes Python 3.12 code in an isolated subprocess with a 5-second hard timeout. Input: {python_code: string, input_data: any (optional, bound as variable 'input_data')}. Output: {success, result, stdout (capped 50KB), execution_time_ms, error_type}. Return value: assign to 'result' variable. Pre-loaded: math, json, re, statistics, itertools, functools, collections, decimal, datetime, random, hashlib, base64. Blocked: import, open(), eval(), exec(), os, sys, network, class definitions, dunder attributes. error_type values: syntax_error | security_error | runtime_error | timeout_error. Cost: $0.1500 USDC per call.

Parameters2

python_code	string	required	Python 3.12 source code to execute. No import statements. Set 'result = <value>' to return a value. Pre-loaded modules are in scope: math, json, re, statistics, itertools, functools, collections, decimal, datetime, random, string, textwrap, hashlib, base64, struct, copy, pprint.
input_data	any	optional	JSON-serializable value (dict, list, str, number, bool, or null) passed as the variable 'input_data' inside the sandbox. Omit or pass null if the code has no external input.

Raw schema

{
  "type": "object",
  "properties": {
    "python_code": {
      "type": "string",
      "description": "Python 3.12 source code to execute. No import statements. Set 'result = <value>' to return a value. Pre-loaded modules are in scope: math, json, re, statistics, itertools, functools, collections, decimal, datetime, random, string, textwrap, hashlib, base64, struct, copy, pprint."
    },
    "input_data": {
      "description": "JSON-serializable value (dict, list, str, number, bool, or null) passed as the variable 'input_data' inside the sandbox. Omit or pass null if the code has no external input."
    }
  },
  "required": [
    "python_code"
  ]
}

tool_sa_airport_oracle

POST /tools/sa-airport-oracle/run — Returns live flight status from ACSA (airports.co.za). Input: {airport_code: 'JNB'|'CPT'|'DUR', flight_number: string, request_type: 'arrival'|'departure'}. Output: {success, live_status, scheduled_time, estimated_time, actual_time, gate, carousel, terminal, flight_number, airport_code, request_type, error}. Coverage: JNB (O.R. Tambo), CPT (Cape Town Int'l), DUR (King Shaka). Data window: flights within 48 hours. Call GET /tools/sa-airport-oracle/health (free) first — if structure_valid=false, do not proceed. error_type values: 'stale_data' (do not retry), 'not found' (retry after 10-15 min), network error (retry once). flight_number is case-insensitive and normalised to uppercase internally. Read-only — no booking/ticketing. Cost: $0.1200 USDC per call.

Parameters3

airport_code	string	required	IATA airport code. JNB=O.R. Tambo (Johannesburg), CPT=Cape Town, DUR=King Shaka (Durban).
flight_number	string	required	IATA flight number, e.g. 'SA322'. Case-insensitive.
request_type	string	required	Search the arrivals board or departures board.

Raw schema

{
  "type": "object",
  "properties": {
    "airport_code": {
      "type": "string",
      "enum": [
        "JNB",
        "CPT",
        "DUR"
      ],
      "description": "IATA airport code. JNB=O.R. Tambo (Johannesburg), CPT=Cape Town, DUR=King Shaka (Durban)."
    },
    "flight_number": {
      "type": "string",
      "description": "IATA flight number, e.g. 'SA322'. Case-insensitive."
    },
    "request_type": {
      "type": "string",
      "enum": [
        "arrival",
        "departure"
      ],
      "description": "Search the arrivals board or departures board."
    }
  },
  "required": [
    "airport_code",
    "flight_number",
    "request_type"
  ]
}

Agent Vending Factory

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

agent_example

tool_example

tool_zar_prices

tool_data_transformer

tool_compute_sandbox

tool_sa_airport_oracle

Install

Remote endpoint

Related servers