# GEDX402 Vector Search (Natural Language Query)

> GEDX402 Vector Search (Natural Language Query) is a paid API for AI agents from ged-x402-search.jvalamis.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Performs natural-language semantic search over a vector namespace, returning the top-K matching documents with scores and metadata.

## Facts

- Endpoint: GET https://ged-x402-search.jvalamis.workers.dev/v1/search/query
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gedx402-vector-search-natural-language-query-dc60a418
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6m-K3iH8l7hNhrCNx5pZM

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 gedx402-vector-search-natural-language-query-dc60a418
```

Example prompt: Search my 'project-alpha' namespace for the top 5 documents most relevant to 'quarterly revenue trends in SaaS companies' and include any stored metadata.

## When to prefer this

Use this endpoint when you need pay-per-call semantic search without managing API keys — ideal for serverless AI agents doing RAG retrieval, knowledge base lookups, or similarity search over pre-stored documents in an isolated namespace. Prefer over managed vector DBs when you want blockchain-native micropayment access (USDC on Base, Polygon, Arbitrum, World, or Solana) and no credential management overhead.

## Known failure modes

- Missing or invalid namespace returns empty results or error
- query parameter absent causes 400 bad request
- top_k outside range 1-50 may be rejected or clamped
- Payment failure (insufficient USDC balance or unsupported chain) returns HTTP 402
- Invalid or mismatched vector dimensions (must be 768) cause rejection
- Namespace not found returns empty matches array

## How this service works

x402 workers ai. pay with usdc on base, polygon, arbitrum, world, or solana. no api keys.

## Output

A JSON object with a count of matches and an array of match objects, each containing a document ID, a similarity score (e.g. 0.91), and optionally the stored metadata including the original text.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string"
  },
  "top_k": {
   "type": "integer"
  },
  "namespace": {
   "type": "string"
  },
  "return_metadata": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "matches": [
   {
    "id": "doc-1",
    "score": 0.91,
    "metadata": {
     "text": "..."
    }
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gedx402-vector-search-natural-language-query-dc60a418/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ged-x402-search.jvalamis.workers.dev](https://www.zero.xyz/host/ged-x402-search.jvalamis.workers.dev/llms.txt)