WayforthQL — Query Language Specification

1Quick Start

Request

POST https://api.wayforth.io/query
Content-Type: application/json

{
  "query": "fast inference for coding",
  "tier_min": 2,
  "limit": 5
}

2Full Schema

Field	Type	Default	Description
queryrequired	string	—	Natural language intent. Wayforth uses semantic embedding + Claude Haiku ranking to match against the service catalog.
tier_min	int	2	Minimum coverage tier (0–3). Tier 2 means the service passed automated health verification. Tier 3 is KYB-verified.
price_max	float	null	Maximum price in USD per request. Only returns services at or below this price point.
category	string	null	Filter by service category. One of: inference \| data \| translation
protocol	string	null	Filter by payment protocol. One of: wayforth \| x402 \| any. x402 is the open HTTP-402 micropayment standard.
sort_by	string	"wri"	Ranking strategy. One of: wri (composite Wayforth Rank Index) \| score \| price \| tier
exclude_ids	array	[]	Array of wayforth_id strings to exclude from results. Useful for deduplication across paginated calls.
limit	int	5	Number of results to return. Maximum 20.
with_similar	bool	false	Include co-used services from the Service Graph. Returns services frequently used alongside top results.

3Response Schema

Field	Type	Description
wayforth_id	string	Unique service identifier. Format: wayforth://<slug>
name	string	Human-readable service name.
wri	float	Wayforth Rank Index — composite score combining relevance, tier, uptime, and price efficiency. Range 0–100.
score	float	Semantic relevance score for this query. Produced by Claude Haiku ranking.
reason	string	Natural language explanation of why this service matched the query.
coverage_tier	int	Verification tier (0–3). Tier 2+ services are automatically health-checked every 6 hours.
pricing_usdc	float	Price per request in USD. Null or 0 means free.
payment_protocol	string	Payment routing protocol. One of: wayforth \| x402 \| any
similar	array	Co-used services from the Service Graph. Only present when with_similar: true.

4Examples

Basic search — top 5 Tier 2+ services for coding inference

curl -X POST https://api.wayforth.io/query \
  -H "Content-Type: application/json" \
  -d '{
    "query": "fast inference for coding",
    "tier_min": 2,
    "limit": 5
  }'

Cheapest web search APIs sorted by price

curl -X POST https://api.wayforth.io/query \
  -H "Content-Type: application/json" \
  -d '{
    "query": "web search API",
    "sort_by": "price",
    "limit": 10
  }'

Translation services with co-used recommendations

curl -X POST https://api.wayforth.io/query \
  -H "Content-Type: application/json" \
  -d '{
    "query": "translate English to Spanish",
    "category": "translation",
    "with_similar": true,
    "limit": 3
  }'

With similar services from the Service Graph

curl -X POST https://api.wayforth.io/query \
  -H "Content-Type: application/json" \
  -d '{
    "query": "real-time financial data",
    "tier_min": 2,
    "with_similar": true,
    "limit": 5
  }'