{"uid":"cap_2z35t1gUlTAYyPQAAdN-0","slug":"agent-embassy-ticker-shelf-b2aa28d0","name":"Agent Embassy Ticker Shelf","description":"Agents pay for work and prove what happened.","url":"https://aemb.pro/v1/shelf?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string","description":"What to shop for: \"a ticker\", \"a ticker, $5 budget\", \"COMPARE two tickers\", \"BEST a theme, $25 budget\" (max 200 chars)"},"max_rows":{"type":"number","description":"Rows on the shelf, 3-10 (default 10)"},"objective":{"type":"string","description":"convexity (default), long-clock, fast-heat, tail, income, leveraged"},"budget_usd":{"type":"number","description":"Hard budget gate in USD (1/5/10/25/50/100 supported; omit for uncapped)"},"idempotency_key":{"type":"string","description":"Client-generated UUID v4, one per logical request. Replaying the same key on the same tool returns the original receipt."}}},"responseSchema":{"type":"json","example":{"tool":"ticker_shelf","chain":["request","authorization","action","proof","liability_boundary"],"status":"complete","account":"0x1111111111111111111111111111111111111111","receipt_id":"emb_abc123","receipt_version":"embassy-receipt/2"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Fhn-zIKunUMJLU_kBmFxp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked shelf of financial tickers matching a query, with optional budget gating, objective filtering, and a verifiable on-chain payment receipt.","exampleAgentPrompt":"Search the Agent Embassy shelf for the best convexity tickers on a volatility theme, cap it at $25 budget, show me up to 5 results, and give me the receipt proving payment.","exampleUseCases":[{"title":"Compare two tickers for a portfolio","prompt":"I want to compare NVDA and AMD — run a COMPARE on Agent Embassy's shelf so I can see which one ranks better, income objective, no budget cap, up to 5 rows."},{"title":"Find income tickers under $10","prompt":"Can you pull up an income-focused shelf of tickers from Agent Embassy, hard budget gate of $10, show me the top 7 results?"},{"title":"Best momentum plays on a theme","prompt":"Look up the BEST fast-heat tickers on a semiconductor theme from Agent Embassy, budget $25, give me up to 10 results with the receipt."}],"resultDescription":"Returns a JSON object with a ranked list of tickers (the 'shelf'), the investment objective applied, the number of rows returned, a chain-of-custody log (request → authorization → action → proof → liability_boundary), a receipt ID, receipt version, the paying account address, and completion status — enabling an agent to audit what happened and prove payment was made.","failureModes":["Invalid or unsupported budget_usd value (must be one of 1/5/10/25/50/100) returns an error","Query string exceeds 200 characters is rejected","max_rows outside 3-10 range causes a validation error","Replaying an idempotency_key returns the original receipt without re-charging","Payment failure or insufficient USDC balance blocks the request","Unsupported objective enum value returns an error"],"whenToPreferThis":"Choose this endpoint when an agent needs to discover and rank financial tickers for a given theme or comparison, especially when verifiable proof of payment and an auditable receipt chain are required. Prefer it over generic stock screeners when the agent must prove what actions were taken (liability boundary) or when budget-gating is needed to constrain results to instruments within a cost threshold.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:35:13.445Z","isFirstParty":false,"canonicalSlug":"agent-embassy-ticker-shelf-b2aa28d0"}