{"uid":"cap_wbzAoZDBifYCPHLfD2Y7R","slug":"gedx402-vector-query-be9c5ee7","name":"GEDX402 Vector Query","description":"x402 workers ai. pay with usdc on base, polygon, arbitrum, world, or solana. no api keys.","url":"https://ged-x402-search.jvalamis.workers.dev/v1/vector/query","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"top_k":{"type":"integer"},"vector":{"type":"array","items":{"type":"number"}},"namespace":{"type":"string"},"return_values":{"type":"boolean"},"return_metadata":{"type":"boolean"}}},"responseSchema":{"type":"json","example":{"count":0,"matches":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ws7eJqhmeAsuaPRDX6fG4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs semantic vector search over a named namespace by embedding a natural-language query and returning the top-k matching documents","exampleAgentPrompt":"Search my 'customer-support' namespace for the top 5 documents most similar to 'how do I reset my password', and include their stored metadata in the results.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a count of matches and an array of matched documents, each including their document ID, similarity score, and optionally stored metadata fields.","failureModes":["Empty matches array if namespace has no indexed documents or query finds no similar results","Payment required (402) if USDC payment is not included or insufficient","Invalid namespace format (must be 2-64 chars) returns a validation error","top_k out of range (must be 1-50) causes a bad request error","Mismatched vector dimensions (must be 768) causes an error if a raw vector is provided","Namespace not found or not yet populated returns count:0 with empty matches"],"whenToPreferThis":"Choose this endpoint when you need keyless, pay-per-call semantic vector search over a named namespace using natural language queries, especially in agent pipelines that require RAG (retrieval-augmented generation) without managing API keys or long-term subscriptions. Prefer it when you need USDC micropayment billing across multiple chains (Base, Polygon, Arbitrum, World, Solana).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:33:19.827Z","isFirstParty":false}