{"uid":"cap_OSGB5WIsWpc8iW_eb64oX","slug":"relaystation-baton-vector-query-b69670bb","name":"Relaystation Baton Vector Query","description":"$0.005/query (+embed units for raw text). Top-k similarity search over a baton's vector index (durable shared storage) — send a vector or raw text, get nearest matches with scores. 1¢ x402 min; remainder auto-credits — relaystation.ai/penny","url":"https://api.relaystation.ai/v1/baton/%7Bid%7D/vectors/query","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_roSJ7MilrlS5fyFVdBBFO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Top-k similarity search over a named baton's vector index — send a vector or raw text, get nearest matches with similarity scores","exampleAgentPrompt":"Search my baton 'kb-docs-42' for the 5 most similar passages to the text 'how do I reset my password?' and return their scores.","exampleUseCases":[{"title":"RAG retrieval for chatbot context","prompt":"Query baton 'support-articles' with the user's question 'why is my invoice wrong?' and fetch the top 3 most relevant chunks so I can build the answer."},{"title":"Semantic deduplication check","prompt":"Search baton 'product-descriptions-v2' for the 10 closest matches to this new listing text so I can see if we already have something nearly identical before adding it."},{"title":"Personalized recommendation lookup","prompt":"Find the 5 nearest neighbors to this user's preference embedding in baton 'user-taste-profiles' so I can surface the most relevant recommendations for them."}],"resultDescription":"Returns an ordered list of top-k nearest vector matches from the specified baton's index, each with a similarity score, vector ID, and any associated metadata stored at write time.","failureModes":["Baton ID not found — returns 404 if the baton doesn't exist or hasn't been initialized","No vectors indexed — returns empty results if the baton has no embeddings written yet","Malformed input — missing or wrong-type 'input' body returns 400 validation error","Dimension mismatch — query vector dimensionality differs from indexed vectors causes an error","Insufficient x402 payment or expired credit — returns 402 Payment Required","Rate limiting or quota exceeded — returns 429"],"whenToPreferThis":"Use this endpoint when you need fast, pay-per-query semantic similarity search over a persistent, named vector store (baton) managed by Relaystation — especially in RAG pipelines, semantic deduplication, or recommendation systems where the index is already populated via Relaystation's batch-write endpoint. Prefer this over general-purpose vector DB APIs when operating within the Relaystation baton ecosystem with x402 micropayment billing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:02.711Z","isFirstParty":false}