{"uid":"cap_fSmalbgh_oVuZw6RXrG7R","slug":"stellar-asset-supply-and-holder-counts-669fc63e","name":"Stellar Asset Supply and Holder Counts","description":"Supply and holder counts for one issued Stellar asset — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/stellar-asset?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"code":{"type":"string"},"issuer":{"type":"string","pattern":"^G[A-Z2-7]{55}$"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"stellar-asset","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.005,"receipt_id":"g402-<16hex>"},"generated_at":"<iso8601>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_U9ndWB4aH48oHsRh_DdHF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns circulating supply and holder count metrics for a specified issued Stellar asset identified by asset code and issuer address.","exampleAgentPrompt":"What's the current circulating supply and number of holders for the Stellar asset with code USDC issued by GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN?","exampleUseCases":[{"title":"Token dashboard supply monitoring","prompt":"Pull the circulating supply and holder count for the Stellar asset with code AQUA issued by issuer GBNZILSTVQZ4R7IKQDGHYGY2QXL5QOFJYQMXPKWRRM5PAV7Y4M67AQUA so I can update my token dashboard."},{"title":"Due diligence on a new Stellar token","prompt":"I'm evaluating a Stellar token before investing — can you check the total supply and how many accounts are holding the asset with code ARST and issuer GB7TAYRIQQ6CWOC72XZD552RFLI57BNVQJZMCFD4BY7KBQV7Y23GXQAA?"},{"title":"Tracking holder growth over time","prompt":"Check the holder count right now for the Stellar asset code MOBI issued by GA6HCMBLTZS5VYYBCATRBRZ3BZJMAFUDKYYF6AH6MVCMGWMRDNSWJPIH — I want to compare it against last week's number."}],"resultDescription":"Returns a JSON object with ok=true, the asset type label ('stellar-asset'), a generated_at ISO 8601 timestamp, and a receipt object containing the transaction hash, USD amount charged, and a receipt ID. The actual supply and holder count data are embedded in the response payload alongside the receipt.","failureModes":["Invalid issuer address format (must match G[A-Z2-7]{55}) returns a validation error","Unknown asset code or issuer combination may return empty/zero results","Payment failure via x402 protocol results in 402 response before data is returned","Network timeout if Stellar Horizon node is unreachable","Missing required params object or fields returns a schema validation error"],"whenToPreferThis":"Choose this endpoint when you need on-demand supply and holder count data for a specific Stellar-issued asset identified by its code and issuer public key. It is ideal for tokenomics dashboards, due diligence workflows, or monitoring holder growth on the Stellar network. Prefer this over generic blockchain explorers when you need a structured, pay-per-call API response with a built-in receipt for accounting purposes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T18:55:54.465Z","isFirstParty":false,"canonicalSlug":"stellar-asset-supply-and-holder-counts-669fc63e"}