์์ด์ ํธ ํผ๋, MCP ๋ฐฉ๋ฒ๋ก
AI ์์ด์ ํธ๋ฅผ ์ํด MCP(Model Context Protocol)๋ก ๋ ธ์ถ๋๋ ์ฝ๊ธฐ ์ ์ฉยท๊ธฐ์ ์ (descriptive) ํฌ๋ก์ค ์ต์ค์ฒด์ธ์ง ๋ง์ดํฌ๋ก์คํธ๋ญ์ฒ ํผ๋: 4๊ฐ ๊ฑฐ๋์์ 7๊ฐ ์์ฐ์ ์ฌ์ค๊ณผ ์ ๊ทํ๋ก ๋ณด๊ณ ํ๋ฉฐ ํ์ (verdict)์ ํ์ง ์์ต๋๋ค.
์์ด์ ํธ ์ฐ๊ฒฐ: /agents.
๋ฌด์์ธ๊ฐ
ํ๋์ MCP ํธ์ถ์ ํ๋์ ์ ๊ทํ๋ ๋ง์ผ ์คํ
์ดํธ ๊ฐ์ฒด๋ฅผ ๋ฐํํฉ๋๋ค. ์์ด์ ํธ ํผ๋๋ 7๊ฐ ์์ฐ, BTC, ETH, SOL, BNB, XRP, DOGE, HYPE, ์ Binance, Bybit, OKX, Hyperliquid์์ ๋ค๋ฃจ๋ฉฐ, ๋ ์ง์คํธ๋ฆฌ ์ด๋ฆ ai.markettrace/agent-feed์ผ๋ก ๊ฒ์๋๊ณ https://api.markettrace.ai/mcp์ ํธ์คํ
๋ฉ๋๋ค.
ํผ๋๋ ์ธก์ ํ ์ ์๋ ๊ฒ์ ๋ณด๊ณ ํ๊ณ ๊ฐ ์ซ์๋ฅผ ์ผ๋ง๋ ์ ๋ขฐํ ์ง ์ค์ค๋ก ์ ์ธํฉ๋๋ค. ํธ๋ ์ด๋ ์ถ์ฒ์ ๊ฒฐ์ฝ ๋ฐํํ์ง ์์ผ๋ฉฐ, ํ์คํ ๋ฆฌ์ ์ปค๋ฒ๋ฆฌ์ง ์ ์งํ ์ฌ์ค์ ๋ณด๊ณ ํฉ๋๋ค. ์์ธก์ด ์๋ ํ์คํ ๋ฆฌ๋ฅผ ๋ณด๊ณ ํฉ๋๋ค.
๋ฐ์ดํฐ ์ถ์ฒ
ํผ๋๋ ์ฌ์ดํธ๋ฅผ ๊ตฌ๋ํ๋ ๋์ผํ ํฌ๋ก์ค ์ต์ค์ฒด์ธ์ง ํ์ดํ๋ผ์ธ์ ์ฌ์ฌ์ฉํฉ๋๋ค, ์ ๋ถ Rust, Python ๋ฐ๋ชฌ ์ ๋ก. ๊ฐ ์งํ๋ ์์ฒด ์ถ์ฒ๋ฅผ ์ง๋๋ฉฐ ๋ ๊น์ ์งํ๋ณ ๋ฐฉ๋ฒ๋ก ์ผ๋ก ์ฐ๊ฒฐ๋ฉ๋๋ค:
- Funding. OI ์ ๋ณด๋ฅผ ๋ฐ์ํ ํฌ๋ก์ค venue rate์, ์ผ๊ด๋๊ฒ ๊น์ venue ์งํฉ์ ๋ํ ๋ค๋ ๋ฐฑ๋ถ์. Funding ๋ฐฉ๋ฒ๋ก โ
- ๋ฏธ๊ฒฐ์ ์ฝ์ (OI). 4๊ฐ venue์ ๋ค์ดํฐ๋ธ USD ํฉ๊ณ: Bybit
openInterestValue, OKXoiUsd, Hyperliquidcoins ร markPx, Binancecoins ร mark. - ๊ฑฐ๋๋. 30์ผ ํตํฉ ํ ์ดํ.
- CVD & ์ค๋๋ถ ์๋ฐธ๋ฐ์ค. ํฌ๋ก์ค venue ํ ์ด์ปค ํ๋ก์ฐ์ ํ๋ก์ฐ ๊ฐ์ค OBI. ํฌ์ง์ ๋ ๋ฐฉ๋ฒ๋ก โ
- ์ฒญ์ฐ. 3๊ฐ venue, Binance, Bybit, OKX; Hyperliquid๋ ์๋์ ์ผ๋ก ์ ์ธ. ์ฒญ์ฐ ๋ฐฉ๋ฒ๋ก โ
- Basis. perp ๋ spot์ bps๋ก ํํ; ์์๋ perp๊ฐ spot ์ธ๋ฑ์ค ์์์ ๊ฑฐ๋๋จ์ ์๋ฏธํ๋ฉฐ, ์ธ๋ฑ์ค๋ ๋ฉํฐ ์ต์ค์ฒด์ธ์ง spot ํฉ์ฑ์น์ ๋๋ค.
- ๊ฐ๊ฒฉ / OHLCV. ํตํฉ ํฌ๋ก์ค ์ต์ค์ฒด์ธ์ง ์บ๋ค.
๋ฏธ๊ฒฐ์ ์ฝ์ ์ ๋ค venue๋ฅผ ๋ค์ดํฐ๋ธ USD๋ก ํฉ์ฐํฉ๋๋ค, Bybit openInterestValue, OKX oiUsd, Hyperliquid coins ร markPx, Binance coins ร mark. oi.rel์ ํ์ฌ ๊ฐ์ ๊ทธ ํํ ์๊ฐ๋ณ ์ค์๊ฐ(1d / 1w / 1m)๊ณผ ๋น๊ตํ๊ณ , oi.chg_1h_pct๋ ์ง์ ์๋ฃ๋ ํ ์๊ฐ ๋์์ ๋ณํ์
๋๋ค. ๋ฒ ์ด์ค๋ผ์ธ์ ๋ผ์ด๋ธ venue ์งํฉ์ ์กฐ์ธํ๋ฏ๋ก ๋ ๊ฑฐ์ Binance ์ ์ฉ ํ์ ์ค์๊ฐ์์ ๋น ์ง๋๋ค, ์ค๋๋ ์ปค๋ฒ๋ฆฌ์ง์ ์ ์ปค๋ฒ๋ฆฌ์ง๋ฅผ ์กฐ์ฉํ ์๋ ๋์ ์ ์งํ๊ฒ ์ฌ์ ๋ฆฝํ๋ ๊ฒ์
๋๋ค.
volume.usd_24h๋ venue ์ ๋ฐ์ ํตํฉ 24์๊ฐ ๊ฑฐ๋ ๋
ธ์
๋์ด๋ฉฐ, volume.rel์ ๊ทธ๊ฒ์ ํํ ์๊ฐ๋ณ ์ค์๊ฐ ๋๋น ๋ฐฐ์๋ก ํํํฉ๋๋ค.
price.last๋ ํตํฉ mid์
๋๋ค. chg_*_pct ํ๋๋ ํ์ฉ์ค์ฐจ๋ก ๋ง์ถ ๋ฒ ์ด์ค๋ผ์ธ ๋๋น ๋ฆฌํด์ด๊ณ , atr_1h_pct๋ ์๊ฐ๋ณ ๋ฐ์ ๋ํ ATR(14)์ ๊ฐ๊ฒฉ ๋๋น ํผ์ผํธ๋ก ๋ํ๋ธ ๊ฒ์ด๋ฉฐ, rv_24h_pct๋ ๋ถ ๋จ์ ๋ฆฌํด์์ ์ฐ์จํํ ์คํ ๋ณ๋์ฑ์
๋๋ค.
์ปค๋ฒ๋ฆฌ์ง ์ ์ง์ฑ
๋ชจ๋ ์งํ๋ coverage ํญ๋ชฉ์ ์ง๋๋๋ค. ์๊ฑฐ๋ ์ด๋ฆฐ ์งํ๋ ๊ทธ ๊น์ด๋ฅผ ๊ณต๊ฐํ๋ฉฐ ์ ์งํ๊ฒ ๋ต๋ณ๋๊ณ , ๊น์ด ๋ณด์ด๋๋ก ๊ฒฐ์ฝ ์กฐ์๋์ง ์์ต๋๋ค.
coverage: { venues, window_days, n_samples, partial, reason }
reason โ { accruing | unavailable | degraded | stale }age_seconds๋ non-null ํ๋๋ฅผ ์ฑ์ด ๋ผ์ด๋ธ ์์ค ์ ์ฒด์์์ ์ต์
๊ฒฝ์ฐ ๋์ด์ด๋ฏ๋ก, ํ๋์ ๋ก์ ์๋ธ ํผ๋๊ฐ ๋ ์ ์ ํ ๊ฒ๋ค ๋ค์ ์จ์ ์ ์์ต๋๋ค. ๋ชจ๋ ์๋ต์ feed ๋น์ปจ, feed.version๊ณผ feed.tools, ์ ์์ด์ ํธ๊ฐ ๋ก๊ณ ์บ์๋ ๋๊ตฌ ์นดํ๋ก๊ทธ๋ฅผ ๊ฐ์งํ๊ณ ์คํค๋ง๋ฅผ ๋ค์ ์ฝ๊ฒ ํด์ค๋๋ค.
์กฐ๊ฑด๋ถ ๊ฒฐ๊ณผ
ํ๋๊ทธ์ญ ๋๊ตฌ๋ ํธ์ถ์๊ฐ ๋ช ์ํ ์กฐ๊ฑด ์ดํ์ ํฌ์๋ ๋ฆฌํด ๋ฒ ์ด์ค๋ ์ดํธ๋ฅผ ์ธก์ ํฉ๋๋ค. ํต๋ , โ๋์ funding์ ์คํด์ฆ๋ฅผ ์๋ฏธโ, ์ ํผ๋ ์์ฒด ๋ฐ์ดํฐ์์ ๋์ถํ ๋ฒ ์ด์ค๋ ์ดํธ๋ก ๋์ฒดํฉ๋๋ค. ๋ฉ์ปค๋์ฆ์ ์๋์ ์ผ๋ก ๋ณด์์ ์ ๋๋ค:
- As-of ๋ฐฑ๋ถ์. ๊ฐ ์ญ์ฌ์ ์๊ฐ
t์์, ๋ฐฑ๋ถ์๋ก ๋ช ์๋ ์กฐ๊ฑด์t์ดํ์ ๋ฐ์ดํฐ์ ๋ํด์๋ง ์์๊ฐ ๋งค๊ฒจ์ง๋๋ค, ๋ฃฉ์ดํค๋ ์์. ๊ตฌ์กฐ์ ํํ์ด ์ ์ฉ๋ฉ๋๋ค: as-of ์์๋ ๊ทธ ์๋ฆฌ์ฆ๊ฐ 12๊ฐ ํ๋ณธ์ ๊ฐ์ง ๋์๋ง ์กด์ฌํ๋๋ฐ, ๋ ์ ์ฌ์ด์ ์์๋ ํดํ์ ์ด๊ธฐ ๋๋ฌธ์ ๋๋ค. ์์๊ฐ ์๊ณ๊ฐ์๋ ๊ทธ๋ฐ ํํ์ด ์์ต๋๋ค. - ๋งค์นญ. ๋งค์น๋ ๋ช ์๋ ๋ชจ๋ ์กฐ๊ฑด ํ๋๊ฐ ๋์์ ์ฑ๋ฆฝํ๋ ๋ชจ๋ ์๊ฐ์ ๋๋ค, ํ๋๋ AND๋ก ๊ฒฐํฉ๋ฉ๋๋ค.
- ํฌ์๋ ๋ฆฌํด. ํธ๋ผ์ด์ฆ๋ณ(๊ธฐ๋ณธ 4h / 24h / 72h):
r_h(t) = close(t+h) / close(t) โ 1 // ํธ๋ผ์ด์ฆ h์์์ ํฌ์๋ ๋ฆฌํด maxDD_h = min( low(t+1 โฆ t+h) ) / close(t) โ 1 // (t, t+h]์์ ์ต์ ์ ์๊ฐ๋ณ ์ ๊ฐ
- ์ค๋ฒ๋ฉ ๋ถ๊ดด. ๊ฒน์น๋ ํฌ์๋ ์๋์ฐ๋ ๋
๋ฆฝ ํ๋ณธ์ด ์๋๋ฏ๋ก, ๋งค์น๋ ์ต์ ํ ํธ๋ผ์ด์ฆ ๊ฐ๊ฒฉ์ผ๋ก ์์์ ธ
n_effective๋ฅผ ์ฐ์ถํฉ๋๋ค. ์์n_matches๋ ํจ๊ป ๋ณด๊ณ ๋ฉ๋๋ค. ๋ชจ๋ ํต๊ณ๋n_effective๋ก ๊ณ์ฐ๋ฉ๋๋ค. - ํด๋ฌ์คํฐ ๊ฒฝ๊ณ . ์๋ต์ ๊ฐ์ฅ ์กฐ๋ฐํ 14์ผ ์๋์ฐ ์์ ๋ค์ด๊ฐ๋ ์ ํจ ๋งค์น์ ๋น์จ์ ๋ณด๊ณ ํฉ๋๋ค, ํ๋์ ์คํด์ฆ ์ํผ์๋๊ฐ N๊ฐ์ ๋ ๋ฆฝ ์ํผ์๋๋ก ์์ฅํ๋ ๊ฒ์ ๋ํ ๋ฐฉ์ด์ฑ ์ ๋๋ค.
history_silentํ์ . ๋ชจ๋ ํธ๋ผ์ด์ฆ์์ ์ ํจ ๋งค์น๊ฐ 12๊ฐ ๋ฏธ๋ง์ด๋ฉด ํต๊ณ๋ null์ด๊ณ ํ์ ์history_silent๋ก ํ์๋ฉ๋๋ค. ์ด๊ฒ์ ์ผ๊ธ ๋ต๋ณ์ ๋๋ค, โํ์คํ ๋ฆฌ๊ฐ ์นจ๋ฌตํ๋ค; ๋น์ ์ ๋ฏฟ์์ผ๋ก ๊ฑฐ๋ํ๋ ๊ฒ์ด๋ ๊ทธ์ ๋ง๊ฒ ์ฌ์ด์ฆ๋ฅผ ์กฐ์ ํ๋ผโ, ์ค๋ฅ๊ฐ ์๋๋๋ค.- ๊ฐ๊ฒฉ ์๋ฆฌ์ฆ. ๋ฆฌํด์ Binance 1์๊ฐ ์ข
๊ฐ(
coverage.price_src)๋ก ๊ณ์ฐ๋ฉ๋๋ค, ์ค๊ณ์, ํ๋์ ๋ฐฑํ ์คํธ ์์์ ํตํฉ/venue ์ด์ด๋ถ์ธ ์๋ฆฌ์ฆ๋ ์ฌ์ฉํ์ง ์์ต๋๋ค. - ์์นด์ด๋ธ ํผ์ฒ(v2) ์กฐ๊ฑด.
obi_skew,oi_chg_1h_pct,taker_buy_ratio,basis_bps์ ๋ํ ์กฐ๊ฑด์ funding ์๋์ฐ๋ฅผ ์ด๋ฆฐ 15๋ถ ์์นด์ด๋ธ์ ๊ต์งํฉํฉ๋๋ค. ์๋ต ์๋์ฐ๋ ๊ทธ ๊ต์งํฉ์ ์ ์งํ๊ฒ ๋ณด๊ณ ํฉ๋๋ค.
์คํ ์ดํธ ํ์คํ ๋ฆฌ
15๋ถ ์์นด์ด๋ธ๋ ์์ฐ๋ณ๋ก ์๋น๋ ์ ์ฒด ๋ง์ผ ์คํ
์ดํธ๋ฅผ ์ ์ฅํฉ๋๋ค. get_state_history๋ ์์์ ์ซ์ํ ์ ํ๊ธฐ ํ๋, funding.percentile, oi.usd, obi.skew, ์ ๋ณ๋ ฌ ์๊ณ์ด ๋ฐฐ์ด์ max_points๋ก ๋ค์ด์ํ๋งํ์ฌ ๋ฐํํฉ๋๋ค. ์ฌ์ฉ๋ stride๊ฐ ๋ณด๊ณ ๋๋ฉฐ, ๊ฐ์ฅ ์ต์ ํ์ ๊ฒฐ์ฝ ์ํ๋ง์ผ๋ก ๋ฒ๋ ค์ง์ง ์์ต๋๋ค. ์์นด์ด๋ธ๋ ์ด๋ฆฝ๋๋ค, 2026-07-03์ ํ์ด๋ฌ์ต๋๋ค, ๊ทธ๋ฆฌ๊ณ ์์ผ๋ก ์๋ผ๋ฏ๋ก, ์์ ๋ต๋ณ์ ์ ์งํ ๊ฒ์ด์ง ๊ณ ์ฅ์ด ์๋๋๋ค.
๋๊ตฌ
get_market_state, ์์ฐ์ ๋ํ ํ๋์ ์ ๊ทํ๋ ๋ง์ผ ์คํ ์ดํธ ๊ฐ์ฒด.get_funding_percentile, ๋ค๋ ๋ฐฑ๋ถ์์ ํจ๊ป ์ ๊ณต๋๋ funding rate.get_liquidations_recent, ๋ค๋ฃจ๋ 3๊ฐ venue์ ์ต๊ทผ ์ฒญ์ฐ.get_ohlcv, ํตํฉ ํฌ๋ก์ค ์ต์ค์ฒด์ธ์ง ์บ๋ค.get_conditional_outcomes, ๋ช ์๋ ์กฐ๊ฑด ์ดํ์ ๋ฒ ์ด์ค๋ ์ดํธ ํฌ์๋ ๋ฆฌํด.get_state_history, 15๋ถ ์์นด์ด๋ธ์ ์๊ณ์ด ๋ฐฐ์ด.
์์ด์ ํธ ์ฐ๊ฒฐ ๋ฐฉ๋ฒ์ /agents๋ฅผ ์ฐธ๊ณ ํ์ธ์.
ํ๊ณ
- ๋ฐฑํ ์คํธ์ Binance ์ ์ฉ ๊ฐ๊ฒฉ. ์กฐ๊ฑด๋ถ ๊ฒฐ๊ณผ ์๋ฆฌ์ฆ๋ Binance 1์๊ฐ ์ข ๊ฐ๋ฅผ ์ฌ์ฉํฉ๋๋ค. ํตํฉ ๊ฐ๊ฒฉ ๋๋น ๋ธํ๋ ์ด ๋๊ตฌ๊ฐ ๋ณด๊ณ ํ๋ 4h ์ด์์ ํธ๋ผ์ด์ฆ์์ ์์ต๋๋ค.
- ์คํ
์ดํธ ์์นด์ด๋ธ๋ ์ด๋ฆฝ๋๋ค. 2026-07-03๋ถํฐ ์์ผ๋ก ์๋ผ๋ฏ๋ก, ์์นด์ด๋ธ ํผ์ฒ ์กฐ๊ฑด๊ณผ
get_state_history๋ ์ฑ์์ง ๋๊น์ง ์งง์ ์๋์ฐ๋ฅผ ๋ฐํํฉ๋๋ค. - ์์๋ ์ปค๋ฒ๋ฆฌ์ง ์ฃผ์์ฌํญ. ๊ฐ ๊ธฐ์ ์งํ ์์ฒด์ ์ฃผ์์ฌํญ์ด ๊ทธ๋๋ก ์ ํด์ง๋๋ค, ์ด๋ค ํ๋
์ด๋ ๊ทธ
coverageํญ๋ชฉ์ผ๋ก ๊ฐ์คํ์ธ์. - ์ฝ๊ธฐ ์ ์ฉ, ๊ธฐ์ ์ (descriptive). ํผ๋๋ ์ฝ๊ธฐ ์ ์ฉ์ด๋ฉฐ ๊ฒฐ์ฝ ํธ๋ ์ด๋ ์ถ์ฒ์ด ์๋๋๋ค. ์์ธก์ด ์๋ ํ์คํ ๋ฆฌ๋ฅผ ๋ณด๊ณ ํฉ๋๋ค.
๋ฒ์
๋ฐฉ๋ฒ๋ก ๋ฒ์ v1.4.1 ยท ์ ๋ฐ์ดํธ 2026-07-04. ์ค์ ๋ณ๊ฒฝ(์ ์ถ์ฒ, ๊ณต์ ์กฐ์ , ์๊ณ๊ฐ ๋ณ๊ฒฝ)์ ๋ฒ์ ์ ์ฌ๋ฆฌ๊ณ ์์ ๊ตฌ์กฐํ ๋ฐ์ดํฐ์ dateModified๋ฅผ ๊ฐฑ์ ํฉ๋๋ค.
v1.4.1 (2026-07-04): MCP ์์ด์ ํธ ํผ๋์ ์ฒซ ๊ณต๊ฐ ๋ฐฉ๋ฒ๋ก , ์ปค๋ฒ๋ฆฌ์ง ์ ์ง์ฑ ๋ชจ๋ธ, ์กฐ๊ฑด๋ถ ๊ฒฐ๊ณผ ํต๊ณ, 15๋ถ ์คํ ์ดํธ ์์นด์ด๋ธ.