RealMarketAPI
FAQ

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

RealMarketAPI๋ฅผ ํ†ตํ•ฉํ•˜๋Š” ๊ฐœ๋ฐœ์ž๋ฅผ ์œ„ํ•œ ๋น ๋ฅธ ๋‹ต๋ณ€์ž…๋‹ˆ๋‹ค.

01RealMarketAPI๋ž€ ๋ฌด์—‡์ธ๊ฐ€์š”?

RealMarketAPI๋Š” REST API, WebSocket ์ŠคํŠธ๋ฆผ ๋ฐ MCP ์„œ๋ฒ„๋ฅผ ํ†ตํ•ด ๊ธˆ์†, ์™ธํ™˜, ์•”ํ˜ธํ™”ํ, ์ƒํ’ˆ ๋ฐ ์ง€์ˆ˜์— ๋Œ€ํ•œ ์‹ค์‹œ๊ฐ„ ๋ฐ ๊ณผ๊ฑฐ OHLC ๋ฐ์ดํ„ฐ๋ฅผ ์ œ๊ณตํ•˜๋Š” ์‹œ์žฅ ๋ฐ์ดํ„ฐ ํ”Œ๋žซํผ์ž…๋‹ˆ๋‹ค.

02์–ด๋–ค ์ž์‚ฐ๊ณผ ๊ธฐํ˜ธ๊ฐ€ ์ง€์›๋˜๋‚˜์š”?

XAUUSD, XAGUSD, EURUSD, GBPUSD, USDJPY, GBPJPY, USDVND, AUDUSD, USDCAD, BTCUSD, ETHUSD, XRPUSD, USOIL, UKOIL, XNGUSD, XPTUSD, US500, US30, AAPL, TSLA, NFLX, MSFT, AMZN, AMD, NVDA, GOOGL ๋ฐ META๋ฅผ ํฌํ•จํ•œ 27๊ฐœ ์ด์ƒ์˜ ๊ธฐํ˜ธ์— ์•ก์„ธ์Šคํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ๊ธฐํ˜ธ๋Š” ํ”Œ๋žœ์— ๋”ฐ๋ผ ๋‹ค๋ฅผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

03์–ด๋–ค ์‹œ๊ฐ„๋Œ€๋ฅผ ์š”์ฒญํ•  ์ˆ˜ ์žˆ๋‚˜์š”?

์ง€์›๋˜๋Š” ์‹œ๊ฐ„๋Œ€๋Š” M5, M15, H1, H4 ๋ฐ D1์ž…๋‹ˆ๋‹ค. ๋ชจ๋“  ํ”Œ๋žœ์ด ๋ชจ๋“  ์‹œ๊ฐ„๋Œ€๋ฅผ ํฌํ•จํ•˜์ง€๋Š” ์•Š์œผ๋ฏ€๋กœ ํ˜„์žฌ ํ”Œ๋žœ ์ œํ•œ์„ ํ™•์ธํ•˜์„ธ์š”.

04์š”์ฒญ์„ ์ธ์ฆํ•˜๋ ค๋ฉด ์–ด๋–ป๊ฒŒ ํ•ด์•ผ ํ•˜๋‚˜์š”?

์š”์ฒญ์€ apiKey๋ฅผ ์—”๋“œํฌ์ธํŠธ URL์˜ ์ฟผ๋ฆฌ ๋งค๊ฐœ๋ณ€์ˆ˜๋กœ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. apiKey๋ฅผ ๋น„๊ณต๊ฐœ๋กœ ์œ ์ง€ํ•˜๊ณ  ๋…ธ์ถœ์ด ์˜์‹ฌ๋˜๋Š” ๊ฒฝ์šฐ ์ฆ‰์‹œ ํšŒ์ „ํ•˜์„ธ์š”.

05/price์™€ /history์˜ ์ฐจ์ด์ ์€ ๋ฌด์—‡์ธ๊ฐ€์š”?

/api/v1/price๋Š” ๊ธฐํ˜ธ ๋ฐ ์‹œ๊ฐ„๋Œ€์— ๋Œ€ํ•œ ์ตœ์‹  ์ด›๋Œ€๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค. /api/v1/history๋Š” startTime๊ณผ endTime ์‚ฌ์ด์˜ ํŽ˜์ด์ง€ ๊ตฌ๋ถ„๋œ H1 ๊ณผ๊ฑฐ ์ด›๋Œ€(ํ˜„์žฌ ๋ง‰๋Œ€ ์ œ์™ธ)๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค. ํ˜„์žฌ ๊ณต๊ฐœ ๋ง‰๋Œ€๋ฅผ ์–ป์œผ๋ ค๋ฉด /api/v1/candle์„ ์‚ฌ์šฉํ•˜์„ธ์š”.

06REST ๋Œ€์‹  WebSocket์„ ์–ธ์ œ ์‚ฌ์šฉํ•ด์•ผ ํ•˜๋‚˜์š”?

์ง€์†์ ์ธ ์‹ค์‹œ๊ฐ„ ์—…๋ฐ์ดํŠธ ๋ฐ ์ € ์ง€์—ฐ ์‹œ๊ฐ„ ์ธํ„ฐํŽ˜์ด์Šค์—๋Š” WebSocket์„ ์‚ฌ์šฉํ•˜์„ธ์š”. ์š”์ฒญ ์‹œ ์Šค๋ƒ…์ƒท, ๊ณผ๊ฑฐ ์กฐํšŒ ๋˜๋Š” ์„œ๋ฒ„ ์ธก ์ž‘์—…์ด ํ•„์š”ํ•œ ๊ฒฝ์šฐ REST๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”.

07์†๋„ ์ œํ•œ์„ ์ ์šฉํ•˜๋‚˜์š”?

์˜ˆ. ๊ฐ ํ”Œ๋žœ์—๋Š” ๋ถ„๋‹น ์š”์ฒญ ๋ฐ ์›”๊ฐ„ ์š”์ฒญ ์ œํ•œ์ด ์žˆ์Šต๋‹ˆ๋‹ค. ์ดˆ๊ณผํ•˜๋ฉด API๊ฐ€ ํ• ๋‹น๋Ÿ‰ ์ฐฝ์ด ์žฌ์„ค์ •๋  ๋•Œ๊นŒ์ง€ 429 ์ƒํƒœ ์ฝ”๋“œ๋ฅผ ๋ฐ˜ํ™˜ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

08๊ณผ๊ฑฐ ๋ฐ์ดํ„ฐ๋Š” ์–ด๋–ป๊ฒŒ ํŽ˜์ด์ง€ ๊ตฌ๋ถ„๋˜๋‚˜์š”?

/api/v1/history์—์„œ pageNumber ๋ฐ pageSize๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”. ์‘๋‹ต์—๋Š” ๋ฐ์ดํ„ฐ ์„ธํŠธ๋ฅผ ๋ฐ˜๋ณตํ•˜๋Š” ๋ฐ ๋„์›€์ด ๋˜๋„๋ก TotalCount, CurrentPage, TotalPages ๋ฐ PageSize๊ฐ€ ํฌํ•จ๋ฉ๋‹ˆ๋‹ค.

09์–ด๋–ค ์˜ค๋ฅ˜ ์ฝ”๋“œ๋ฅผ ์ฒ˜๋ฆฌํ•ด์•ผ ํ•˜๋‚˜์š”?

์ผ๋ฐ˜์ ์ธ ์ƒํƒœ์—๋Š” 400(๊ฒ€์ฆ ์˜ค๋ฅ˜), 401(์Šน์ธ๋˜์ง€ ์•Š์Œ), 403(๊ธˆ์ง€๋จ), 429(์†๋„ ์ œํ•œ๋จ) ๋ฐ 500(์„œ๋ฒ„ ์˜ค๋ฅ˜)์ด ํฌํ•จ๋ฉ๋‹ˆ๋‹ค. ์ง€์›ํŒ€์— ๋ฌธ์˜ํ•  ๋•Œ TraceId๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”.

10RealMarketAPI๋ฅผ ์ƒ์šฉ ์ œํ’ˆ์— ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‚˜์š”?

์ƒ์—…์  ์‚ฌ์šฉ์€ ํ”Œ๋žœ์— ๋”ฐ๋ผ ๋‹ค๋ฆ…๋‹ˆ๋‹ค. Starter/Pro/Business/Enterprise ํ”Œ๋žœ์€ ํ”„๋กœ๋•์…˜ ์‚ฌ์šฉ์„ ์œ„ํ•ด ์„ค๊ณ„๋˜์—ˆ์œผ๋ฉฐ, Free๋Š” ํ…Œ์ŠคํŠธ ๋ฐ ํ•™์Šต์šฉ์ž…๋‹ˆ๋‹ค.

11์ง€์› ์‘๋‹ต ์†๋„๋Š” ์–ผ๋งˆ๋‚˜ ๋น ๋ฅธ๊ฐ€์š”?

์‘๋‹ต ์‹œ๊ฐ„์€ ํ”Œ๋žœ๊ณผ ๋ฌธ์ œ ์œ ํ˜•์— ๋”ฐ๋ผ ๋‹ค๋ฆ…๋‹ˆ๋‹ค. ์šฐ์„ ์ˆœ์œ„ ๋ฐ ์—”ํ„ฐํ”„๋ผ์ด์ฆˆ ๊ณ„์ธต์€ ํŠนํžˆ ํ”„๋กœ๋•์…˜ ์˜ํ–ฅ ์‚ฌ๊ฑด์— ๋Œ€ํ•ด ๋” ๋น ๋ฅธ ์ง€์› ์ฒ˜๋ฆฌ๋ฅผ ๋ฐ›์Šต๋‹ˆ๋‹ค.

12์—…๊ทธ๋ ˆ์ด๋“œํ•˜๊ฑฐ๋‚˜ ์ปค์Šคํ…€ ์ œํ•œ์„ ์š”์ฒญํ•˜๋ ค๋ฉด ์–ด๋–ป๊ฒŒ ํ•ด์•ผ ํ•˜๋‚˜์š”?

๊ฐ€๊ฒฉ ํŽ˜์ด์ง€์—์„œ ์—…๊ทธ๋ ˆ์ด๋“œํ•˜๊ฑฐ๋‚˜ ์ปค์Šคํ…€ ์ œํ•œ, ์ „์šฉ ์ธํ”„๋ผ, ๋น„๊ณต๊ฐœ ์—”๋“œํฌ์ธํŠธ ๋ฐ ์—”ํ„ฐํ”„๋ผ์ด์ฆˆ SLA ์˜ต์…˜์— ๋Œ€ํ•ด ์˜์—…ํŒ€์— ๋ฌธ์˜ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

13๊ฐ€๊ฒฉ์ด ์™œ ๊ทธ๋ ‡๊ฒŒ ๋ณด์ด๋‚˜์š”?

๋ชจ๋“  ๊ฐ€๊ฒฉ๋Œ€๋Š” ์™„์ „ํ•œ ๋น„์šฉ ํˆฌ๋ช…์„ฑ ์œ„์— ๊ตฌ์ถ•๋ฉ๋‹ˆ๋‹ค. ์šฐ๋ฆฌ๋Š” ๋ชจ๋“  ๊ธฐ๋ณธ ๋น„์šฉ(ํด๋ผ์šฐ๋“œ ์„œ๋ฒ„, CDN, SSL ์ธ์ฆ์„œ, ๋„๋ฉ”์ธ ๋“ฑ๋ก, ๊ฐœ๋ฐœ์ž ๊ธ‰์—ฌ, ์ง€์†์ ์ธ ์œ ์ง€ ๋ณด์ˆ˜, ๋งˆ์ผ€ํŒ… ๋ฐ ๋ถ€๊ฐ€์„ธ)์„ ๊ณ„์‚ฐํ•œ ๋‹ค์Œ ์š”์ฒญ ๊ณ„์ธต ์ „์ฒด์— ๋‚˜๋ˆ„์—ˆ์Šต๋‹ˆ๋‹ค. ๋ชจํ˜ธํ•œ ๊ฒฌ์ ์„ ๋ถ€ํ’€๋ฆฌ๋Š” ์ œ๊ณต์ž์™€ ๋‹ฌ๋ฆฌ ์šฐ๋ฆฌ๋Š” ์‹ ๋ขฐํ•  ์ˆ˜ ์žˆ๋Š” ์‹ค์‹œ๊ฐ„ ์‹œ์žฅ ๋ฐ์ดํ„ฐ๋ฅผ ์ œ๊ณตํ•˜๋Š” ๋ฐ ์ •ํ™•ํžˆ ๋ฌด์—‡์ด ํ•„์š”ํ•œ์ง€ ๋ณด์—ฌ์ค๋‹ˆ๋‹ค. ์ด๊ฒƒ์ด ์šฐ๋ฆฌ์˜ ์š”์ฒญ๋‹น ๊ฐ€๊ฒฉ์ด ๊ณต์ •ํ•œ ์ด์œ ์ž…๋‹ˆ๋‹ค. ์‹ค์ œ ์ธํ”„๋ผ ๋ฐ ์šด์˜ ๋น„์šฉ์„ ๋ฐ˜์˜ํ•˜๋ฉฐ, ์ž์˜์ ์ธ ๋งˆ์ง„์€ ์•„๋‹™๋‹ˆ๋‹ค.

14RealMarketAPI๋Š” ๋‹ค๋ฅธ ์‹œ์žฅ ๋ฐ์ดํ„ฐ ์ œ๊ณต์ž์™€ ์–ด๋–ป๊ฒŒ ๋‹ค๋ฅธ๊ฐ€์š”?

๋งŽ์€ ๊ฒฝ์Ÿ ์„œ๋น„์Šค๋Š” ์ธํ„ฐ๋„ท์˜ ๋ฏธํ™•์ธ ์ถœ์ฒ˜์—์„œ ๋ฐ์ดํ„ฐ๋ฅผ ์Šคํฌ๋ž˜ํ•‘ํ•˜๊ฑฐ๋‚˜ ๋А๋ฆฐ ์ง€์—ฐ๋œ ์—…๋ฐ์ดํŠธ๋กœ ์•Œ๋ ค์ง„ Yahoo Finance์™€ ๊ฐ™์€ ์ง‘๊ณ„์ž์—์„œ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค. RealMarketAPI๋Š” ๋ฐ์ดํ„ฐ๋ฅผ ์ „๋ฌธ ๋ธŒ๋กœ์ปค์—์„œ ์ง์ ‘ ๋ฐ›์Šต๋‹ˆ๋‹ค. Exness ๋ฐ Vantage์™€ ๊ฐ™์€ ํ”Œ๋žซํผ์„ ๊ฐ•ํ™”ํ•˜๋Š” ๋™์ผํ•œ ์ธํ”„๋ผ์ž…๋‹ˆ๋‹ค. ์ฆ‰, ์ •ํ™•ํ•œ ํƒ€์ž„์Šคํƒฌํ”„, ํƒ€์ดํŠธํ•œ ์Šคํ”„๋ ˆ๋“œ ๋ฐ ๋ฌด๊ธ๊ฑฐ๋‚˜ ์ง‘๊ณ„๋œ ํ”ผ๋“œ๊ฐ€ ์ผ์น˜ํ•  ์ˆ˜ ์—†๋Š” 150ms ์ดํ•˜์˜ ์ „๋‹ฌ์„ ํฌํ•จํ•œ ๊ธฐ๊ด€ ๋“ฑ๊ธ‰ ๊ฐ€๊ฒฉ์„ ์–ป์Šต๋‹ˆ๋‹ค.

์—ฌ์ „ํžˆ ์งˆ๋ฌธ์ด ์žˆ์œผ์‹ ๊ฐ€์š”? ๋ฌธ์„œ ๋˜๋Š” ์ €ํฌ์—๊ฒŒ ๋ฌธ์˜ํ•˜์„ธ์š”.