# KRCX Trading API는 form-urlencoded 방식입니다
POST /0/private/AddOrder
Host: api.inexkr.com
API-Key: <api_key>
API-Sign: <base64(HMAC-SHA512)>
Content-Type: application/x-www-form-urlencoded
nonce=1719999999000
&pair=USDT%2FKRW
&type=buy
&ordertype=limit
&volume=100.0
&price=1340.5
&timeinforce=GTC
&userref=PARTNER-ORD-12345
# 컴플라이언스 필수 필드
&vasp_purpose_code=P2B_TRADE
&originator_vasp_id=VASP-2024-XXXX
&kyc_level=TIER2
&settlement_mode=INSTANT_KRW
// 200 OK — 성공
{
"error": [],
"result": {
"descr": { "order": "buy 100.00000000 USDT/KRW @ limit 1340.5" },
"txid": ["INEX-TX-9F3D2A1B"],
"orderId": "9F3D2A1B",
"settlement": {
"mode": "INSTANT_KRW",
"expected_settle_time": "T+0",
"krw_account_linked": true
}
}
}
// 200 OK — 컴플라이언스 거부 (HTTP 상태는 200, error 배열 확인)
{
"error": ["ECompliance:Missing travel-rule metadata"],
"result": {}
}거래소를 만드는 대신 연결합니다
검증된 매칭 엔진
자체 개발한 매칭 엔진이 2024년 11월부터 실제 운영 중입니다. 오더북 Lv2와 기관 주문 타입을 지원합니다.
디지털자산거래소 인프라
디지털자산거래소를 직접 운영하며 축적한 거래·유통 인프라를 기반으로 안정적인 거래와 T+0 정산·네팅을 지원합니다.
익숙한 API 관행
널리 쓰이는 거래 API 구조와 응답 필드 네이밍을 따라 개발팀의 마이그레이션 비용을 줄였습니다.
동작 방식
- 01
연동
표준 REST와 WebSocket으로 주문·시세·잔고를 연결합니다.
- 02
주문
파트너 앱에서 주문을 생성하면 게이트웨이가 컴플라이언스를 검증합니다.
- 03
체결 · 보관
매칭 엔진이 체결하고 자산은 MPC 구조로 보관됩니다.
- 04
정산
정산 모드에 따라 실시간 또는 배치로 원화 정산이 이뤄집니다.
- 01
연동
표준 REST와 WebSocket으로 주문·시세·잔고를 연결합니다.
- 02
주문
파트너 앱에서 주문을 생성하면 게이트웨이가 컴플라이언스를 검증합니다.
- 03
체결 · 보관
매칭 엔진이 체결하고 자산은 MPC 구조로 보관됩니다.
- 04
정산
정산 모드에 따라 실시간 또는 배치로 원화 정산이 이뤄집니다.
엔드포인트와 사양
주요 엔드포인트
/0/public/Ticker/0/public/OrderBook/0/public/Trades/0/private/AddOrder/0/private/CancelOrder/0/private/Balance/0/private/TradesHistoryexecutions · balancessettlement_status주요 사양
- 통신 방식
- REST + WebSocket (단일 커넥션 멀티 구독)
- 서명
- HMAC-SHA512 기본 · HMAC-SHA256 별칭 엔드포인트 병행
- 심볼 표기
- USDT/KRW · USDTKRW 두 표기 모두 허용
- 주문 타입
- market · limit · stop-loss · take-profit · iceberg · post-only · trigger-best
- Rate Limit
- Tier(분당 호출) + Weight(누적 가중치) 하이브리드
- 정산
- T+0 실시간 또는 배치 · 네팅 지원
자주 묻는 질문
주문 타입은 어디까지 지원하나요?
시장가·지정가와 조건부 주문에 더해 대량 주문 분할(iceberg), 메이커 전용(post-only)을 지원합니다. AML 임계치에 따라 자동 분할하는 trigger-best는 INEX 고유 타입입니다.
WebSocket으로도 주문할 수 있나요?
가능합니다. 인증 토큰을 발급받으면 같은 커넥션에서 주문 생성과 취소를 수행할 수 있습니다.
호출 한도를 넘으면 어떻게 되나요?
Tier 한도와 Weight 한도 중 먼저 도달하는 쪽이 적용되며, 초과 시 잔여 쿨다운과 함께 에러가 반환됩니다.
트래블룰 필드를 빠뜨리면 어떻게 되나요?
게이트웨이 단계에서 ECompliance 계열 에러로 즉시 거부됩니다. 주문이 매칭 엔진까지 도달하지 않습니다.
Get Started
INEX와 함께 시작하십시오
도입 검토 단계에 맞춰 필요한 자료와 논의를 제공합니다. 기술 검토와 규제 요건 정리를 함께 진행합니다.