AI ์—์ด์ „ํŠธ์šฉ ํฌ๋ฆฝํ†  MCP ์„œ๋ฒ„

MarketTrace๋Š” ํฌ๋ฆฝํ†  ๋ฌด๊ธฐํ•œ ์„ ๋ฌผ์šฉ ๋ฌด๋ฃŒยท์ฝ๊ธฐ ์ „์šฉ MCP ์„œ๋ฒ„๋ฅผ ์šด์˜ํ•ฉ๋‹ˆ๋‹ค. 10๊ฐœ ๋„๊ตฌ๊ฐ€ ์ตœ๋Œ€ 2๋…„ ์ด๋ ฅ ๋Œ€๋น„ ๋ฐฑ๋ถ„์œ„๊ฐ€ ๋ถ™์€ ํŽ€๋”ฉ๋น„, OI, ๊ฑฐ๋ž˜๋Ÿ‰, CVD, ์˜ค๋”๋ถ ๋ถˆ๊ท ํ˜•, ์ฒญ์‚ฐ, ๋ฒ ์ด์‹œ์Šค๋ฅผ ๋ฐ˜ํ™˜ํ•˜๊ณ , ๋ธํƒ€๊ฐ€ ๋‹ด๊ธด ์บ”๋“ค, ๋ณผ๋ฅจ ํ”„๋กœํŒŒ์ผ ๋ ˆ๋ฒจ, ๋Œ€ํ˜• ์ฒด๊ฒฐ, ํ’‹ํ”„๋ฆฐํŠธ ์ด๋ฒคํŠธ๋„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ๋Œ€์ƒ์€ BTC, ETH, SOL, BNB, XRP, DOGE, HYPE, ZEC, ENA์ด๊ณ  ๊ฑฐ๋ž˜์†Œ๋Š” Binance, Bybit, OKX, Hyperliquid์ด๋ฉฐ, ์ฒญ์‚ฐ์€ ์•ž์˜ ์„ธ ๊ณณ์—์„œ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค.

์‚ฌ์‹ค๊ณผ ์ •๊ทœํ™”๋งŒ ์ œ๊ณตํ•˜๊ณ  ํŒ๋‹จ์€ ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๋ชจ๋“  ์ง€ํ‘œ์—๋Š” ์ปค๋ฒ„๋ฆฌ์ง€(๊ทธ ๊ฐ’์„ ๋งŒ๋“  ๊ฑฐ๋ž˜์†Œ์™€ ๋’ค์— ์žˆ๋Š” ์ด๋ ฅ)๊ฐ€ ๋ถ™๊ณ , ๋ชจ๋“  ์‘๋‹ต์€ ๋ฐ์ดํ„ฐ์˜ ๋‚˜์ด๋ฅผ ๋ฐํž™๋‹ˆ๋‹ค. ์—์ด์ „ํŠธ๋Š” ์ˆซ์ž๋ฅผ ์˜ฎ๊ธฐ๊ธฐ ์ „์— ํƒ„ํƒ„ํ•œ ์ˆซ์ž์™€ ๊ทผ๊ฑฐ๊ฐ€ ์–‡์€ ์ˆซ์ž๋ฅผ ๊ตฌ๋ถ„ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์„œ๋ฒ„ URL
https://api.markettrace.ai/mcp
์ „์†ก ๋ฐฉ์‹
Streamable HTTP
๋กœ๊ทธ์ธ
์ด๋ฉ”์ผ ๋งํฌ OAuth. API ํ‚ค ์—†์Œ, ์นด๋“œ ์—†์Œ.
๊ถŒํ•œ
์ฝ๊ธฐ ์ „์šฉ. ๋ชจ๋“  ๋„๊ตฌ์— readOnlyHint๊ฐ€ ํ‘œ์‹œ๋ผ ์žˆ์Šต๋‹ˆ๋‹ค.
์ž์‚ฐ
BTC, ETH, SOL, BNB, XRP, DOGE, HYPE, ZEC, ENA
๊ฑฐ๋ž˜์†Œ
Binance, Bybit, OKX, Hyperliquid (์ฒญ์‚ฐ: Binance, Bybit, OKX)
๋ฒ„์ „
1.9.0, ์ถœ์‹œ์ผ 2026-10-06 ยท ๋ณ€๊ฒฝ ๋‚ด์—ญ
๋ ˆ์ง€์ŠคํŠธ๋ฆฌ ์ด๋ฆ„
ai.markettrace/agent-feed
๋„๊ตฌ ๋ช…์„ธ
GitHub์˜ tools.json, 10๊ฐœ ๋„๊ตฌ ์ „์ฒด์˜ ์ž…๋ ฅ ์Šคํ‚ค๋งˆ
๊ฐ€๊ฒฉ
๋ฌด๋ฃŒ

MCP ์„œ๋ฒ„ ์—ฐ๊ฒฐ

๋ชจ๋“  ํด๋ผ์ด์–ธํŠธ๊ฐ€ ๊ฐ™์€ URL๊ณผ ๊ฐ™์€ ๋กœ๊ทธ์ธ์„ ์”๋‹ˆ๋‹ค. ํด๋ผ์ด์–ธํŠธ๊ฐ€ ๋ธŒ๋ผ์šฐ์ €๋ฅผ ์—ด๋ฉด ์ด๋ฉ”์ผ์„ ์ž…๋ ฅํ•˜๊ณ , ์ €ํฌ๊ฐ€ ๋กœ๊ทธ์ธ ๋งํฌ๋ฅผ ๋ณด๋‚ด๋“œ๋ฆฝ๋‹ˆ๋‹ค. ๋กœ๊ทธ์ธ์„ ์‹œ์ž‘ํ•œ ๊ฐ™์€ ๊ธฐ๊ธฐ, ๊ฐ™์€ ๋ธŒ๋ผ์šฐ์ €์—์„œ ์—ฌ์„ธ์š”. ๋‹ค๋ฅธ ๊ธฐ๊ธฐ์—์„œ ์—ด๋ฉด ๋กœ๊ทธ์ธ์ด ์™„๋ฃŒ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

Claude (์›น๊ณผ ๋ฐ์Šคํฌํ†ฑ)

  1. Claude์—์„œ: Settings โ†’ Connectors โ†’ Add custom connector.
  2. ์„œ๋ฒ„ URL ๋ถ™์—ฌ๋„ฃ๊ธฐ: https://api.markettrace.ai/mcp
  3. ์š”์ฒญ ์‹œ ์ธ์ฆํ•˜๊ณ  ์ด๋ฉ”์ผ๋กœ ๋ฐ›์€ ๋งํฌ๋ฅผ ์—ฌ์„ธ์š”.
  4. ๋ฐ”๋กœ ์งˆ๋ฌธํ•˜์„ธ์š”. ํ”ผ๋“œ๋Š” ์ฝ๊ธฐ ์ „์šฉ์ด๋ฉฐ ๊ฑฐ๋ž˜๋‚˜ ์ž๊ธˆ ์ด๋™์ด ๋ถˆ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.

Claude Code์™€ Codex๋Š” ํ„ฐ๋ฏธ๋„์—์„œ ๋‘ ๋‹จ๊ณ„๋กœ ์—ฐ๊ฒฐํ•ฉ๋‹ˆ๋‹ค. ์„œ๋ฒ„๋ฅผ ์ถ”๊ฐ€ํ•˜๋Š” ๊ฒƒ๋งŒ์œผ๋กœ๋Š” ๋กœ๊ทธ์ธ๋˜์ง€ ์•Š์œผ๋‹ˆ ๋‘ ๋ช…๋ น์„ ๋ชจ๋‘ ์‹คํ–‰ํ•˜์„ธ์š”.

Claude Code

  1. ์„œ๋ฒ„ ์ถ”๊ฐ€:
    claude mcp add --transport http markettrace https://api.markettrace.ai/mcp
  2. ๋กœ๊ทธ์ธ(๋ธŒ๋ผ์šฐ์ €๊ฐ€ ์—ด๋ฆฝ๋‹ˆ๋‹ค):
    claude mcp login markettrace

์‚ฌ์šฉ ์ค‘์ธ Claude Code์— mcp login ๋ช…๋ น์ด ์—†๋‹ค๋ฉด ์„ธ์…˜์„ ์‹œ์ž‘ํ•ด /mcp๋ฅผ ์ž…๋ ฅํ•˜๊ณ  markettrace๋ฅผ ๊ณ ๋ฅธ ๋’ค Authenticate๋ฅผ ์„ ํƒํ•˜์„ธ์š”.

Codex

  1. ์„œ๋ฒ„ ์ถ”๊ฐ€:
    codex mcp add markettrace --url https://api.markettrace.ai/mcp
  2. ๋กœ๊ทธ์ธ(๋ธŒ๋ผ์šฐ์ €๊ฐ€ ์—ด๋ฆฝ๋‹ˆ๋‹ค):
    codex mcp login markettrace

Cursor

Add to Cursor ๋ฒ„ํŠผ์„ ์“ฐ๊ฑฐ๋‚˜ ~/.cursor/mcp.json์— ์„œ๋ฒ„๋ฅผ ์ถ”๊ฐ€ํ•œ ๋’ค, Cursor๊ฐ€ ์š”์ฒญํ•˜๋ฉด ๋กœ๊ทธ์ธํ•˜์„ธ์š”.

Add to Cursor

{
  "mcpServers": {
    "markettrace": {
      "url": "https://api.markettrace.ai/mcp"
    }
  }
}

๊ธฐํƒ€ ํด๋ผ์ด์–ธํŠธ์™€ ์ง์ ‘ ๋งŒ๋“  ์—์ด์ „ํŠธ

stdio ์ „์šฉ ํด๋ผ์ด์–ธํŠธ๋Š” ํ‘œ์ค€ mcp-remote ๋ธŒ๋ฆฌ์ง€๋กœ ์—ฐ๊ฒฐํ•˜๋ฉฐ, ๋กœ๊ทธ์ธ๋„ ๋ธŒ๋ฆฌ์ง€๊ฐ€ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค:

{
  "mcpServers": {
    "markettrace": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.markettrace.ai/mcp"
      ]
    }
  }
}

์ง์ ‘ ๋งŒ๋“  ์—์ด์ „ํŠธ๋Š” OAuth๋ฅผ ์ง€์›ํ•˜๋Š” MCP ํด๋ผ์ด์–ธํŠธ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ผ๋ฉด ๋ฌด์—‡์ด๋“  ์“ธ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๊ณต์‹ TypeScriptยทPython SDK์— ํฌํ•จ๋ผ ์žˆ์Šต๋‹ˆ๋‹ค. ์ธ์ฆ ์—†๋Š” ์š”์ฒญ์€ ์„œ๋ฒ„์˜ OAuth ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ๋ฅผ ๊ฐ€๋ฆฌํ‚ค๋Š” WWW-Authenticate ํ—ค๋”์™€ ํ•จ๊ป˜ HTTP 401์„ ๋ฐ›์œผ๋ฏ€๋กœ, ํด๋ผ์ด์–ธํŠธ๊ฐ€ ๋กœ๊ทธ์ธ ์ ˆ์ฐจ๋ฅผ ์Šค์Šค๋กœ ์ฐพ์Šต๋‹ˆ๋‹ค.

๊ณต์‹ MCP ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ์— ai.markettrace/agent-feed๋กœ ๋“ฑ์žฌ.

์˜คํ”ˆ์†Œ์Šค ๋ธŒ๋ฆฌ์ง€ ๋ฐ ๋ฌธ์„œ (GitHub)

์ด๋Ÿฐ ๊ฑธ ๋ฌผ์–ด๋ณด์„ธ์š”

ํ‰๋ฒ”ํ•œ ์งˆ๋ฌธ์ด๋ฉด ๋ฉ๋‹ˆ๋‹ค. ํ™”์‚ดํ‘œ๋Š” ์—์ด์ „ํŠธ๊ฐ€ ์“ฐ๋Š” ๋„๊ตฌ์ž…๋‹ˆ๋‹ค.

MCP ๋„๊ตฌ: ํŽ€๋”ฉ, OI, CVD, ์ฒญ์‚ฐ, ๋ณผ๋ฅจ ํ”„๋กœํŒŒ์ผ, ํ’‹ํ”„๋ฆฐํŠธ

10๊ฐœ ๋„๊ตฌ ๋ชจ๋‘ ์ฝ๊ธฐ ์ „์šฉ์ž…๋‹ˆ๋‹ค. ๊ฐ ๋„๊ตฌ๋Š” ์‹ฌ๋ณผ์„ ๋ฐ›์Šต๋‹ˆ๋‹ค: BTC, ETH, SOL, BNB, XRP, DOGE, HYPE, ZEC, ENA. BTCUSDT ๊ฐ™์€ ์ด๋ฆ„๋„ ๋ฉ๋‹ˆ๋‹ค.

get_market_state: ์‹œ์žฅ ์ „์ฒด๋ฅผ ํ•œ ๋ฒˆ์˜ ํ˜ธ์ถœ๋กœ

์ž์‚ฐ๋ณ„ ์ •๊ทœํ™” ์Šค๋ƒ…์ƒท ํ•˜๋‚˜. ๋„ค ๊ฑฐ๋ž˜์†Œ๋ฅผ ํ•ฉ์นœ ๊ฐ’์ž…๋‹ˆ๋‹ค. ์—ฌ๊ธฐ์„œ ์‹œ์ž‘ํ•˜์„ธ์š”.

์งˆ๋ฌธ ์˜ˆ
โ€œBTC ์‹œ์žฅ ์ƒํƒœ๋Š”?โ€ ยท โ€œETH ํฌ์ง€์…”๋‹์ด ๊ณผ์—ด๋๋‚˜?โ€
๋ฐ˜ํ™˜๊ฐ’
๊ฐ€๊ฒฉ๊ณผ 1hยท4hยท24h ๋ณ€๋™๋ฅ , 1h ATR, 24h ์‹คํ˜„ ๋ณ€๋™์„ฑ. ํŽ€๋”ฉ๋น„, ๋ฐฑ๋ถ„์œ„, ์ง€์† ์‹œ๊ฐ„. OI(USD), 1h ๋ณ€ํ™”์œจ, 1dยท1wยท1m ์ค‘์•™๊ฐ’ ๋Œ€๋น„ ๋ฐฐ์ˆ˜. 24h ๊ฑฐ๋ž˜๋Ÿ‰. 30๋ถ„ CVD(USD)์™€ ํ…Œ์ด์ปค ๋งค์ˆ˜ ๋น„์œจ. โˆ’1์—์„œ +1 ์‚ฌ์ด์˜ ์˜ค๋”๋ถ ๋ถˆ๊ท ํ˜•๊ณผ 10ยท25ยท50 bps ์ด๋‚ด ํ˜ธ๊ฐ€ ๊นŠ์ด. ์ตœ๊ทผ 1์‹œ๊ฐ„ ์ฒญ์‚ฐ์•ก, ๋กฑ ๋น„์ค‘, ๋ฐฑ๋ถ„์œ„. ๋ฒ ์ด์‹œ์Šค. ๊ฑฐ๋ž˜์†Œ๋ณ„ ๊ฐ’, ๋‹ค์Œ ํŽ€๋”ฉ ์‹œ๊ฐ, ๊ทธ๋ฆฌ๊ณ  drivers: ๋ˆˆ์— ๋„๋Š” ์ ์„ ๋ช‡ ์ค„๋กœ ์š”์•ฝํ•œ ํ…์ŠคํŠธ.

์‚ฌ์ดํŠธ์—์„œ: ์‹œ์žฅ ํฌ์ง€์…”๋‹ ยท ํ˜ธ๊ฐ€ ๊นŠ์ด

get_funding_percentile: ํŽ€๋”ฉ๋น„๊ฐ€ ์ด๋ก€์ ์œผ๋กœ ๋†’์€๊ฐ€?

ํ˜„์žฌ ํŽ€๋”ฉ๋น„๋ฅผ ์ž์‚ฐ ์ž์ฒด ์ด๋ ฅ ๋Œ€๋น„ 0~100์œผ๋กœ ์ˆœ์œ„๋ฅผ ๋งค๊ธฐ๊ณ , ๊ฐ™์€ ๋ถ€ํ˜ธ๊ฐ€ ์œ ์ง€๋œ ์‹œ๊ฐ„์„ ํ•จ๊ป˜ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

๋ฐ˜ํ™˜๊ฐ’
rate_bps(8h ๊ธฐ์ค€ ํ™˜์‚ฐ, ์–‘์ˆ˜๋ฉด ๋กฑ์ด ์ˆ์—๊ฒŒ ์ง€๊ธ‰), percentile, streak_h, coverage.
์ด๋ ฅ
์ตœ๋Œ€ 730์ผ. ์ด๋ ฅ์ด ์งง์€ ์ž์‚ฐ์€ ์žˆ๋Š” ๋งŒํผ์œผ๋กœ ์ˆœ์œ„๋ฅผ ๋งค๊ธฐ๋ฉฐ, ๊ทธ ๊ธธ์ด๋Š” coverage.window_days์— ๋‚˜์˜ต๋‹ˆ๋‹ค. ๊ฑฐ๋ž˜์†Œ ํ†ตํ•ฉ ํŽ€๋”ฉ๋น„์™€ ๊ทธ ์ˆœ์œ„์—๋Š” ํŽ€๋”ฉ ์ด๋ ฅ์ด 365์ผ ์ด์ƒ์ธ ๊ฑฐ๋ž˜์†Œ๋งŒ ์”๋‹ˆ๋‹ค.

์‚ฌ์ดํŠธ์—์„œ: ํŽ€๋”ฉ๋น„ ยท ๋ฐฐ๊ฒฝ: ํŽ€๋”ฉ๋น„

get_liquidations_recent: ๋ˆ„๊ฐ€ ์ฒญ์‚ฐ๋๋‚˜

BinanceยทBybitยทOKX์˜ ์ฒญ์‚ฐ ํ•ฉ๊ณ„. ๊ตฌ๊ฐ„์€ ์ตœ๋Œ€ 24์‹œ๊ฐ„.

์ž…๋ ฅ
window_s(์ดˆ), ๊ธฐ๋ณธ๊ฐ’ 3600, ์ตœ๋Œ€ 86400.
๋ฐ˜ํ™˜๊ฐ’
์ด USD, ๋กฑยท์ˆ USD, long_ratio(๋กฑ ๋น„์ค‘, 0~1), ์ด๋ฒคํŠธ ์ˆ˜.
์ฐธ๊ณ 
USD ๊ฐ’์€ ์ถ”์ •์น˜์ž…๋‹ˆ๋‹ค: ๊ธฐ์ดˆ ์ˆ˜๋Ÿ‰ ร— ๊ฑฐ๋ž˜์†Œ๋ณ„ ๊ธฐ์ค€ ๊ฐ€๊ฒฉ์ด๋ฉฐ, Bybit์™€ OKX๋Š” ํŒŒ์‚ฐ ๊ฐ€๊ฒฉ์„ ๊ณต๊ฐœํ•ฉ๋‹ˆ๋‹ค. Hyperliquid ์ฒญ์‚ฐ์€ ํฌํ•จํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

์‚ฌ์ดํŠธ์—์„œ: ์ฒญ์‚ฐ ยท ์ฒญ์‚ฐ ๋ฐฉ๋ฒ•๋ก 

get_ohlcv: ๋ธํƒ€๊ฐ€ ๋‹ด๊ธด ์บ”๋“ค

๋„ค ๊ฑฐ๋ž˜์†Œ์˜ ์ฒด๊ฒฐ์„ ํ•˜๋‚˜์˜ ํƒ€์ž„๋ผ์ธ์œผ๋กœ ๋ฌถ์€ ์บ”๋“ค. ์บ”๋“ค๋งˆ๋‹ค ํ…Œ์ด์ปค ๋ธํƒ€๊ฐ€ ๋“ค์–ด ์žˆ์Šต๋‹ˆ๋‹ค.

์ž…๋ ฅ
interval 5m, 15m, 1h, 4h, 1d(๊ธฐ๋ณธ 1h), limit 1~200(๊ธฐ๋ณธ 100).
๋ฐ˜ํ™˜๊ฐ’
t(์บ”๋“ค ์‹œ์ž‘, epoch ms), oยทhยทlยทc(USD), v์™€ delta(๊ธฐ์ดˆ ์ž์‚ฐ ๋‹จ์œ„: BTC, ETH ๋“ฑ), ์•„์ง ํ˜•์„ฑ ์ค‘์ธ ์บ”๋“ค์—๋Š” partial. ์—ฌ๋Ÿฌ ์บ”๋“ค์˜ delta๋ฅผ ๋”ํ•˜๋ฉด ๊ทธ ๊ตฌ๊ฐ„์˜ CVD๊ฐ€ ๋ฉ๋‹ˆ๋‹ค.
๋ฒ”์œ„
ํ…Œ์ดํ”„๋Š” 31์ผ์น˜๋ผ 1d๋Š” 31๊ฐœ, 4h๋Š” 186๊ฐœ๊นŒ์ง€์ž…๋‹ˆ๋‹ค. ZEC์™€ ENA๋Š” 14์ผ์น˜์ž…๋‹ˆ๋‹ค.

์‚ฌ์ดํŠธ์—์„œ: ํ’‹ํ”„๋ฆฐํŠธ ์ฐจํŠธ ยท ๋ฐฐ๊ฒฝ: CVD

get_conditional_outcomes: ์ด ์กฐ๊ฑด ๋’ค์— ๋ฌด์Šจ ์ผ์ด ์žˆ์—ˆ๋‚˜

์ง€์ •ํ•œ ์กฐ๊ฑด ์ดํ›„์˜ ์„ ํ–‰ ์ˆ˜์ต๋ฅ ์„ ํ”ผ๋“œ ์ž์ฒด ์ด๋ ฅ์œผ๋กœ ์ธก์ •ํ•ฉ๋‹ˆ๋‹ค.

์กฐ๊ฑด
ํŽ€๋”ฉ ๋ฐฑ๋ถ„์œ„ ๊ตฌ๊ฐ„(funding_pct_gte, funding_pct_lte), funding_sign, streak_h_gte, ๋˜๋Š” ์•„์นด์ด๋ธŒ ์ง€ํ‘œ ํ•˜๋‚˜(obi_skew, oi_chg_1h_pct, taker_buy_ratio, basis_bps)๋ฅผ ๊ฐ’์ด๋‚˜ ๋ฐฑ๋ถ„์œ„๋กœ. ์กฐ๊ฑด์€ AND๋กœ ๊ฒฐํ•ฉ๋ฉ๋‹ˆ๋‹ค.
๊ธฐ๊ฐ„
๊ธฐ๋ณธ 4h, 24h, 72h. 1h~168h ์ค‘ ์•„๋ฌด ๊ฐ’์ด๋‚˜ ์ง€์ • ๊ฐ€๋Šฅ.
๋ฐ˜ํ™˜๊ฐ’
๊ธฐ๊ฐ„๋ณ„๋กœ: n_matches์™€ n_effective(๊ฒน์น˜๋Š” ๊ตฌ๊ฐ„์„ ํ•ฉ์นœ ๋’ค), ์ˆ˜์ต๋ฅ  ์ค‘์•™๊ฐ’ยทp10ยทp90(%), ์ƒ์Šน ๋น„์œจ, ๋‚™ํญ ์ค‘์•™๊ฐ’. ์ผ์น˜ํ•œ ํƒ€์ž„์Šคํƒฌํ”„ ์ตœ๋Œ€ 50๊ฐœ์™€, ์ตœ๊ทผ 1์‹œ๊ฐ„์ด ๊ฐ™์€ ์ถ•์—์„œ ์–ด๋””์— ์žˆ๋Š”์ง€.
history_silent
๋ชจ๋“  ๊ธฐ๊ฐ„์—์„œ ๋…๋ฆฝ์ ์ธ ์ผ์น˜๊ฐ€ 12๊ฑด ๋ฏธ๋งŒ. ํ†ต๊ณ„๋Š” null๋กœ ๋Œ์•„์˜ค๋ฉฐ ๊ทธ๊ฒƒ์ด ๋‹ต์ž…๋‹ˆ๋‹ค: ์ธก์ •ํ•˜๊ธฐ์—๋Š” ์ด๋ ฅ์ด ๋„ˆ๋ฌด ์–‡์Šต๋‹ˆ๋‹ค.
๋ฐฉ๋ฒ•
๋ฐฑ๋ถ„์œ„๋Š” as-of ๋ฐฉ์‹์ž…๋‹ˆ๋‹ค: ๊ฐ ์‹œ๊ฐ„์€ ๊ทธ ์‹œ์ ์— ์กด์žฌํ•˜๋˜ ๋ฐ์ดํ„ฐ์™€๋งŒ ๋น„๊ตํ•ฉ๋‹ˆ๋‹ค. ์ˆ˜์ต๋ฅ ์€ Binance 1h ์ข…๊ฐ€๋ฅผ ์”๋‹ˆ๋‹ค.

๋ฐฐ๊ฒฝ: ์กฐ๊ฑด๋ถ€ ๊ฒฐ๊ณผ ยท ํŽ€๋”ฉ๋น„ ๊ทน๋‹จ๊ฐ’ ์—ฐ๊ตฌ ยท ๋ฐฉ๋ฒ•๋ก 

get_state_history: ์—ฌ๊ธฐ๊นŒ์ง€ ์˜จ ๊ณผ์ •

get_market_state์˜ ๋ชจ๋“  ์ˆ˜์น˜ ํ•„๋“œ์˜ ์‹œ๊ณ„์—ด. 2026-07-03์— ์‹œ์ž‘๋œ 15๋ถ„ ์•„์นด์ด๋ธŒ์—์„œ ์ฝ์Šต๋‹ˆ๋‹ค.

์ž…๋ ฅ
fields(funding.percentile, oi.usd, obi.skew, venues.binance.oi_usd ๊ฐ™์€ ์  ๊ฒฝ๋กœ 1~16๊ฐœ), from๊ณผ to(RFC 3339, YYYY-MM-DD, epoch ms), max_points 1~1000(๊ธฐ๋ณธ 200).
๋ฐ˜ํ™˜๊ฐ’
t(epoch ms)์™€ ํ•„๋“œ๋ณ„๋กœ ์ •๋ ฌ๋œ ๋ฐฐ์—ด. stride๋Š” ๊ฐ ์ ์ด ๋ช‡ ํ–‰์„ ๊ฑด๋„ˆ๋›ฐ๋Š”์ง€ ์•Œ๋ ค ์ฃผ๊ณ , null์€ ๊ทธ ํ–‰์—์„œ ํ•„๋“œ๊ฐ€ ๋น„์–ด ์žˆ์—ˆ์Œ์„ ๋œปํ•ฉ๋‹ˆ๋‹ค.

๋ฐฐ๊ฒฝ: ์Šคํ…Œ์ดํŠธ ํžˆ์Šคํ† ๋ฆฌ

get_volume_profile: ๊ฑฐ๋ž˜๋Ÿ‰์ด ๋ชฐ๋ฆฐ ๊ณณ

๋„ค ๊ฑฐ๋ž˜์†Œ๋ฅผ ํ•ฉ์นœ ํ…Œ์ดํ”„๋กœ UTC ์ผ๋ณ„ POC์™€ ๋ฐธ๋ฅ˜ ์—์–ด๋ฆฌ์–ด ์ƒ๋‹จยทํ•˜๋‹จ์„ ๊ณ„์‚ฐํ•ฉ๋‹ˆ๋‹ค.

์ž…๋ ฅ
days, ์™„๋ฃŒ๋œ 1~30์ผ(๊ธฐ๋ณธ 7).
๋ฐ˜ํ™˜๊ฐ’
์˜ค๋Š˜(ํ˜•์„ฑ ์ค‘), ์™„๋ฃŒ๋œ ๊ฐ ๋‚ , ๊ธฐ๊ฐ„ ์ „์ฒด ํ•ฉ์„ฑ ํ”„๋กœํŒŒ์ผ, ๊ทธ๋ฆฌ๊ณ  ์ตœ๊ทผ 30์ผ ์ค‘ ๊ฐ€๊ฒฉ์ด ์•„์ง ๋Œ์•„์˜ค์ง€ ์•Š์€ ๋„ค์ดํ‚ค๋“œ POC. ํ”„๋กœํŒŒ์ผ๋ณ„๋กœ pocยทvahยทval(USD), va_width_pct, ๊ธฐ์ดˆ ์ž์‚ฐ ๋‹จ์œ„ ๊ฑฐ๋ž˜๋Ÿ‰, taker_buy_ratio. ๋ฐธ๋ฅ˜ ์—์–ด๋ฆฌ์–ด๋Š” ํ•˜๋ฃจ ๊ฑฐ๋ž˜๋Ÿ‰์˜ 70%๋ฅผ ๋‹ด์Šต๋‹ˆ๋‹ค.

์‚ฌ์ดํŠธ์—์„œ: ๋ณผ๋ฅจ ํ”„๋กœํŒŒ์ผ ยท ๋ฐฐ๊ฒฝ: ๋ณผ๋ฅจ ํ”„๋กœํŒŒ์ผ

get_big_trades: ๋Œ€ํ˜• ์‹œ์žฅ๊ฐ€ ์ฃผ๋ฌธ

์ฒด๊ฒฐ ํ…Œ์ดํ”„์˜ ๋Œ€ํ˜• ๊ณต๊ฒฉ์  ์ฃผ๋ฌธ. ๊ฑฐ๋ž˜์†Œยทํ…Œ์ด์ปค ๋ฐฉํ–ฅยทํƒ€์ž„์Šคํƒฌํ”„๊ฐ€ ๊ฐ™์€ ์ฒด๊ฒฐ์€ ํ•˜๋‚˜๋กœ ํ•ฉ์น˜๋ฏ€๋กœ, ์—ฌ๋Ÿฌ ๊ฐ€๊ฒฉ๋Œ€๋ฅผ ์“ธ๊ณ  ๊ฐ„ ์‹œ์žฅ๊ฐ€ ์ฃผ๋ฌธ๋„ ํ•œ ๋ฒˆ์œผ๋กœ ์…‰๋‹ˆ๋‹ค.

์ž…๋ ฅ
from๊ณผ to(๊ธฐ๋ณธ์€ ์ตœ๊ทผ 1์‹œ๊ฐ„, ํ˜ธ์ถœ๋‹น ์ตœ๋Œ€ 12์‹œ๊ฐ„, 31์ผ ์ด๋‚ด), min_usd(์ตœ์†Œ 50,000), limit 1~150(๊ธฐ๋ณธ 50).
๊ธฐ๋ณธ๊ฐ’
๊ธฐ์ค€๊ฐ’์€ ํ’‹ํ”„๋ฆฐํŠธ ์ฐจํŠธ์™€ ๊ฐ™์Šต๋‹ˆ๋‹ค: BTC์™€ ETH๋Š” $1M, SOLยทBNBยทXRPยทDOGEยทHYPE๋Š” $500K, ZEC์™€ ENA๋Š” $100K.
๋ฐ˜ํ™˜๊ฐ’
๋ฐฉํ–ฅ๋ณ„ ๊ฑด์ˆ˜์™€ USD, ๊ทธ๋ฆฌ๊ณ  ๊ฐ€์žฅ ํฐ ์ฒด๊ฒฐ(์‹œ๊ฐ, ๊ฑฐ๋ž˜์†Œ, ๋ฐฉํ–ฅ, ๊ฐ€๊ฒฉ, USD ๊ทœ๋ชจ).

์‚ฌ์ดํŠธ์—์„œ: ํ’‹ํ”„๋ฆฐํŠธ ์ฐจํŠธ

get_footprint_events: ํก์ˆ˜๋˜๊ฑฐ๋‚˜ ์ฒ ํšŒ๋œ ๋ฒฝ

1๋ถ„ ํ’‹ํ”„๋ฆฐํŠธ์˜ ์˜ค๋”๋ถ ๋ฒฝ ์ด๋ฒคํŠธ. ๋ฒฝ์€ ํ˜ธ๊ฐ€์ฐฝ ์ค‘์•™๊ฐ’ ํ–‰ + 5 MAD๋ณด๋‹ค ํฐ ๋Œ€๊ธฐ ์ฃผ๋ฌธ ๊ฐ€๊ฒฉ ํ–‰์ž…๋‹ˆ๋‹ค.

ํก์ˆ˜
์ฒด๊ฒฐ์ด ๋ฒฝ ์ตœ๊ณ ์น˜์˜ 5% ์ด์ƒ์„ ์†Œํ™”ํ–ˆ๊ณ , ๊ทธ ๋ถ„์˜ ์ข…๋ฃŒ ์‹œ์ ์— ์ตœ๊ณ ์น˜์˜ 85% ์ด์ƒ์ด ๋‚จ์•„ ์žˆ์—ˆ์œผ๋ฉฐ, ๊ฐ€๊ฒฉ์ด ๋šซ์ง€ ๋ชปํ–ˆ๋‹ค.
์ฒ ํšŒ
์ฒด๊ฒฐ์ด ๊ฐ์†Œ๋ถ„์˜ 30% ๋ฏธ๋งŒ๋งŒ ์„ค๋ช…ํ•˜๋Š” ์ƒํƒœ์—์„œ ๋ฒฝ์ด ์ตœ๊ณ ์น˜์˜ ์ ˆ๋ฐ˜ ์•„๋ž˜๋กœ ์ค„์—ˆ๊ณ , 2์ดˆ ์•ˆ์— ๋‹ค์‹œ ์ฑ„์›Œ์ง€์ง€ ์•Š์•˜์œผ๋ฉฐ, ๊ฐ€๊ฒฉ์ด ๋‹ฟ์„ ๊ฑฐ๋ฆฌ๊นŒ์ง€ ์™€ ์žˆ์—ˆ๋‹ค.
์ž…๋ ฅ
from๊ณผ to(๊ธฐ๋ณธ์€ ์ตœ๊ทผ 1์‹œ๊ฐ„, ํ˜ธ์ถœ๋‹น ์ตœ๋Œ€ 24์‹œ๊ฐ„), kinds(absorbed, pulled), min_usd, limit 1~150.
๋ฐ˜ํ™˜๊ฐ’
์ด๋ฒคํŠธ๋ณ„ ๋ถ„, ์ข…๋ฅ˜, ๋ฐฉํ–ฅ, ๊ฐ€๊ฒฉ, ์ตœ๊ณ ยท์ฒด๊ฒฐยท์ข…๋ฃŒ ๊ทœ๋ชจ(USD). ๊ทธ๋ฆฌ๊ณ  ๋ฐฉํ–ฅ๋ณ„๋กœ ํ˜ธ๊ฐ€์ฐฝ์ด ์–‡์•˜๋˜ ๋ถ„ ์ˆ˜.
์ด๋ ฅ
2026-10-03๋ถ€ํ„ฐ ๊ธฐ๋ก. ์•„์นด์ด๋ธŒ๋Š” ์•ž์œผ๋กœ ๊ณ„์† ์Œ“์ž…๋‹ˆ๋‹ค.

์‚ฌ์ดํŠธ์—์„œ: ํ’‹ํ”„๋ฆฐํŠธ ์ฐจํŠธ ยท ํ˜ธ๊ฐ€ ๊นŠ์ด

get_stacked_imbalances: ํ•œ์ชฝ์œผ๋กœ ์Œ“์ธ ๊ณต๊ฒฉ์  ์ฃผ๋ฌธ

MarketTrace ํ’‹ํ”„๋ฆฐํŠธ ์ฐจํŠธ์™€ ๊ฐ™์€ ๋Œ€๊ฐ์„  ๊ทœ์น™์œผ๋กœ ์ฐพ์€ ๋ˆ„์  ๋ถˆ๊ท ํ˜•. ์–ด๋–ค ํ–‰์˜ ์‹œ์žฅ๊ฐ€ ๋งค์ˆ˜๊ฐ€ ๋ฐ”๋กœ ์•„๋ž˜ ์ฒด๊ฒฐ ํ–‰์˜ ์‹œ์žฅ๊ฐ€ ๋งค๋„์— ์ง€์ • ๋ฐฐ์œจ์„ ๊ณฑํ•œ ๊ฐ’ ์ด์ƒ์ด๋ฉด ๋งค์ˆ˜ ๋ถˆ๊ท ํ˜•, ์œ„ ํ–‰๊ณผ ๋น„๊ตํ•ด ๋ฐ˜๋Œ€์ธ ๊ฒฝ์šฐ๋Š” ๋งค๋„ ๋ถˆ๊ท ํ˜•์ž…๋‹ˆ๋‹ค. ๊ฐ™์€ ๋ฐฉํ–ฅ์œผ๋กœ 3ํ–‰ ์ด์ƒ ์—ฐ์†๋˜๋ฉด ๋ˆ„์ ์œผ๋กœ ๋ด…๋‹ˆ๋‹ค.

์ž…๋ ฅ
interval 1m, 5m, 15m, 1h(๊ธฐ๋ณธ 1m), ratio 2, 3, 4(๊ธฐ๋ณธ 3), kinds(buy, sell), from๊ณผ to(ํ˜ธ์ถœ๋‹น ์ตœ๋Œ€ 12์‹œ๊ฐ„, 31์ผ ์ด๋‚ด), limit 1~150.
๋ฐ˜ํ™˜๊ฐ’
๊ตฌ๊ฐ„๋ณ„ ์บ”๋“ค ์‹œ๊ฐ, ๋ฐฉํ–ฅ, ๊ฐ€๊ฒฉ ๋ฒ”์œ„, ํ–‰ ์ˆ˜, USD ๊ทœ๋ชจ. ๊ทธ๋ฆฌ๊ณ  ๋ฐฉํ–ฅ๋ณ„ ๊ฑด์ˆ˜.
๊ทœ๋ชจ
BTC, ratio 3 ๊ธฐ์ค€์œผ๋กœ ๋ณดํ†ต ํ•œ ์‹œ๊ฐ„์— 1m ์บ”๋“ค์€ ์•ฝ 38๊ฑด, 5m์€ 13๊ฑด, 15m์€ 4๊ฑด, 1h๋Š” 1๊ฑด์ž…๋‹ˆ๋‹ค.

์‚ฌ์ดํŠธ์—์„œ: ํ’‹ํ”„๋ฆฐํŠธ ์ฐจํŠธ ยท ๋ฐฐ๊ฒฝ: ํ’‹ํ”„๋ฆฐํŠธ

์‘๋‹ต ์˜ˆ์‹œ

2026-10-06 13:58 UTC ๊ธฐ์ค€ BTC์˜ get_market_state๋ฅผ ์ฃผ์š” ๋ธ”๋ก๋งŒ ๋‚จ๊ธด ๊ฒƒ์ž…๋‹ˆ๋‹ค. ์ „์ฒด ์‘๋‹ต์—๋Š” ๊ฑฐ๋ž˜์†Œ๋ณ„ ๊ฐ’, ํ˜ธ๊ฐ€ ๊นŠ์ด, ํŽ€๋”ฉ ์ผ์ •, ๋ธ”๋ก๋ณ„ ์ปค๋ฒ„๋ฆฌ์ง€๋„ ๋“ค์–ด ์žˆ์Šต๋‹ˆ๋‹ค.

{
  "symbol": "BTC",
  "as_of": "2026-10-06T13:58:41Z",
  "age_seconds": 20,
  "price": { "last": 86267.813, "chg_1h_pct": 0.09, "chg_24h_pct": -0.2, "atr_1h_pct": 0.36, "rv_24h_pct": 32.7 },
  "funding": { "rate_bps": 0.28, "percentile": 26, "streak_h": 680 },
  "oi": { "usd": 19175427019, "chg_1h_pct": 0.14, "rel": { "1d": 1.0195, "1w": 1.0345, "1m": 1.059 } },
  "volume": { "usd_24h": 22309245455, "rel": { "1d": 1.3568, "1w": 1.416, "1m": 1.2496 } },
  "cvd": { "window": "30m", "delta_usd": 121145644, "taker_buy_ratio": 0.5558 },
  "obi": { "skew": -0.0097 },
  "liq": { "usd_1h": 1276732, "long_ratio": 0.0614, "percentile": { "1w": 80, "1m": 87 } },
  "basis_bps": -6.33,
  "drivers": [
    "funding 26th pct (730d, binance+bybit+hyperliquid)",
    "OI 1.1x monthly median",
    "volume 1.4x weekly median",
    "liq 80th pct (1w), 6% longs",
    "OI +0.1%/1h, price +0.1% โ€” new longs"
  ],
  "coverage": {
    "funding": { "venues": ["binance", "bybit", "hyperliquid"], "window_days": 730, "n_samples": 2190, "partial": false },
    "liq": { "venues": ["binance", "bybit", "okx"], "partial": false },
    "basis": { "venues": ["binance"], "partial": true }
  },
  "stale_venues": [],
  "feed": { "version": "1.9.0", "tools": 10 }
}

์ปค๋ฒ„๋ฆฌ์ง€: ์ž์‚ฐ, ๊ฑฐ๋ž˜์†Œ, ์ด๋ ฅ

BinanceBybitOKXHyperliquid
๊ฑฐ๋ž˜์†Œ๋ณ„ ํŽ€๋”ฉ๋น„โœ“โœ“โœ“โœ“
๊ฑฐ๋ž˜์†Œ ํ†ตํ•ฉ ํŽ€๋”ฉ๋น„์™€ ๋ฐฑ๋ถ„์œ„โœ“โœ“โ€”โœ“
OI(๋ฏธ๊ฒฐ์ œ์•ฝ์ •)โœ“โœ“โœ“โœ“
๊ฑฐ๋ž˜๋Ÿ‰, CVD, ์บ”๋“คโœ“โœ“โœ“โœ“
์˜ค๋”๋ถ: ๋ถˆ๊ท ํ˜•, ๊นŠ์ด, ๋ฒฝ ์ด๋ฒคํŠธโœ“โœ“โœ“โœ“
์ฒด๊ฒฐ ํ…Œ์ดํ”„: ๋Œ€ํ˜• ์ฒด๊ฒฐ, ๋ณผ๋ฅจ ํ”„๋กœํŒŒ์ผ, ๋ˆ„์  ๋ถˆ๊ท ํ˜•โœ“โœ“โœ“โœ“
์ฒญ์‚ฐโœ“โœ“โœ“โ€”
๋ฒ ์ด์‹œ์Šคโœ“โ€”โ€”โ€”

๊ฑฐ๋ž˜์†Œ ํ†ตํ•ฉ ํŽ€๋”ฉ๋น„์™€ ๊ทธ ๋ฐฑ๋ถ„์œ„์—๋Š” ํŽ€๋”ฉ ์ด๋ ฅ์ด 365์ผ ์ด์ƒ์ธ ๊ฑฐ๋ž˜์†Œ๋งŒ ์“ฐ๋ฉฐ, ์‘๋‹ต์˜ ํŽ€๋”ฉ ์ปค๋ฒ„๋ฆฌ์ง€์— ๋ชฉ๋ก์ด ๋‚˜์˜ต๋‹ˆ๋‹ค. ๋ฒ ์ด์‹œ์Šค๋Š” Binance ๋ฌด๊ธฐํ•œ ์„ ๋ฌผ์„ ์—ฌ๋Ÿฌ ๊ฑฐ๋ž˜์†Œ ํ˜„๋ฌผ ์ง€์ˆ˜์™€ ๋น„๊ตํ•ฉ๋‹ˆ๋‹ค. Hyperliquid์—๋Š” ์ฒญ์‚ฐ ํ”ผ๋“œ๊ฐ€ ์—†์Šต๋‹ˆ๋‹ค.

์ด ํ”ผ๋“œ๋ฅผ ์ฝ๋Š” ์—์ด์ „ํŠธ๋ฅผ ์œ„ํ•œ ๊ทœ์น™

์ด ์—ฌ๋Ÿ ๊ฐ€์ง€ ๊ทœ์น™์€ ์—์ด์ „ํŠธ๊ฐ€ ์ˆซ์ž๋ฅผ ์ž˜๋ชป ์ฝ์ง€ ์•Š๊ฒŒ ํ•ด ์ค๋‹ˆ๋‹ค. ์‹œ์Šคํ…œ ํ”„๋กฌํ”„ํŠธ๋กœ๋„ ์“ธ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

  1. get_market_state๋ฅผ ๋จผ์ € ํ˜ธ์ถœํ•˜์„ธ์š”. ํ•œ ๋ฒˆ์˜ ํ˜ธ์ถœ๋กœ ์ž์‚ฐ ํ•˜๋‚˜์˜ ํŽ€๋”ฉ, OI, ๊ฑฐ๋ž˜๋Ÿ‰, CVD, ์˜ค๋”๋ถ, ์ฒญ์‚ฐ, ๋ฒ ์ด์‹œ์Šค, drivers๋ฅผ ๋ชจ๋‘ ๋ฐ›์Šต๋‹ˆ๋‹ค.
  2. ์ˆซ์ž๋ฅผ ์ธ์šฉํ•˜๊ธฐ ์ „์— ์ปค๋ฒ„๋ฆฌ์ง€๋ฅผ ์ฝ์œผ์„ธ์š”. partial: true๋Š” ๊ทธ ๋ธ”๋ก์ด ์ „์ฒด๋ณด๋‹ค ์ ์€ ๊ฑฐ๋ž˜์†Œ๋‚˜ ์งง์€ ์ด๋ ฅ์— ๊ธฐ๋ฐ˜ํ•œ๋‹ค๋Š” ๋œป์ž…๋‹ˆ๋‹ค. reason์ด ์žˆ์œผ๋ฉด ์ด์œ (accruing, unavailable, degraded, stale)๋ฅผ ์•Œ๋ ค ์ค๋‹ˆ๋‹ค. ๋ฒ ์ด์‹œ์Šค๋Š” Binance๋งŒ ์“ฐ๋ฏ€๋กœ ํ•ญ์ƒ partial์ž…๋‹ˆ๋‹ค.
  3. stale_venues์™€ age_seconds๋ฅผ ํ™•์ธํ•˜์„ธ์š”. age_seconds๋Š” ์‘๋‹ต ๋’ค์— ์žˆ๋Š” ๊ฐ€์žฅ ์˜ค๋ž˜๋œ ๋ผ์ด๋ธŒ ์†Œ์Šค์˜ ๋‚˜์ด์ž…๋‹ˆ๋‹ค.
  4. ์Šค์ผ€์ผ์— ์ฃผ์˜ํ•˜์„ธ์š”. ๋ฐฑ๋ถ„์œ„๋Š” 0~100, _ratio๋กœ ๋๋‚˜๋Š” ํ•„๋“œ๋Š” 0~1, rel ๊ฐ’์€ ๊ณผ๊ฑฐ ์ค‘์•™๊ฐ’ ๋Œ€๋น„ ๋ฐฐ์ˆ˜(1.4๋Š” 140%), obi.skew๋Š” โˆ’1~+1์ด๋ฉฐ ๋งค์ˆ˜ ํ˜ธ๊ฐ€๊ฐ€ ๋‘๊บผ์šฐ๋ฉด ์–‘์ˆ˜, basis_bps๋Š” ๋ฌด๊ธฐํ•œ ์„ ๋ฌผ์ด ํ˜„๋ฌผ๋ณด๋‹ค ๋น„์‹ธ๋ฉด ์–‘์ˆ˜์ž…๋‹ˆ๋‹ค.
  5. get_ohlcv์˜ v์™€ delta๋Š” USD๊ฐ€ ์•„๋‹ˆ๋ผ ๊ธฐ์ดˆ ์ž์‚ฐ ๋‹จ์œ„์ž…๋‹ˆ๋‹ค. ํ˜•์„ฑ ์ค‘(partial)์ธ ์บ”๋“ค์€ ATR๊ณผ ๋ณ€๋™์„ฑ ๊ณ„์‚ฐ์—์„œ ๋นผ์„ธ์š”.
  6. ์ฒญ์‚ฐ USD๋Š” ์ถ”์ •์น˜๋กœ ๋‹ค๋ฃจ๊ณ , Hyperliquid๊ฐ€ ๋น ์ ธ ์žˆ๋‹ค๋Š” ์ ์„ ๊ธฐ์–ตํ•˜์„ธ์š”.
  7. get_conditional_outcomes๊ฐ€ history_silent๋ฅผ ๋ฐ˜ํ™˜ํ•˜๋ฉด ์ธก์ •ํ•˜๊ธฐ์—๋Š” ์ด๋ ฅ์ด ๋„ˆ๋ฌด ์–‡๋‹ค๊ณ  ๋งํ•˜์„ธ์š”. ์ถ”์ธก์œผ๋กœ ์ฑ„์šฐ์ง€ ๋งˆ์„ธ์š”.
  8. ์ˆซ์ž๋Š” ์ธก์ •๊ฐ’์œผ๋กœ ์ „๋‹ฌํ•˜์„ธ์š”. ํ”ผ๋“œ๋Š” ๋ฌด์Šจ ์ผ์ด ์žˆ์—ˆ๋Š”์ง€๋ฅผ ๋งํ•  ๋ฟ, ๋ฌด์—‡์„ ๊ฑฐ๋ž˜ํ• ์ง€๋Š” ๋งํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

์ œํ•œ๊ณผ ์˜ค๋ฅ˜

์ œํ•œ์€ ๊ณ„์ •๋ณ„๋กœ ์ ์šฉ๋ฉ๋‹ˆ๋‹ค.

์ •์ง์„ฑ ๋ชจ๋ธ

์ธก์ • ๊ฐ€๋Šฅํ•œ ๊ฒƒ๋งŒ ๋ณด๊ณ ํ•˜๊ณ , ๋ถˆ๊ฐ€๋Šฅํ•˜๋ฉด ๊ทธ๋ ‡๋‹ค๊ณ  ๋งํ•ฉ๋‹ˆ๋‹ค: ์–•์€ ์ด๋ ฅ์€ ์ˆซ์ž๋ฅผ ์ง€์–ด๋‚ด๋Š” ๋Œ€์‹  ๊นŠ์ด๋ฅผ ๊ณต๊ฐœํ•œ ์ฑ„ ๋‹ตํ•˜๊ณ , conditional outcomes๋Š” ์ฆ๊ฑฐ ํ•˜ํ•œ ์•„๋ž˜์—์„œ history_silent๊ฐ€ ๋˜๋ฉฐ, ๋ชจ๋“  ์‘๋‹ต์ด ์‹ ์„ ๋„๋ฅผ ์ž๊ธฐ์„ ์–ธํ•ฉ๋‹ˆ๋‹ค. ์˜ˆ์ธก์ด ์•„๋‹ˆ๋ผ ์ด๋ ฅ์„ ๋ณด๊ณ ํ•ฉ๋‹ˆ๋‹ค.

๋ฌด๋ฃŒ์ด๋ฉฐ ์˜คํ”ˆ์†Œ์Šค

ํ˜ธ์ŠคํŒ… MCP ์„œ๋ฒ„๋Š” ๋ฌด๋ฃŒ์ž…๋‹ˆ๋‹ค: API ํ‚ค ์—†์Œ, ์นด๋“œ ์—†์Œ, ์ด๋ฉ”์ผ ๋งค์ง ๋งํฌ OAuth. stdio ๋ธŒ๋ฆฌ์ง€, ์—ฐ๊ฒฐ ์„ค์ •, ์ „์ฒด ๋„๊ตฌ ๊ณ„์•ฝ์€ GitHub์— ์˜คํ”ˆ์†Œ์Šค(MIT)๋กœ ๊ณต๊ฐœ๋ผ ์žˆ์Šต๋‹ˆ๋‹ค. ํ”ผ๋“œ๋Š” ์„ค๊ณ„์ƒ ์ฝ๊ธฐ ์ „์šฉ์ด๋ฉฐ ๊ฑฐ๋ž˜๋‚˜ ์ž๊ธˆ ์ด๋™์ด ๋ถˆ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.

์ž์ฃผ ๋ฌป๋Š” ์งˆ๋ฌธ

MarketTrace MCP ์„œ๋ฒ„๋Š” ๋ฌด๋ฃŒ์ธ๊ฐ€์š”?

๋„ค. ํ˜ธ์ŠคํŒ… ์—”๋“œํฌ์ธํŠธ๋Š” ๋ฌด๋ฃŒ์ž…๋‹ˆ๋‹ค: OAuth ๋กœ๊ทธ์ธ, API ํ‚ค ๋ถˆํ•„์š”, ๊ฒฐ์ œ ์ •๋ณด ๋ถˆํ•„์š”.

์–ด๋–ค MCP ํด๋ผ์ด์–ธํŠธ์—์„œ ๋™์ž‘ํ•˜๋‚˜์š”?

Claude(์›น๊ณผ ๋ฐ์Šคํฌํ†ฑ), Claude Code, Codex, Cursor, ๊ทธ๋ฆฌ๊ณ  OAuth๋ฅผ ๊ฐ–์ถ˜ Streamable HTTP๋กœ MCP๋ฅผ ์ง€์›ํ•˜๋Š” ๋ชจ๋“  ํด๋ผ์ด์–ธํŠธ. stdio ์ „์šฉ ํด๋ผ์ด์–ธํŠธ๋Š” mcp-remote๋กœ ์—ฐ๊ฒฐํ•ฉ๋‹ˆ๋‹ค.

ํŠธ๋ ˆ์ด๋”ฉ ์‹ ํ˜ธ๋ฅผ ์ฃผ๋‚˜์š”?

์•„๋‹ˆ์š”. ํ”ผ๋“œ๋Š” ์„œ์ˆ ์ ์ž…๋‹ˆ๋‹ค: ์ธก์ •ํ•œ ์‹œ์žฅ ์ƒํƒœ์™€ ์ด๋ ฅ์„ ๋ณด๊ณ ํ•˜๊ณ  ์ž์ฒด ์ปค๋ฒ„๋ฆฌ์ง€๋ฅผ ์„ ์–ธํ•ฉ๋‹ˆ๋‹ค. ํ•ด์„์€ ์—์ด์ „ํŠธ, ๋˜๋Š” ๋‹น์‹ ์˜ ๋ชซ์ž…๋‹ˆ๋‹ค.

๊ฑฐ๋ž˜ํ•˜๊ฑฐ๋‚˜ ์ž๊ธˆ์— ์ ‘๊ทผํ•  ์ˆ˜ ์žˆ๋‚˜์š”?

์•„๋‹ˆ์š”. ์„œ๋ฒ„๋Š” ์ฝ๊ธฐ ์ „์šฉ์ด๋ฉฐ ๋ชจ๋“  ๋„๊ตฌ์— readOnlyHint๊ฐ€ ํ‘œ์‹œ๋ผ ์žˆ์Šต๋‹ˆ๋‹ค. ์–ด๋–ค ๊ฑฐ๋ž˜์†Œ ๊ณ„์ • ํ‚ค๋„ ์—†๊ณ  ์–ด๋–ค ์“ฐ๊ธฐ ๊ถŒํ•œ๋„ ์—†์Šต๋‹ˆ๋‹ค.

์–ด๋–ค ๋ฐ์ดํ„ฐ๋ฅผ ๋‹ค๋ฃจ๋‚˜์š”?

์ตœ๋Œ€ 2๋…„ ์ด๋ ฅ ๋Œ€๋น„ ๋ฐฑ๋ถ„์œ„๊ฐ€ ๋ถ™์€ ํŽ€๋”ฉ๋น„, OI, ๊ฑฐ๋ž˜๋Ÿ‰, CVD, ์˜ค๋”๋ถ ๋ถˆ๊ท ํ˜•, ์ฒญ์‚ฐ, ๋ฒ ์ด์‹œ์Šค, ์บ”๋“ค๋ณ„ ๋ธํƒ€๊ฐ€ ํฌํ•จ๋œ OHLCV, ๋ณผ๋ฅจ ํ”„๋กœํŒŒ์ผ ๋ ˆ๋ฒจ(POC, ๋ฐธ๋ฅ˜ ์—์–ด๋ฆฌ์–ด, ๋„ค์ดํ‚ค๋“œ POC), ๋Œ€ํ˜• ์‹œ์žฅ๊ฐ€ ์ฃผ๋ฌธ, ๊ทธ๋ฆฌ๊ณ  ํก์ˆ˜๋˜๊ฑฐ๋‚˜ ์ฒ ํšŒ๋œ ์˜ค๋”๋ถ ๋ฒฝ๊ณผ ํ’‹ํ”„๋ฆฐํŠธ ๋ˆ„์  ๋ถˆ๊ท ํ˜•์„ BTCยทETHยทSOLยทBNBยทXRPยทDOGEยทHYPEยทZECยทENA, BinanceยทBybitยทOKXยทHyperliquid์—์„œ. ์ฒญ์‚ฐ์€ BinanceยทBybitยทOKX๋งŒ ๋‹ค๋ฃจ๋ฉฐ Hyperliquid ์ฒญ์‚ฐ ํ”ผ๋“œ๋Š” ์—†์Šต๋‹ˆ๋‹ค.

๋ฐ์ดํ„ฐ๋Š” ์–ผ๋งˆ๋‚˜ ์ตœ์‹ ์ธ๊ฐ€์š”?

๋ผ์ด๋ธŒ ๋ธ”๋ก์€ ์•ฝ 30์ดˆ๋งˆ๋‹ค ๊ฐฑ์‹ ๋ฉ๋‹ˆ๋‹ค. ๊ฐ ์‘๋‹ต์—๋Š” ๊ฐ€์žฅ ์˜ค๋ž˜๋œ ๋ผ์ด๋ธŒ ์†Œ์Šค์˜ ๋‚˜์ด์ธ age_seconds๊ฐ€, ํŽ€๋”ฉ ๋ธ”๋ก์—๋Š” ์‚ฌ์šฉํ•œ ์ •์‚ฐ ์ดํ›„ ๊ฒฝ๊ณผ ์‹œ๊ฐ„์ธ source_age_ms๊ฐ€ ๋“ค์–ด ์žˆ์Šต๋‹ˆ๋‹ค.

์ด๋ ฅ์€ ์–ผ๋งˆ๋‚˜ ๊ฑฐ์Šฌ๋Ÿฌ ์˜ฌ๋ผ๊ฐ€๋‚˜์š”?

ํŽ€๋”ฉ ๋ฐฑ๋ถ„์œ„๋Š” ์ตœ๋Œ€ 730์ผ๊ณผ ๋น„๊ตํ•ฉ๋‹ˆ๋‹ค. ์บ”๋“ค, ๋Œ€ํ˜• ์ฒด๊ฒฐ, ๋ˆ„์  ๋ถˆ๊ท ํ˜•, ๋ณผ๋ฅจ ํ”„๋กœํŒŒ์ผ์€ 31์ผ ์ฒด๊ฒฐ ํ…Œ์ดํ”„์—์„œ ๋‚˜์˜ค๋ฉฐ ZEC์™€ ENA๋Š” 14์ผ์ž…๋‹ˆ๋‹ค. 15๋ถ„ ์Šคํ…Œ์ดํŠธ ์•„์นด์ด๋ธŒ๋Š” 2026-07-03๋ถ€ํ„ฐ, ๋ฒฝ ์ด๋ฒคํŠธ๋Š” 2026-10-03๋ถ€ํ„ฐ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.

ํ˜ธ์ถœ ์ œํ•œ์€ ์–ด๋–ป๊ฒŒ ๋˜๋‚˜์š”?

๊ณ„์ •๋ณ„๋กœ 60ํšŒ ๋ฒ„์ŠคํŠธ ํ›„ ๋ถ„๋‹น 30ํšŒ์˜ ๋„๊ตฌ ํ˜ธ์ถœ, ๋ฌด๊ฑฐ์šด ๋„๊ตฌ 4๊ฐœ๋Š” 20ํšŒ ๋ฒ„์ŠคํŠธ ํ›„ ๋ถ„๋‹น 10ํšŒ์ž…๋‹ˆ๋‹ค. ์ œํ•œ์— ๊ฑธ๋ฆฐ ํ˜ธ์ถœ์€ ๋ช‡ ์ดˆ ๊ธฐ๋‹ค๋ ค์•ผ ํ•˜๋Š”์ง€ ์•Œ๋ ค ์ฃผ๋Š” ์˜ค๋ฅ˜๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

REST API๊ฐ€ ์žˆ๋‚˜์š”?

์•„์ง ์—†์Šต๋‹ˆ๋‹ค. ์ง€๊ธˆ์€ MCP๊ฐ€ ํ”„๋กœ๊ทธ๋ž˜๋ฐ์šฉ ์ธํ„ฐํŽ˜์ด์Šค์ด๋ฉฐ, ์Šคํฌ๋ฆฝํŠธ๋Š” OAuth๋ฅผ ์ง€์›ํ•˜๋Š” MCP ํด๋ผ์ด์–ธํŠธ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋กœ ํ˜ธ์ถœํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

CoinGecko๋‚˜ CoinMarketCap MCP ์„œ๋ฒ„์™€ ๋ฌด์—‡์ด ๋‹ค๋ฅธ๊ฐ€์š”?

๊ทธ์ชฝ์€ ์ˆ˜์ฒœ ๊ฐœ ์ฝ”์ธ์˜ ๊ฐ€๊ฒฉ, ์‹œ๊ฐ€์ด์•ก, ํญ๋„“์€ ์‹œ์žฅ ๋ฐ์ดํ„ฐ๋ฅผ ๋‹ค๋ฃน๋‹ˆ๋‹ค. MarketTrace๋Š” ๋ฌด๊ธฐํ•œ ์„ ๋ฌผ ์‹œ์žฅ 9๊ฐœ๋ฅผ ๊นŠ๊ฒŒ ๋‹ค๋ฃน๋‹ˆ๋‹ค: ํŽ€๋”ฉ ๋ฐฑ๋ถ„์œ„, ๊ฑฐ๋ž˜์†Œ๋ณ„ OI, CVD, ์˜ค๋”๋ถ ๋ถˆ๊ท ํ˜•, ์ฒญ์‚ฐ, ํ’‹ํ”„๋ฆฐํŠธ ์ด๋ฒคํŠธ. ํฌ๋ฆฝํ†  MCP ์„œ๋ฒ„ ๋น„๊ต ๊ธ€์—์„œ ๊ฐ๊ฐ ๋ฌด์—‡์„ ์ œ๊ณตํ•˜๋Š”์ง€ ์ •๋ฆฌํ–ˆ์Šต๋‹ˆ๋‹ค.

์„œ๋ฒ„๋Š” ๋ฌด์—‡์„ ๋ณด๊ณ  ์ €์žฅํ•˜๋‚˜์š”?

๋กœ๊ทธ์ธ์šฉ ์ด๋ฉ”์ผ ์ฃผ์†Œ์™€ ๊ณ„์ • ID์ž…๋‹ˆ๋‹ค. ์š”์ฒญ๋งˆ๋‹ค ์„œ๋ฒ„๋Š” ๊ณ„์ • ID, ์‹œ๊ฐ, ๋„๊ตฌ์™€ ์ธ์ž, ํด๋ผ์ด์–ธํŠธ ์ด๋ฆ„๊ณผ user agent, ๋„คํŠธ์›Œํฌ ํ”„๋ฆฌํ”ฝ์Šค๋กœ ์ž๋ฅธ IP ์ฃผ์†Œ(IPv4๋Š” /24, IPv6๋Š” /48), ๊ตญ๊ฐ€๋ฅผ ๊ธฐ๋กํ•ฉ๋‹ˆ๋‹ค. ๋Œ€ํ™” ๋‚ด์šฉ์€ ์ „ํ˜€ ๋ณด์ง€ ๋ชปํ•˜๋ฉฐ, ์—์ด์ „ํŠธ๊ฐ€ ํ•˜๋Š” ๋„๊ตฌ ํ˜ธ์ถœ๋งŒ ๋ด…๋‹ˆ๋‹ค. ์ž์„ธํ•œ ๋‚ด์šฉ์€ ๊ฐœ์ธ์ •๋ณด ์ฒ˜๋ฆฌ๋ฐฉ์นจ์— ์žˆ์Šต๋‹ˆ๋‹ค.

์˜คํ”ˆ์†Œ์Šค์ธ๊ฐ€์š”?

stdio ๋ธŒ๋ฆฌ์ง€, ํด๋ผ์ด์–ธํŠธ ์„ค์ •, ๋„๊ตฌ ๊ณ„์•ฝ์€ GitHub์—์„œ MIT ๋ผ์ด์„ ์Šค์ž…๋‹ˆ๋‹ค. ํ˜ธ์ŠคํŒ… ์—”๋“œํฌ์ธํŠธ ๋’ค์˜ ๋ฐ์ดํ„ฐ ํŒŒ์ดํ”„๋ผ์ธ์€ ์˜คํ”ˆ์†Œ์Šค๊ฐ€ ์•„๋‹™๋‹ˆ๋‹ค.

๊ฐœ์ธ์ •๋ณด ์ฒ˜๋ฆฌ๋ฐฉ์นจ ยท ์„œ๋น„์Šค ์ด์šฉ์•ฝ๊ด€