{"uid":"cap_-n6wgdFE3r5f9Rz1WYkEP","slug":"deepsearch-korea-us-stock-intelligence-investor-flows-api-2a565d8e","name":"DeepSearch Korea/US Stock Intelligence – Investor Flows API","description":"Korean (KRX) stock data for AI agents: analyst consensus, investor flows, market pulse, knowledge-graph signals (why a stock moved, hot themes, theme revenue evidence), 10-year financials and 3-year prices, plus US fundamentals and SEC filings. Pay per call in USDC on Base Mainnet — no subscription, no API key.","url":"https://x402.deepsearch.com/v1/context/flows/%7Bticker%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"asOf":"2026-09-30","name":"삼성전자","unit":"KRW, net buy (+) / net sell (−)","netBuy":{"1d":{"foreigner":412000000000,"individual":-323904661250,"institutional_total":-8254030500}},"ticker":"005930","packType":"flows","blockTrades":[{"date":"2026-09-30","volume":290794,"closeKRW":272500,"changePct":0.93,"shareOfVolumePct":1.82}],"shortSelling":[{"date":"2026-09-30","volume":863316,"amountKRW":233476662500,"shareOfVolumePct":4.32}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DhvXzvraypS-FT7IAiiYG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns investor flow data for a KRX-listed stock: net buy/sell by foreigner, individual, and institutional investors, plus block trades and short-selling statistics.","exampleAgentPrompt":"Pull the investor flow breakdown for Samsung Electronics (ticker 005930) on KRX — I want to see how much foreigners, individuals, and institutions are net buying or selling, plus any block trades and short selling activity today.","exampleUseCases":[{"title":"Foreigner flow surveillance on KOSPI","prompt":"Show me the foreigner net buy and sell figures for Kakao (ticker 035720) on KRX today — I want to know if overseas investors are accumulating or dumping shares."},{"title":"Short selling pressure check before earnings","prompt":"Before SK Hynix reports earnings, can you pull the short selling volume and its share of total trading volume for ticker 000660 on the KRX?"},{"title":"Block trade detection for institutional activity","prompt":"Are there any notable block trades in LG Energy Solution (ticker 373220) recently? I want to see dates, volumes, and how they compare to total daily trading volume."}],"resultDescription":"A JSON object containing: the stock's ticker and name, the as-of date, a net buy breakdown (1-day window) split into foreigner, individual, and institutional flows in KRW (positive = net buy, negative = net sell), an array of block trade records (date, volume, closing price in KRW, change percent, share of total volume), and an array of short selling records (date, volume, amount in KRW, share of total volume).","failureModes":["Invalid or unrecognized KRX ticker returns an error or empty response","Payment failure (insufficient USDC balance on Base Mainnet) results in 402 response","Data not yet available for the current trading day (market still open or settlement delay)","Non-KRX tickers (e.g. NYSE, NASDAQ) are not supported by this endpoint","Network timeout or upstream data feed outage"],"whenToPreferThis":"Use this endpoint when you need granular investor-type flow data (foreigner vs. retail vs. institutional net buy/sell) for a specific KRX-listed Korean stock, especially to detect unusual accumulation, distribution, block trades, or short-selling pressure. Prefer this over the full company report endpoint when you only need flow/sentiment signals and want to minimize cost ($0.05 vs $0.30+). Not suitable for US stock flows or crypto assets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T00:41:22.680Z","isFirstParty":false,"canonicalSlug":"deepsearch-korea-us-stock-intelligence-investor-flows-api-2a565d8e"}