{"uid":"cap_nZQQsC_GvzznqOIZNAaS9","slug":"miorail-stock-representation-choice-47656f07","name":"Miorail Stock Representation Choice","description":"Miorail x402 paid resource","url":"https://miorail.xyz/api/x402/intelligence/v1/stocks/representations?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["underlyingKey"],"properties":{"sizeUsdc":{"type":"string","description":"A measured ladder size: 100, 1000, 10000 or 100000"},"direction":{"type":"string","description":"buy or sell; default buy"},"underlyingKey":{"type":"string","description":"Reviewed security key, e.g. security:isin:US67066G1040"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"service":"stock_representation_choice","missingEvidence":["at least one reviewed representation has no measurement at this exact size and direction"],"representations":[{"sources":[{"source":"kyberswap","status":"quoted"}],"issuerId":"coinbase","tokenAddress":"0xb20000000000000000000078ee7ce2fe4908108c","routePolicyEstablished":true}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Xmmbt4QaydIboOxQf85t0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the best tokenized stock representation(s) for a given security, trade direction, and size in USDC, including issuer and on-chain token details.","exampleAgentPrompt":"What's the best on-chain token representation for buying $1000 USDC worth of Coinbase stock (ISIN US19260Q1076) — give me the issuer, token address, and whether a route policy is established?","exampleUseCases":[{"title":"Choosing token for equity buy order","prompt":"I want to buy $10000 USDC worth of Apple stock on-chain using its ISIN US0378331005 — which tokenized representation and issuer should I use for a buy direction?"},{"title":"Validating sell-side token liquidity","prompt":"I'm planning to sell $1000 USDC of tokenized Tesla shares (security:isin:US88160R1014) — which on-chain representation has a route policy and quoted liquidity for a sell?"},{"title":"Smallest size equity token lookup","prompt":"For a $100 USDC buy of the security with key security:isin:US67066G1040, which tokenized stock token address and issuer does Miorail recommend?"}],"resultDescription":"Returns a list of tokenized stock representations for the queried security, each with issuer ID, on-chain token address, liquidity sources (e.g. KyberSwap with quote status), and whether a route policy is established. Also includes a missingEvidence array flagging any representations lacking measurement at the exact size and direction requested.","failureModes":["Missing or invalid underlyingKey returns an error or empty representations array","Unsupported sizeUsdc value (not one of 100, 1000, 10000, 100000) may return no results or an error","Unknown or unreviewed security key results in empty representations","Payment not processed (x402 protocol failure) blocks access to the resource","missingEvidence field populated when no measurement exists at the exact size/direction combo"],"whenToPreferThis":"Use this endpoint when an agent needs to identify the correct on-chain tokenized stock token and issuer for a given ISIN before routing a trade through a DEX or liquidity protocol. Prefer this over generic DEX aggregators when you need an authoritative, reviewed mapping from a traditional security identifier (ISIN) to a specific on-chain token address, with issuer provenance and route policy confirmation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:34:33.805Z","isFirstParty":false,"canonicalSlug":"miorail-stock-representation-choice-47656f07"}