# Delx Commerce — Catalog Intent Rank

> Delx Commerce — Catalog Intent Rank is a paid API for AI agents from commerce.delx.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-01).

Ranks a list of candidate tool names by relevance to a natural language intent query, returning scored results in order of match quality.

## Facts

- Endpoint: POST https://commerce.delx.ai/api/v1/x402/catalog-intent-rank?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-commerce-catalog-intent-rank-79d27c2e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zDQJRR0_sFFqstbkAc4k6

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 delx-commerce-catalog-intent-rank-79d27c2e -d '<json body>'
```

Example prompt: From this list of candidate tools — util_kelly_binary, util_dns_lookup, util_gwei_to_wei — which one best matches the intent 'convert gas price units in Ethereum'? Rank them by relevance and give me a score for each.

## When to prefer this

Use this endpoint when you need lightweight, pay-per-call intent-to-tool matching without standing up your own embedding or ranking infrastructure. It is especially useful in agent orchestration pipelines where the candidate set changes dynamically and you want to avoid passing a large tool catalog into LLM context. Prefer it over embedding-based DIY solutions when you need a fast, cheap, verifiable single call with no API key or signup required.

## Known failure modes

- Empty candidates array returns an empty ranked list
- Vague or ambiguous query may produce uniform low scores across all candidates
- Unrecognized tool names are still scored but may receive 0 if no semantic signal is found
- Malformed request body missing required 'query' field returns an error
- Payment failure or insufficient USDC balance blocks the request via x402 protocol

## How this service works

Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.

## Output

A JSON array of ranked tool name objects, each with a numeric relevance score (e.g. 1 for highest match, 0 for no match), ordered from most to least relevant to the provided intent query.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "description": "Natural language intent query"
  },
  "candidates": {
   "type": "array",
   "description": "Candidate tool_name list"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ranked": [
   {
    "score": 1,
    "tool_name": "util_kelly_binary"
   },
   {
    "score": 0,
    "tool_name": "util_dns_lookup"
   },
   {
    "score": 0,
    "tool_name": "util_gwei_to_wei"
   }
  ],
  "schema": "delx/util-catalog-intent-rank/v1"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delx-commerce-catalog-intent-rank-79d27c2e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from commerce.delx.ai](https://www.zero.xyz/host/commerce.delx.ai/llms.txt)