{"openapi":"3.0.3","info":{"title":"APICK 암호화폐 통합 시세·김치프리미엄","version":"1.0.0","description":"국내외 주요 거래소의 실시간 시세를 한 번에 모아 주고, 원화 환산 기준가와 한국 시장 프리미엄(김치프리미엄)을 함께 계산합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/crypto_market":{"post":{"summary":"암호화폐 통합 시세·김치프리미엄","description":"국내외 주요 거래소의 실시간 시세를 한 번에 모아 주고, 원화 환산 기준가와 한국 시장 프리미엄(김치프리미엄)을 함께 계산합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"as_of":{"type":"string","description":"시세를 모은 시각입니다. 초 단위까지 포함한 국제표준시 표기입니다."},"fx":{"type":"object","properties":{"usdt_krw":{"type":"number"}},"description":"환산 기준입니다. usdt_krw는 국내에서 거래되는 USDT의 원화 시세이며, 확인하지 못하면 null입니다.","nullable":true},"assets":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string","description":"코인 심볼입니다. 예: BTC"},"domestic":{"type":"array","items":{"type":"object","properties":{"market":{"type":"string"},"currency":{"type":"string"},"price_krw":{"type":"integer"},"change_percent_24h":{"type":"number"},"volume_24h_krw":{"type":"integer"},"high_krw":{"type":"integer"},"low_krw":{"type":"integer"}}},"description":"국내 거래소의 원화 시세 목록입니다. market(거래소), price_krw, change_percent_24h, volume_24h_krw, high_krw, low_krw를 담습니다."},"global":{"type":"array","items":{"type":"object","properties":{"market":{"type":"string"},"pair":{"type":"string"},"price_usdt":{"type":"number"},"change_percent_24h":{"type":"number"},"volume_24h_usdt":{"type":"integer"},"high_usdt":{"type":"number"},"low_usdt":{"type":"number"}}},"description":"국외 거래소의 USDT 시세 목록입니다. market, pair, price_usdt, change_percent_24h, volume_24h_usdt, high_usdt, low_usdt를 담습니다."},"reference_price_krw":{"type":"number","description":"국외 USDT 시세를 원화로 환산한 기준가입니다. 비교에 쓰는 값이며 실제 체결 가격이 아닙니다.","nullable":true},"premium_percent":{"type":"number","description":"국내 원화 시세가 환산 기준가보다 몇 % 높은지입니다. 계산할 수 없으면 null입니다.","nullable":true},"premium_source":{"type":"object","properties":{"domestic_market":{"type":"string"},"global_market":{"type":"string"}},"description":"프리미엄 계산에 쓴 시세 조합입니다. domestic_market과 global_market이 들어 있습니다.","nullable":true}}},"description":"요청한 심볼 순서대로 담긴 결과입니다. 심볼마다 국내 시세(domestic)·국외 시세(global)·프리미엄을 담습니다."},"summary":{"type":"object","properties":{"requested":{"type":"integer"},"domestic_markets":{"type":"integer"},"premium_computed":{"type":"integer"}},"description":"요청 심볼 수(requested), 응답한 국내 거래소 수(domestic_markets), 프리미엄을 계산한 심볼 수(premium_computed)입니다."},"partial":{"type":"boolean","description":"일부 심볼이나 거래소의 시세가 빠졌으면 true입니다."},"warnings":{"type":"array","items":{},"description":"빠진 값에 대한 안내 문구입니다. 모두 정상이면 빈 배열입니다."},"success":{"type":"integer"},"error":{"type":"string","description":"실패 사유 문구입니다. 정상 응답에는 없으며, 값이 있으면 아래 오류 응답 표에서 원인과 조치를 확인하세요."}},"description":"시세 결과 묶음입니다. 실패하면 아래 필드 대신 error 문구가 들어 있습니다."},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"이번 호출에서 차감된 포인트입니다. data.error가 있는 실패 응답은 0입니다."},"ms":{"type":"integer","description":"요청을 받아 응답을 만들기까지 걸린 시간(밀리초)입니다."},"pl_id":{"type":"integer","description":"포인트 차감 기록 번호입니다. 차감이 있었던 호출에만 값이 있습니다."}},"description":"호출 공통 정보입니다. 처리 여부·차감 포인트·처리 시간·차감 기록 번호가 들어 있습니다."}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"symbols":{"type":"string","description":"심볼을 쉼표로 구분 (예: BTC,ETH,XRP). 생략하면 BTC,ETH,XRP,SOL,DOGE (string)","example":"BTC,ETH,XRP"}}}}}}}}},"x-code-tables":[{"title":"오류 응답","columns":["HTTP","data.error","원인·조치"],"rows":[["400","코인 심볼이 올바르지 않습니다. 쉼표로 구분해 2~10자 영문·숫자로 보내 주세요.","심볼 표기가 잘못됐습니다. 대문자 영문·숫자만 쓰며, 빈 값만 보내면 안 됩니다."],["400","심볼은 한 번에 20개까지 조회할 수 있습니다.","한 번에 20개를 넘겨 보냈습니다. 나눠서 호출하세요."],["424","시세를 가져오지 못했습니다. 잠시 후 다시 시도해 주세요.","모든 거래소에서 시세를 받지 못했습니다. 잠시 후 다시 요청하세요."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}