{"uid":"cap_teluyVZAzQ0Va4Qnoa99L","slug":"gedx402-vector-search-17d81c09","name":"GEDX402 Vector Search","description":"x402 workers ai. pay with usdc on base, polygon, arbitrum, world, or solana. no api keys.","url":"https://search.gedx402.com/v1/vector/query","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"top_k":{"type":"integer","description":"Max results (1-50)."},"vector":{"type":"array","items":{"type":"number"},"description":"768-dim query vector."},"namespace":{"type":"string","description":"Agent collection id (2-64 chars). Isolates vectors per agent or project."},"return_values":{"type":"boolean","description":"Include raw vector values in matches."},"return_metadata":{"type":"boolean","description":"Include stored metadata in matches."}}},"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_zObF23tcsoRjp8_Rrf6l-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs semantic vector similarity search against a named namespace, returning the top-K nearest neighbors to a 768-dimensional query vector","exampleAgentPrompt":"Search my 'support-docs' namespace for the 10 closest matches to this 768-dimensional embedding vector, and include the stored metadata in the results.","exampleUseCases":[{"title":"Find similar customer support articles","prompt":"Search our support documentation namespace for the top 8 vectors closest to this customer question embedding, and give me back the metadata so I can see which articles are most relevant."},{"title":"Retrieve semantically matching product recommendations","prompt":"Query the product-embeddings namespace to find the 15 nearest neighbors to this user preference vector, including all stored metadata about pricing and categories."},{"title":"Discover related knowledge base entries","prompt":"Look up the 12 most semantically similar entries in our knowledge-base namespace that match this query embedding, and return the metadata fields so I can see titles and tags."}],"resultDescription":"A JSON object with a 'count' integer and a 'matches' array, each match containing the vector ID, similarity score, and optionally the raw vector values and stored metadata fields depending on the return_values and return_metadata flags.","failureModes":["Vector dimension mismatch — query vector must be exactly 768 dimensions","Namespace not found or empty — returns count:0 and empty matches array","top_k out of range — must be between 1 and 50","Payment failure — USDC payment on specified chain not confirmed, request rejected with 402","Malformed vector array — non-numeric values or wrong shape cause validation error","Namespace string too short or too long — must be 2–64 characters"],"whenToPreferThis":"Choose this endpoint when you need keyless, pay-per-query vector similarity search with no API key registration, especially in agentic workflows that manage crypto payments via x402 on Base, Polygon, Arbitrum, World, or Solana. Ideal for agents that need to isolate vector collections per project using namespaces and want to pay $0.015 USDC per call on-chain rather than managing subscription credentials.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:30:40.621Z","isFirstParty":false}