본문으로 건너뛰기

REST / gRPC 엔드포인트

QoreChain은 프로그래밍 방식 접근을 위해 세 가지 기본 인터페이스를 제공합니다:

인터페이스기본 포트프로토콜설명
REST1317HTTP/1.1REST 게이트웨이(Cosmos SDK API 서버)
gRPC9090HTTP/2Protobuf로 인코딩된 gRPC 서비스
RPC26657HTTP + WSQoreChain 합의 엔진 RPC

모든 REST 엔드포인트는 JSON을 반환합니다. gRPC 엔드포인트는 Protocol Buffers를 사용하며 어떤 gRPC 클라이언트로도 사용할 수 있습니다. RPC 인터페이스는 합의 수준의 조회와 트랜잭션 브로드캐스트를 제공합니다.

노트

이 인터페이스들은 qorechain-vladi 메인넷(2026년 6월 7일부터 가동 중)과 qorechain-diana 테스트넷 모두에서 사용할 수 있습니다. 테스트넷은 노드 릴리스 v3.2.8(2026년 11월 12일 높이 9,929,500에서 테스트넷 거버넌스가 적용. 그에 앞서 v3.2.7은 2026년 11월 6일 높이 9,594,600에서 적용)을, 메인넷은 한 릴리스 뒤처진 v3.2.7을 실행합니다. 메인넷은 2026년 11월 12일 높이 4,164,600에서 v3.2.7을 적용했으며(거버넌스 제안 16. 그에 앞서 v3.2.6은 2026년 11월 4일 높이 4,020,000에서 거버넌스 제안 15로, v3.2.5는 2026년 10월 29일 높이 3,906,833에서 제안 14로, v3.2.4는 2026년 10월 23일 높이 3,742,566에서 적용되었습니다), 테스트넷은 2026년 10월 26일 높이 8,890,800에서 v3.2.5를, 2026년 10월 27일 높이 8,970,638에서 v3.2.6을, 높이 9,594,600에서 v3.2.7을, 높이 9,929,500에서 v3.2.8을 적용했습니다. 메인넷은 v3.2.8을 아직 적용하지 않았습니다. 릴리스가 추가한 라우트와 필드는 해당 네트워크가 그 릴리스를 적용한 뒤에야 나타납니다. 아래에서 2026년 11월 4일로 표시된 라우트 확인은 v3.2.6 업그레이드 이후 공개 메인넷 호스트를 대상으로 수행했습니다. v3.2.7로 표시된 라우트는 2026년 11월 7일 공개 테스트넷 호스트에서, 그리고 메인넷이 v3.2.7을 적용한 뒤인 2026년 11월 12일 공개 메인넷 호스트에서 확인했습니다(모두 라우팅됨. 각 라우트의 설명 참조). 아래의 기본 URL은 로컬에서 실행 중인 노드를 기준으로 합니다. 공개 호스팅 엔드포인트는 https://api.qore.host / https://api-testnet.qore.host(REST)와 https://rpc.qore.host / https://rpc-testnet.qore.host(RPC)이며, 네트워크에 정리되어 있습니다. 공개 gRPC 엔드포인트는 없습니다: 호스트 이름 grpc.qore.host와 grpc-testnet.qore.host는 존재하지 않으므로, gRPC가 필요하면 직접 노드를 실행하십시오.

기본 URL​

REST: http://localhost:1317
gRPC: localhost:9090
RPC: http://localhost:26657

존재하는 라우트​

QoreChain 전용 모듈은 REST에서 /qorechain/<module>/v1/... 접두사 아래에 노출되며, 아래에 나열된 모듈에만 REST 라우트가 있습니다. 나머지 모듈은 gRPC로만 접근할 수 있습니다(gRPC 전용 모듈 참조). 표준 Cosmos SDK, EVM, QoreChain Native 라우트는 표준 라우트에 나열되어 있습니다.

존재하지 않는 라우트는 HTTP 501과 {"code":12,"message":"Not Implemented"}로 응답합니다. 이는 쿼리 결과가 비어 있다는 뜻이 아니라 해당 라우트가 제공되지 않는다는 뜻입니다. /qorechain/ 접두사가 없는 짧은 경로(예: /bridge/v1/chains 또는 /pqc/v1/params)는 제공되지 않습니다. 존재하는 라우트에서 알 수 없는 레코드를 조회하면 HTTP 404와 {"code":5,"message":"... not found"}가 반환됩니다.

아래 예시는 공개 메인넷 호스트를 사용합니다. 테스트넷에서는 https://api-testnet.qore.host로 바꾸십시오. 샘플의 값은 2026년 10월 20일부터 27일 사이에 실제 네트워크에서 읽은 것이며 시간이 지나면 변하므로, 응답의 형태를 파악하는 용도로만 사용하십시오. v3.2.4 릴리스는 일부 라우트와 필드를 추가했습니다. 이들은 아래에서 v3.2.4로 표시됩니다. 테스트넷은 2026년 10월 19일부터, 메인넷은 2026년 10월 23일부터 이를 제공하고 있습니다. v3.2.5 릴리스(메인넷은 2026년 10월 29일부터, 테스트넷은 10월 26일부터)는 크로스 VM 파라미터 및 메시지 라우트와 네이티브 키 레지스트리 라우트를 추가했으며 v3.2.5로 표시됩니다. v3.2.6 릴리스(테스트넷은 2026년 10월 27일부터, 메인넷은 2026년 11월 4일부터)는 더 많은 항목을 추가했으며 v3.2.6으로 표시됩니다. 메인넷 호스트는 2026년 11월 4일 이들에 200으로 응답했습니다(해당되는 곳에는 예외가 명시되어 있습니다). 아직 이전 릴리스인 노드는 새 라우트에 501로 응답합니다. v3.2.7 릴리스(테스트넷은 2026년 11월 6일부터, 메인넷은 2026년 11월 12일부터)는 v3.2.7로 표시된 라우트를 추가했습니다. PQC 멀티시그와 텍스추얼 서명, 스테이킹 APR, SVM 클러스터 식별 정보입니다.

PQC 모듈​

메서드엔드포인트설명
GET/qorechain/pqc/v1/account/{address}계정의 포스트 양자 키 등록 정보(found, 키 유형, 알고리즘)
GET/qorechain/pqc/v1/evm_window/{address}계정의 EVM 레인 승인 윈도우와 그 잔여 한도
GET/qorechain/pqc/v1/evm_limits적용 중인 EVM 가스 한도(트랜잭션당 30,000,000), 테스트넷 전용, v3.2.8부터. 메인넷은 v3.2.8을 적용하지 않았으며 501로 응답합니다(2026년 11월 12일 확인)
GET/qorechain/pqc/v1/evm_delegation_consent/{address}계정의 EIP-7702 위임 동의, 현재 위임 및 EVM 논스(v3.2.2부터)
GET/qorechain/pqc/v1/protocol_featuresv3.2.4(테스트넷은 2026년 10월 19일부터, 메인넷은 2026년 10월 23일부터이며 이전 릴리스 노드에서는 501). 바이너리가 알고 있는 모든 프로토콜 기능과 enabled, known, staged 플래그
GET/qorechain/pqc/v1/kem/{address}v3.2.5(메인넷은 2026년 10월 29일부터, 테스트넷은 10월 26일부터 두 네트워크 모두 제공하며 이전 노드에서는 501). 네이티브 키 레지스트리에서 주소에 등록된 ML-KEM 암호화 키: 등록된 것이 없으면 {"found":false,"key":null}
GET/qorechain/pqc/v1/paramsv3.2.6(테스트넷은 2026년 10월 27일부터, 메인넷은 2026년 11월 4일부터이며 이전 노드에서는 501). 모듈 파라미터
GET/qorechain/pqc/v1/multisig/{address}v3.2.7(테스트넷은 2026년 11월 6일부터, 메인넷은 2026년 11월 12일부터이며 이전 노드에서는 501). 주소의 하이브리드 포스트 양자 멀티시그 레코드: 등록된 것이 없으면 {"found":false,"multisig":null}
POST/qorechain/pqc/v1/textual_sign_docv3.2.7(테스트넷은 2026년 11월 6일부터, 메인넷은 2026년 11월 12일부터이며 이전 노드에서는 501, GET도 501로 응답). 웹 지갑이 표시하고 서명할 트랜잭션의 SIGN_MODE_TEXTUAL 문서를 생성합니다(아래 참조)

경로 세그먼트는 단수형 account입니다. /qorechain/pqc/v1/stats 라우트는 없습니다(qorechaind query pqc stats를 사용하십시오). /qorechain/pqc/v1/params는 v3.2.6부터 제공되며 2026년 11월 4일 두 네트워크 모두에서 200으로 응답했습니다(메인넷: pqc_primary true, allow_classical_fallback false, min_security_level 5, default_signature_algo_name dilithium5, hybrid_signature_mode_name required). v3.2.6보다 오래된 노드에서는 대신 qorechaind query pqc params를 사용하십시오.

PQC 멀티시그와 텍스추얼 서명 (v3.2.7)​

v3.2.7부터(테스트넷은 2026년 11월 6일, 메인넷은 2026년 11월 12일부터이며, 메인넷에서는 pqc-multisig 프로토콜 기능이 높이 4,164,600부터 활성화됨) 계정은 하이브리드 포스트 양자 k-of-n 멀티시그를 가질 수 있습니다. 메시지는 /qorechain.pqc.v1.MsgRegisterPQCMultisig이며, 포스트 양자 집합은 계정의 현재 클래식 멀티시그의 멤버와 키를 따릅니다. GET /qorechain/pqc/v1/multisig/{address}는 등록 정보를 반환합니다. 2026년 11월 7일에 멀티시그가 없는 계정에 대해 200과 {"found":false,"multisig":null}로 응답했습니다(이 라우트에는 유효한 qor1... 주소가 필요하며, 형식이 잘못된 주소는 400으로 응답합니다). 메인넷에서는 2026년 11월 12일부터 이 라우트가 제공됩니다(유효하지 않은 주소로 요청하면 400으로 응답했으며, 이는 라우트가 마운트되어 있음을 보여 줍니다). 아직 테스트넷에 등록된 멀티시그가 없으므로, 등록된 멀티시그의 레코드 필드는 여기서 읽지 못했습니다.

POST /qorechain/pqc/v1/textual_sign_doc는 SIGN_MODE_TEXTUAL로 서명하는 하드웨어 및 웹 지갑을 위한 것입니다. JSON 본문에는 tx_json(JSON 문자열로 된 서명 전 트랜잭션) 또는 tx_bytes(base64)와 함께 chain_id, account_number, sequence, public_key(@type과 key를 가진 Any)가 들어갑니다. 응답에는 sign_bytes(base64, 서명할 문서)와 기기가 표시하는 줄의 목록인 screens(title, content, indent, expert)가 담깁니다. 메인넷에서는 2026년 11월 12일에 빈 JSON 본문이 400으로 응답했으므로 이 라우트는 그곳에 마운트되어 있습니다. 트랜잭션이 없는 본문은 400(tx_bytes or tx_json is required)으로 응답하며, 메시지가 없거나 32개를 초과하는 트랜잭션은 거부됩니다. 명령줄에서는 qorechaind tx pqc cosign이 v3.2.7부터 텍스추얼 서명 모드를 지원합니다(트랜잭션 명령 참조).

curl -s https://api.qore.host/qorechain/pqc/v1/multisig/qor1... # or api-testnet.qore.host
curl -s -X POST https://api.qore.host/qorechain/pqc/v1/textual_sign_doc \
-H 'content-type: application/json' -d @request.json

포스트 양자 서명 검증에 부과되는 가스는 v3.2.7부터(테스트넷은 2026년 11월 6일, 메인넷은 2026년 11월 12일부터, 스위치 pqc-verify-gas-calibrated) 검증당 고정 2,000 가스입니다. 버전 이력을 참조하십시오.

curl -s https://api.qore.host/qorechain/pqc/v1/account/qor1...
{
"found": true,
"account": {
"address": "qor1...",
"public_key": "<base64 ML-DSA-87 public key>",
"algorithm_id": 1,
"algorithm_name": "dilithium5",
"ecdsa_pubkey": null,
"key_type": "hybrid",
"created_at_height": "209015",
"migration_public_key": null,
"migration_algorithm_id": 0,
"classical_key_source": "auth_account"
}
}

classical_key_source는 ecdsa_pubkey가 어디에서 왔는지를 나타냅니다: stored(등록 시 제공된 키), auth_account(저장된 것이 없어 계정 자체의 온체인 공개 키를 사용), 또는 none입니다. v3.2.4부터(테스트넷은 2026년 10월 19일부터, 메인넷은 2026년 10월 23일부터) 레코드에 "possession_proven": false도 포함되며, 이 값은 검증된 소유 증명과 함께 키가 등록되면 true가 됩니다. 이전 릴리스의 노드는 이 필드를 보고하지 않습니다.

등록된 키가 없는 계정은 {"found": false, "account": null}을 반환합니다. 계정이 전송하기 전에 키를 등록해야 하는지 판단하려면 found를 사용하십시오.

curl -s https://api.qore.host/qorechain/pqc/v1/evm_window/qor1...
{
"found": false,
"live": false,
"opened_height": "0",
"expiry_height": "0",
"max_txs": "0",
"used_txs": "0",
"max_value": "",
"used_value": "",
"remaining_blocks": "0",
"remaining_txs": "0",
"remaining_value": "",
"native_only": false,
"allowed_targets": []
}

이 라우트는 윈도우가 없는 주소에 대해서도 실패하지 않고 found: false를 반환합니다. v3.2.0부터 EVM 레인은 등록된 PQC 키가 있고 동시에 열린 윈도우가 있는 계정의 트랜잭션만 허용합니다. live는 윈도우가 현재 높이에서 트랜잭션을 최소 하나 더 허용하는 동안 true입니다. remaining_blocks, remaining_txs, remaining_value는 어느 한도가 가장 먼저 소진될지 보여 주며, 값은 문자열로 반환되는 uqor 정수입니다. v3.2.3부터 윈도우에 범위를 지정할 수 있습니다: native_only(일반 QOR 전송만 허용)와 allowed_targets(나열된 수신자에게만 허용하며, 어떤 컨트랙트와 토큰을 건드릴 수 있는지만 제한하고 금액은 제한하지 않음). EVM 레인의 동작 방식은 EVM 개발을 참조하십시오.

curl -s https://api.qore.host/qorechain/pqc/v1/evm_delegation_consent/qor1...
{
"found": false,
"live": false,
"delegate": "",
"granted_height": "0",
"expiry_height": "0",
"current_delegate": "",
"nonce": "0"
}

계정의 EIP-7702 위임은 해당 계정 자신의 포스트 양자 동의(MsgAuthorizeEVMDelegation)가 있어야만 효력이 발생합니다. found와 live는 delegate에 대해 기록된, 아직 사용 가능한 동의가 있는지를 보고하며, current_delegate는 계정이 현재 설정한 위임이고 nonce는 해당 계정의 EVM 논스입니다.

브리지 모듈​

브리지 모듈의 읽기 전용 상태는 /qorechain/bridge/v1/... 아래에서 REST로 노출됩니다(체인 버전 v3.1.77부터 실제 온체인 JSON 제공). 브리지 config는 예를 들어 min_validators=10과 attestation_threshold=7을 보고합니다.

메서드엔드포인트설명
GET/qorechain/bridge/v1/config현재 브리지 모듈 구성
GET/qorechain/bridge/v1/chains등록된 모든 브리지 체인 목록
GET/qorechain/bridge/v1/chains/{chain_id}특정 브리지 체인의 상세 정보
GET/qorechain/bridge/v1/validators등록된 브리지 검증인 목록
GET/qorechain/bridge/v1/validators/{address}특정 브리지 검증인의 상세 정보
GET/qorechain/bridge/v1/operations브리지 작업 목록
GET/qorechain/bridge/v1/operations/{id}특정 브리지 작업의 상세 정보
curl -s https://api.qore.host/qorechain/bridge/v1/config
{
"config": {
"min_validators": 10,
"attestation_threshold": 7,
"challenge_period_secs": "86400",
"large_transfer_threshold": "100000000000",
"enabled": true
}
}

chains/{chain_id}는 {"chain": {"chain_id": "ethereum", "name": "Ethereum", "chain_type": "evm", "bridge_contract": "0x000…0", "status": "pending", "min_confirmations": 12, ...}}와 같은 항목 하나를 반환합니다.

브리지는 아직 가동되지 않았습니다

구성된 37개의 브리지 체인은 두 네트워크 모두에서 "status": "pending"으로 보고되며, validators와 operations는 빈 목록입니다. 이 라우트들은 모듈의 구성을 보여 줄 뿐, 오늘 자산을 브리지할 수 있다는 의미가 아닙니다. 브리지 아키텍처를 참조하십시오.

멀티레이어 모듈​

멀티레이어 모듈의 전체 쿼리 서비스는 /qorechain/multilayer/v1/... 아래에서 REST로 노출되며(체인 버전 v3.1.80부터), 두 개의 상태 앵커 읽기 쿼리가 포함됩니다: anchor/{layer_id}는 레이어의 최신 정산 앵커를 반환하고, anchors/{layer_id}는 해당 레이어의 앵커 이력을 반환합니다. 각 앵커는 정규(canonical) 필드에 대한 ML-DSA-87 (Dilithium-5) 서명을 포함하므로, 클라이언트가 앵커를 가져와 독립적으로 검증할 수 있습니다 — 이는 Rollup Development Kit의 정산 영수증의 온체인 기반입니다.

메서드엔드포인트설명
GET/qorechain/multilayer/v1/params현재 Multilayer 모듈 파라미터
GET/qorechain/multilayer/v1/layers등록된 모든 레이어 목록
GET/qorechain/multilayer/v1/layers/{layer_id}특정 레이어의 상세 정보
GET/qorechain/multilayer/v1/anchor/{layer_id}레이어의 최신 상태 앵커
GET/qorechain/multilayer/v1/anchors/{layer_id}레이어의 상태 앵커 이력
GET/qorechain/multilayer/v1/routing-stats레이어 전반의 트랜잭션 라우팅 통계

StateAnchorView는 layer_id, layer_height, state_root, validator_set_hash, main_chain_height, anchored_at, pqc_aggregate_signature, transaction_count, compressed_state_proof를 포함합니다. v3.2.2부터 서명되는 메시지는 v2 앵커 메시지입니다: 도메인 태그 qorechain-multilayer-anchor-v2 다음에 체인 ID, 레이어 ID, 레이어 높이, 상태 루트, 검증인 집합 해시, 트랜잭션 수, 압축 상태 증명이 오며, 가변 길이 필드에는 각각 8바이트 빅엔디안 길이가 접두사로 붙습니다(이전 v1 메시지에는 체인 ID와 길이 접두사가 없어서 서명이 모든 체인에서 유효했습니다). 이 서명은 레이어 생성자가 등록한 PQC 키에 대해 검증됩니다. qorechaind query rdk anchor-sign-bytes는 롤업 배치에 대한 바이트를 출력합니다. 앵커가 없는 레이어는 anchor/{layer_id}에서 HTTP 404(no anchor for layer ...)를, anchors/{layer_id}에서 빈 목록({"anchors": []})을 반환합니다.

curl -s https://api.qore.host/qorechain/multilayer/v1/params
{
"params": {
"max_sidechains": "10",
"max_paychains": "50",
"min_anchor_interval": "100",
"max_anchor_interval": "1000",
"default_challenge_period": "86400",
"min_sidechain_stake": "1000000000",
"min_paychain_stake": "100000000",
"routing_enabled": true,
"routing_confidence_threshold": "0.6",
"cross_layer_fee_bundling": true
}
}

작성 시점 기준으로 layers는 두 네트워크 모두에서 빈 목록입니다. 샘플은 메인넷 응답이며, 테스트넷에서는 max_sidechains가 64입니다(빌더 이벤트를 위해 거버넌스 제안 16으로 상향, 2026년 10월 25일 통과).

소각 모듈​

소각 모듈의 읽기 전용 상태는 /qorechain/burn/v1/... 아래에서 REST로 노출됩니다. 소각 params에는 예를 들어 gas_burn_rate=0.30이 포함됩니다.

메서드엔드포인트설명
GET/qorechain/burn/v1/params현재 Burn 모듈 파라미터
GET/qorechain/burn/v1/stats소스별로 구분한 누적 소각 총량
GET/qorechain/burn/v1/records최근 소각 기록 목록
GET/qorechain/burn/v1/milestone소각 마일스톤 진행 상황(누적 트랜잭션 수)
GET/qorechain/burn/v1/stranded_rewards따로 확보되어 아직 거버넌스가 해제하지 않은 스테이커 몫
curl -s https://api.qore.host/qorechain/burn/v1/stats
{
"stats": {
"total_burned": "31574710367921",
"burns_by_source": {
"gas_fee": "31574710282421",
"failed_tx": "85500",
"milestone": "0",
"amm": "0",
"xqore_penalty": "0"
},
"last_burn_height": "3666968"
}
}

실제 응답에는 모든 소각 소스(ai_service, amm, auto_buyback, bridge_fee, contract_create, failed_tx, gas_fee, milestone, rollup_create, tge, treasury_buyback, xqore_penalty, 그리고 v3.2.4부터는 스테이킹 티어 잠금의 조기 해제 페널티가 소각되는 staking_tier_penalty)가 나열되며, 위 샘플은 일부만 보여 줍니다. 금액 단위는 uqor입니다. failed_tx는 실패한 트랜잭션의 소각이 실제로 부과된 수수료에 적용되기 시작한 v3.2.2 업그레이드 이후로 0이 아닌 값을 유지하고 있습니다. v3.2.3부터 오래된 건별 소각 records는 정리(prune)되므로, records는 전체 이력이 아니라 최근 구간입니다. stats의 합계는 누적 값입니다.

curl -s https://api.qore.host/qorechain/burn/v1/stranded_rewards
{ "reserved": "0", "released": "10500542706858", "initialized": true, "snapshot_height": "2981742" }

reserved는 아직 해제되지 않고 남은 금액, released는 거버넌스가 이미 이동한 금액, snapshot_height는 해당 적립금을 기록한 v3.2.0 업그레이드의 높이입니다. 위 값은 2026년 10월 23일에 읽은 값입니다: 거버넌스는 2026년 10월 19일에 첫 번째 금액(6,693,045.921330 QOR)을 해제했고, v3.2.3 업그레이드는 해당 높이에서 남은 적립금(3,807,496.785528 QOR)을 다시 계산했으며, 거버넌스 제안 12가 그 금액을 해제했으므로(통과, 투표는 2026년 10월 21일 종료) 적립금은 이제 비어 있고 released의 합계는 10,500,542.706858 QOR입니다. 실시간 값을 확인하십시오. 토크노믹스를 참조하십시오.

추상 계정 모듈​

추상 계정 쿼리 서비스는 /qorechain/abstractaccount/v1/... 아래에서 REST로 노출되며(체인 버전 v3.1.85부터), 하드코딩 없이 인증자(authenticator) 범위를 검증하는 데 사용되는 권한 스키마도 포함됩니다.

메서드엔드포인트설명
GET/qorechain/abstractaccount/v1/config모듈 구성(기능 프로브: enabled)
GET/qorechain/abstractaccount/v1/accounts추상 계정 목록
GET/qorechain/abstractaccount/v1/accounts/{address}주소의 추상 계정 상태(없으면 404)
GET/qorechain/abstractaccount/v1/permission_schemaschema_version, permissions, msg_permissions, key_management_msgs, lane_rules
GET/qorechain/abstractaccount/v1/auth_nonce/{address}/{pubkey_hex}v3.2.4(테스트넷은 2026년 10월 19일부터, 메인넷은 2026년 10월 23일부터이며 이전 릴리스 노드에서는 501). 연결된 인증자 키가 다음에 서명해야 하는 시퀀스(nonce, linked)
curl -s https://api.qore.host/qorechain/abstractaccount/v1/config
{ "config": { "enabled": false, "max_session_keys": 10, "max_spending_rules": 5, "default_session_ttl": "86400" } }
메인넷에서는 비활성화, 테스트넷에서는 활성화

위 샘플은 메인넷 응답입니다. 메인넷에서는 enabled가 false(그리고 accounts는 빈 목록)이므로, 연결된 지갑 지출과 같은 추상 계정 기능을 메인넷에서는 사용할 수 없습니다. 테스트넷에서는 거버넌스 제안 18(2026년 10월 27일 통과)부터 enabled가 true이며, accounts에는 지금까지 생성된 계정이 나열됩니다(2026년 10월 27일 확인). 이 모듈에 의존하기 전에 config.enabled를 기능 프로브로 사용하십시오. 계정 추상화를 참조하십시오.

AMM 모듈​

메서드엔드포인트설명
GET/qorechain/amm/v1/params현재 AMM 파라미터(베이시스 포인트 단위 수수료, 한도)
GET/qorechain/amm/v1/pools풀 목록
GET/qorechain/amm/v1/pools/{pool_id}풀 하나(알 수 없으면 404)
GET/qorechain/amm/v1/pools/{pool_id}/lp/{address}풀에서 한 주소의 LP 토큰 잔액
GET/qorechain/amm/v1/pool_by_denoms?denom_a=&denom_b=디놈 쌍에 해당하는 풀 조회(없으면 404)
GET/qorechain/amm/v1/quote/exact_in?pool_id=&denom_in=&amount_in=견적: 정확한 입력에 대한 출력
GET/qorechain/amm/v1/quote/exact_out?pool_id=&denom_out=&amount_out=견적: 정확한 출력에 필요한 입력
curl -s https://api.qore.host/qorechain/amm/v1/params
{
"params": {
"swap_fee_bps": 30,
"protocol_fee_bps": 10,
"min_liquidity": "1000",
"max_pools_per_creator": 50,
"lp_token_decimals": 6,
"pool_creation_fee": "100000000",
"max_swap_impact_bps": 500,
"enabled": true
}
}

일곱 개의 AMM 라우트 모두 두 네트워크에서 응답합니다(2026년 10월 27일 확인). 작성 시점 기준으로 두 네트워크 모두에 풀이 없습니다({"pools": []}). 일치하는 항목이 없는 입력에 대한 응답은 다음과 같습니다. 알 수 없는 ID의 pools/{pool_id}는 HTTP 404({"code":5,"message":"pool 1 not found"})를, 해당 쌍의 풀이 없는 pool_by_denoms는 404(no pool for uqor/foo)를, 알 수 없는 풀에 대한 견적은 HTTP 400과 {"code":3,"message":"pool not found"}를 반환합니다. pools/{pool_id}/lp/{address}는 LP 포지션이 없는 주소에 대해 {"balance":"0"}을 반환합니다(주소는 유효한 qor1 bech32 주소여야 하며, 그렇지 않으면 400). 두 견적 라우트와 pool_by_denoms는 쿼리 문자열에서 입력을 읽으므로 파라미터가 필요합니다. amount_in / amount_out 없이는 400(invalid amount_in / invalid amount_out)으로 응답합니다.

테스트넷에서는 풀에 필요한 두 번째 디노미네이션을 사용할 수 있습니다. 거버넌스로 등록된 세 가지 테스트 토큰이며, 테스트넷 테스트 토큰(Fest)을 참조하십시오. 메인넷에는 이에 해당하는 것이 없으며, 메인넷의 뱅크 디노미네이션은 uqor 하나뿐입니다.

라이선스 모듈​

메서드엔드포인트설명
GET/qorechain/license/v1/check/{grantee}/{feature_id}grantee가 해당 기능에 대해 유효한 부여를 보유하는지 여부(없으면 404)
GET/qorechain/license/v1/holders/{feature_id}기능에 대한 모든 부여
GET/qorechain/license/v1/list/{grantee}한 주소가 보유한 모든 부여

부여(LicenseView)에는 grantee, feature_id, expires_at, granted_at, granted_by, suspended, metadata가 있습니다. check는 active도 반환합니다. 일치하는 항목이 없는 list 또는 holders 쿼리는 {"licenses": []}를 반환하며, 부여가 없는 주소에 대한 check는 HTTP 404와 {"code":5,"message":"no license for <grantee>/<feature_id>"}를 반환합니다.

curl -s https://api.qore.host/qorechain/license/v1/holders/lightnode_operator
{
"licenses": [
{
"grantee": "qor1...",
"feature_id": "lightnode_operator",
"expires_at": "0",
"granted_at": "3536305",
"granted_by": "qor1...",
"suspended": false,
"metadata": "",
"active": true
}
]
}

expires_at: "0"은 부여가 만료되지 않음을 의미합니다. v3.2.3부터 거버넌스는 이러한 라이선스를 부여하는 라이선스 권한자를 교체할 수 있습니다(MsgUpdateAuthority). 이미 이루어진 부여는 그대로 유지됩니다.

라이트 노드 모듈​

메서드엔드포인트설명
GET/qorechain/lightnode/v1/params등록, 하트비트, 보상 파라미터
GET/qorechain/lightnode/v1/statstotal_registered, total_active, total_rewards, last_reward_height
GET/qorechain/lightnode/v1/nodes등록된 라이트 노드 목록
GET/qorechain/lightnode/v1/node/{address}노드 하나(등록되지 않았으면 {"node": null, "found": false})
GET/qorechain/lightnode/v1/rewards/{address}운영자 주소에 누적된 보상(accumulated_rewards)
GET/qorechain/lightnode/v1/reward_pool보상 풀 회계(balance, reserved, outstanding, payable, distributable, max_reward_per_block_per_node, max_reward_per_month_per_node, initialized)
curl -s https://api.qore.host/qorechain/lightnode/v1/params
{
"registration_fee": "1000000",
"heartbeat_interval": "1000",
"min_delegated_stake": "1000000000",
"reward_share": "0.030000000000000000",
"min_uptime_for_rewards": "0.800000000000000000",
"max_light_nodes": "10000",
"heartbeat_grace_period": "100"
}
curl -s https://api.qore.host/qorechain/lightnode/v1/reward_pool
{
"balance": "5645408555",
"reserved": "5645276228",
"outstanding": "130077",
"payable": "0",
"max_reward_per_block_per_node": "1713",
"distributable": "2250",
"initialized": true,
"max_reward_per_month_per_node": "2000000000",
"monthly_cap_active": true,
"last_distribution_time": "1792775155",
"last_distribution_height": "3744000"
}

reserved는 풀에서 따로 보류되어 거버넌스 투표로만 이동할 수 있는 부분입니다. 노드별 한도는 uqor 단위입니다. max_reward_per_block_per_node는 블록당 상한이며, v3.2.3부터 max_reward_per_month_per_node(2000000000 uqor = 30일당 2,000 QOR)는 월 상한으로서 블록 시간과 가동 시간에 비례해 산정되므로 더 이상 블록 생성 속도에 좌우되지 않습니다. 상한은 약속된 금액이 아닙니다. 이 샘플은 거버넌스가 이전 적립금을 해제한 뒤(제안 8, 2026년 10월 19일) 2026년 10월 23일에 읽은 실제 메인넷 응답입니다. v3.2.4부터(테스트넷은 2026년 10월 19일부터, 메인넷은 2026년 10월 23일부터) 응답에 monthly_cap_active, last_distribution_time, last_distribution_height도 포함되며, 노드의 한도는 해당 노드 자신의 등록 시점부터 시작됩니다.

등록에는 라이선스가 필요합니다

체인은 유효한 lightnode_operator 라이선스 부여 없이는 라이트 노드 등록을 거부합니다(holders/lightnode_operator가 부여 목록을 보여 줍니다). 2026년 10월 27일 기준으로 stats는 메인넷과 테스트넷 모두에서 "total_registered": "1"을 보고합니다. 프로그램 상태는 라이트 노드를 참조하십시오.

RDK 모듈​

Rollup Development Kit 쿼리 서비스는 /qorechain/rdk/v1/... 아래에서 REST로 노출됩니다(체인 버전 v3.2.2부터. v3.2.0과 v3.2.1에서는 gRPC 전용이었습니다).

메서드엔드포인트설명
GET/qorechain/rdk/v1/params모듈 파라미터
GET/qorechain/rdk/v1/rollups롤업 목록
GET/qorechain/rdk/v1/rollup/{rollup_id}롤업 하나(알 수 없으면 404)
GET/qorechain/rdk/v1/latest_batch/{rollup_id}롤업의 최신 정산 배치
GET/qorechain/rdk/v1/batch/{rollup_id}/{batch_index}정산 배치 하나
GET/qorechain/rdk/v1/batches/{rollup_id}롤업의 배치를 인덱스 순서로(페이지 단위)
GET/qorechain/rdk/v1/blob/{rollup_id}/{blob_index}데이터 가용성 블롭 레코드 하나
curl -s https://api.qore.host/qorechain/rdk/v1/params
{
"params": {
"max_rollups": 100,
"min_stake_for_rollup": "10000000000",
"rollup_creation_burn_rate": "0.01",
"default_challenge_window": "604800",
"max_da_blob_size": "2097152",
"blob_retention_blocks": "432000",
"max_batches_per_block": 10
}
}

작성 시점 기준으로 rollups는 두 네트워크 모두에서 빈 목록이므로, 롤업별 라우트는 404로 응답합니다(예: {"code":5,"message":"rollup foo not found"}). default_challenge_window는 초 단위(604800)로 표현됩니다. v3.2.4부터 새로 제출된 배치의 낙관적 챌린지 윈도우는 블록 시간으로 측정됩니다. 테스트넷에서는 높이 8,337,253(2026년 10월 19일)부터, 메인넷에서는 높이 3,742,566(2026년 10월 23일)부터입니다. 업그레이드 이전에는 체인이 초 값을 블록당 6초로 고정하여 블록 수로 환산했습니다. 테스트넷에서는 거버넌스 제안 17(2026년 10월 27일 통과)이 빌더 이벤트를 위해 default_challenge_window를 3600(1시간)으로, max_rollups를 200으로 설정했으므로, 위 샘플(메인넷)은 이 부분에서 테스트넷과 다릅니다. 작성 시점에 테스트넷의 rollups는 여전히 빈 목록입니다.

v3.2.7(테스트넷은 2026년 11월 6일부터. rdk-zk-verification-key 스위치는 메인넷에서 2026년 11월 12일부터 켜져 있음): ZK 롤업은 MsgSetVerificationKey로 검증 키를 등록할 수 있으며(이후 MsgUpdateVerificationKey로 변경), 키가 없는 롤업의 ZK 배치는 수수료가 지불되기 전에 거부됩니다. 이들은 쿼리가 아니라 메시지입니다. 등록된 키를 읽는 REST 라우트는 없으며(명백한 경로들은 2026년 11월 7일에 501로 응답했습니다), 테스트넷에는 등록된 ZK 롤업이 없으므로(rollups가 비어 있음. 메인넷도 2026년 11월 4일 마지막으로 확인했을 때 없었음) 등록은 여기서 끝까지 실행해 보지 못했습니다. 버전 이력을 참조하십시오.

인플레이션 모듈​

발행 설정과 진행 상황은 /qorechain/inflation/v1/... 아래에서 REST로 노출됩니다(체인 버전 v3.2.2부터). CLI 명령으로는 제공되지 않습니다.

메서드엔드포인트설명
GET/qorechain/inflation/v1/params발행 파라미터: emission_mode, fixed_epoch_emission, max_total_emission, epoch_length, enabled
GET/qorechain/inflation/v1/epoch_info진행 상황: current_epoch, block_start, next_epoch_height, total_minted, max_total_emission, remaining_emission
curl -s https://api.qore.host/qorechain/inflation/v1/params
curl -s https://api.qore.host/qorechain/inflation/v1/epoch_info

메인넷에서 emission_mode는 "fixed", fixed_epoch_emission은 "86000000000"(에포크당 86,000 QOR), epoch_length는 "43200" 블록, max_total_emission은 "590000000000000"(590,000,000 QOR, 누적 상한)입니다. 이 값들은 거버넌스 제안 10(2026년 10월 19일 통과)으로 설정되었으며, 새로운 고정 금액을 사용하는 첫 에포크는 블록 3,672,000에서 시작하고, epoch_info는 진행 중인 에포크와 지금까지 발행된 금액을 보여 줍니다. 응답의 schedule 목록은 원래의 schedule 모드에 속하며, 고정 모드 에포크가 발행하는 금액을 설명하지 않습니다. 모든 금액은 uqor입니다. 테스트넷은 자체적으로 다른 값을 보고합니다. v3.2.4부터 세 번째 모드인 target_apy가 있으며 target_apy_bps 필드를 갖습니다(테스트넷은 2026년 10월 19일부터, 메인넷은 2026년 10월 23일부터). 네트워크는 자체 거버넌스 투표로만 이 모드로 전환하므로, 그러한 투표가 통과될 때까지 메인넷은 fixed를 유지합니다(2026년 10월 27일 확인: 여전히 fixed). 테스트넷은 자체 거버넌스(제안 14, 2026년 10월 20일 통과)를 통해 target_apy로 전환했으며, 작성 시점에 "emission_mode": "target_apy"를 보고합니다. epoch_info에는 누적 상한에 이미 도달했음이 표시됩니다(remaining_emission 0).

가스 추상화 모듈​

메서드엔드포인트설명
GET/qorechain/gasabstraction/v1/config허용되는 수수료 토큰, 프리미엄, 블록당 변환 한도
GET/qorechain/gasabstraction/v1/conversion_rate?denom=수수료 토큰 한 단위가 uqor로 얼마의 가치인지, 그리고 usable 여부
GET/qorechain/gasabstraction/v1/float변환 플로트의 주소, 잔액 및 이번 블록의 사용량
curl -s https://api.qore.host/qorechain/gasabstraction/v1/config
{
"config": {
"enabled": true,
"native_denom": "uqor",
"accepted_tokens": [
{ "denom": "uqor", "conversion_rate": "1.0", "price_source": "", "rate_expiry_height": "0",
"pool_id": "0", "min_liquidity": "", "max_deviation_bps": 0 }
],
"premium_bps": 300,
"max_tip_multiplier": 3,
"float_min": "0",
"block_conversion_cap": "0"
}
}

허용 목록에는 두 네트워크 모두 네이티브 uqor만 들어 있으므로, 수수료는 uqor로 지불되며 변환은 이루어지지 않습니다. 거버넌스가 토큰을 추가하며(풀, 최소 유동성, 시간 가중 가격과 현물 가격 간 최대 편차와 함께), 이러한 토큰으로 지불된 수수료는 QOR 플로트를 통해 변환되고 AMM 풀을 통해 다시 채워집니다. ?denom= 없이 conversion_rate를 호출하면 500(denom is required)으로 응답합니다.

RL 합의 모듈 (v3.2.6)​

두 네트워크 모두 v3.2.6부터 제공

rlconsensus 모듈의 REST 게이트웨이는 v3.2.6과 함께 도입되었으며, qorechain-diana 테스트넷은 이를 2026년 10월 27일 높이 8,970,638에서, 메인넷은 2026년 11월 4일 높이 4,020,000에서 적용했습니다. 2026년 11월 4일에 아래의 일곱 개 라우트 모두 테스트넷뿐 아니라 공개 메인넷 호스트에서도 HTTP 200으로 응답했으며, 어느 것도 파라미터가 필요하지 않습니다. v3.2.6 이전에는 501({"code":12,"message":"Not Implemented"})로 응답했고 이 모듈은 gRPC로만 접근할 수 있었습니다.

메서드엔드포인트설명
GET/qorechain/rlconsensus/v1/agent에이전트 상태: mode, current_epoch, total_steps, last_observation_at, last_action_at, circuit_breaker_active, blocks_since_revert
GET/qorechain/rlconsensus/v1/params모듈 파라미터: 관측 간격, 에이전트 모드, 스텝 한도, 서킷 브레이커 윈도우와 임계값, 보상 가중치, 기본 블록 시간, 가스 가격, 검증인 집합 크기
GET/qorechain/rlconsensus/v1/observation최신 관측 벡터(height와 25개의 values)
GET/qorechain/rlconsensus/v1/reward최신 보상 신호와 그 구성 요소
GET/qorechain/rlconsensus/v1/policy저장된 정책 네트워크: epoch, updated_at, weight_count(가중치 자체는 반환되지 않음)
GET/qorechain/rlconsensus/v1/applied_params에이전트가 적용된 것으로 보유한 값: block_time_ms, gas_limit, gas_price_floor, pool_weight_rpos, pool_weight_dpos
GET/qorechain/rlconsensus/v1/last_action에이전트가 마지막 스텝에서 제안한 행동: height, mode, 다섯 개의 values, applied
curl -s https://api-testnet.qore.host/qorechain/rlconsensus/v1/agent
curl -s https://api-testnet.qore.host/qorechain/rlconsensus/v1/last_action
{ "mode": "shadow", "current_epoch": "1", "total_steps": "209", "last_observation_at": "8975660",
"last_action_at": "8975660", "circuit_breaker_active": false, "blocks_since_revert": "0" }
{ "height": "8975660", "mode": "shadow", "values": ["-0.334711810000000000", "-0.500000000000000000",
"0.000000000000000000", "0.000000000000000000", "0.000000000000000000"], "applied": false }

위의 샘플은 테스트넷의 것입니다. 메인넷(2026년 11월 4일 확인)에서 에이전트는 conservative 모드이며 current_epoch는 0, total_steps는 0, circuit_breaker_active는 false입니다. policy는 weight_count 0(저장된 정책 없음)을 보고하고, last_action은 비어 있으며(height 0, applied false), applied_params는 기본값을 담고 있습니다. 에이전트는 observation_interval개 블록(10)마다 한 스텝을 수행합니다. shadow 모드에서는 행동을 계산해 기록만 하고 아무것도 적용하지 않으므로, applied는 false이고 applied_params는 기본값(block_time_ms 5000, gas_price_floor 100, 풀 가중치 0.40과 0.35)을 유지합니다. 테스트넷에서는 거버넌스 제안 29(2026년 10월 27일 통과)로 저장된 정책과 함께 에이전트가 shadow 모드로 시작되었으며, circuit_breaker_active는 false입니다. 메인넷은 에이전트를 시작하지 않았습니다. 금액과 값은 문자열입니다. 적용된 값은 이번 릴리스에서는 참고용입니다. 온체인의 유일한 리더는 읽기 전용 rlConsensusParams 프리컴파일입니다. 대응하는 gRPC 메서드는 AgentStatus, Params, Observation, Reward, Policy, AppliedParams, LastAction(서비스 qorechain.rlconsensus.v1.Query)이며, CLI 명령은 쿼리 명령에 있습니다.

스테이킹 티어 모듈 (v3.2.4)​

v3.2.4부터 제공

스테이킹 티어 모듈은 v3.2.4에 포함되어 있습니다. 이 라우트들은 테스트넷에서 2026년 10월 19일부터, 메인넷에서 2026년 10월 23일부터 제공되고 있습니다(거버넌스 제안 13, 높이 3,742,566). 이전 릴리스의 노드는 501로 응답합니다.

메서드엔드포인트설명
GET/qorechain/stakingtier/v1/params락 티어, 최소 락 금액, 조기 해제 페널티
GET/qorechain/stakingtier/v1/locks/{holder}보유자의 락, 각 락에 현재 누적된 금액 및 청구할 수 있는 금액
GET/qorechain/stakingtier/v1/pool보너스 풀: 잔액, 미지급액, 잉여금 및 마지막 정산
GET/qorechain/stakingtier/v1/aprv3.2.7(테스트넷은 2026년 11월 6일부터, 메인넷은 2026년 11월 12일부터이며 이전 노드에서는 501). 기본 스테이킹 이율과 티어 보너스
GET/qorechain/stakingtier/v1/apr/{delegator}v3.2.7(같은 제공 시점). 한 위임자에 대한 같은 정보: 라이트 노드 보너스 상태, 위임 내역, 유효 이율

params는 세 가지 락 기간(3개월, 6개월, 12개월)과 해당 파라미터, 그리고 min_lock_amount("10000000" uqor, 10 QOR)를 나열합니다. 락은 tx stakingtier lock으로 생성합니다(트랜잭션 명령 참조).

APR 라우트(v3.2.7). 2026년 11월 12일 메인넷 라우트는 source emission, bonus_enabled true, max_total_apy_bps 2500과 함께 200으로 응답했고, 위임자 라우트는 유효하지 않은 주소에 400으로 응답했습니다. GET /qorechain/stakingtier/v1/apr는 base(gross_base_apr_bps, source, computed_height, bonus_enabled, max_total_apy_bps), base_apr_bps, tiers 목록(3개월, 6개월, 12개월에 대해 bonus_bps 150, 300, 500과 유효 값), 그리고 라이트 노드 및 검증자 보너스(light_node_bonus_bps 200, validator_bonus_bps 300)를 반환합니다. 2026년 11월 7일 테스트넷의 기본 이율은 0(source는 fees_only)으로 읽혔으므로 티어 보너스만 0이 아니었으며, 풀 라우트는 보너스 풀을 보고합니다. 위임이 없는 주소에 대해 위임자 라우트는 빈 delegations 목록과 0의 유효 이율로 200을 응답합니다. 모든 수치는 체인이 마지막 정산에서 계산한 값을 베이시스 포인트로 읽은 것입니다. 이는 보장되지 않으며, 수수료와 자금에 따라 변하고, 어떤 수익에 대한 약속도 아닙니다.

SVM 클러스터 식별 정보 (v3.2.7)​

메서드엔드포인트설명
GET/qorechain/svm/v1/cluster_infov3.2.7(테스트넷은 2026년 11월 6일부터, 메인넷은 2026년 11월 12일부터이며 이전 노드에서는 501). SVM 클러스터의 식별 정보: chain_id, genesis_hash, caip2_chain_id(Wallet Standard 체인 id), derivation, execution_enabled

2026년 11월 7일 테스트넷은 genesis_hash 6Z9pa53SwiprqiAoNCqqUdj5c3C4P1zRw31gQVnF4Czj, caip2_chain_id solana:6Z9pa53SwiprqiAoNCqqUdj5c3C4P1zR, execution_enabled false로 응답했습니다. 제네시스 해시는 체인 ID에서 도출되므로(고정 레이블과 체인 ID의 SHA-256을 base58로 인코딩) 안정적입니다. 같은 값이 SVM JSON-RPC의 getGenesisHash와 getVersion에도 있습니다(JSON-RPC Solana 호환 참조). SVM은 계속 꺼져 있습니다. execution_enabled는 false입니다. 2026년 11월 12일 메인넷은 chain_id qorechain-vladi, genesis_hash 4LQ9znKk8J3C8YBz2unNdqRCC35ZXvSiFN9YGJNwu3er, caip2_chain_id solana:4LQ9znKk8J3C8YBz2unNdqRCC35ZXvSi, execution_enabled false로 200 응답했으며, 메인넷에서도 SVM 레인은 아직 꺼져 있습니다.

평판 모듈​

평판 모듈의 REST 라우트는 체인 v3.2.6과 함께 도입되었으며 두 네트워크 모두에서 제공됩니다(테스트넷은 2026년 10월 27일부터, 메인넷은 2026년 11월 4일부터). 2026년 11월 4일 공개 메인넷 호스트에서 확인한 결과 /qorechain/reputation/v1/params, /validators, /validator/{address}가 모두 200으로 응답했습니다. v3.2.6 이전에는 모든 라우트가 HTTP 501({"code":12,"message":"Not Implemented"})로 응답했고 이 모듈은 gRPC로만 접근할 수 있었습니다.

메서드엔드포인트설명
GET/qorechain/reputation/v1/params점수 가중치(alpha, beta, gamma, delta), lambda, min_score
GET/qorechain/reputation/v1/validator/{address}한 검증자의 레코드. {address}는 qorvaloper1... 운영자 주소 또는 qorvalcons1... 합의 주소입니다. 필드에는 composite_score, stake_score, performance_score, contribution_score, time_score, uptime_blocks, missed_blocks, last_updated_height가 있습니다. 404는 검증자에게 아직 점수가 없다는 뜻이며, 운영자 주소도 합의 주소도 아닌 문자열은 400으로 응답합니다
GET/qorechain/reputation/v1/validators점수가 매겨진 모든 검증자의 레코드(reputations)

점수는 0과 1 사이의 십진수 문자열입니다. 라이트 노드는 검증자별 라우트를 읽어, 위임한 검증자가 min_reputation 아래로 내려가면 경고합니다(보상 및 모니터링 참조). 같은 라우트가 두 공개 호스트 모두에서 동작합니다.

gRPC 전용 모듈​

메인넷(노드 릴리스 v3.2.7은 2026년 11월 12일부터이며, 모듈 목록은 svm 행을 제외하고 v3.2.6에서 2026년 11월 4일에 확인)에서 이 모듈들은 gRPC Query 서비스는 있지만, 표에 있는 예외를 제외하면 REST 라우트는 없습니다. 서비스 이름은 qorechain.<module>.v1.Query 형식을 따릅니다.

모듈gRPC 쿼리 메서드(메인넷, 체인 버전 v3.2.7)
aiConfig, Stats
crossvmPendingMessages (v3.2.5부터 REST로 제공: Params는 /qorechain/crossvm/v1/params, Message는 /qorechain/crossvm/v1/message/{id})
reputationParams (v3.2.6부터 REST로도 제공, 평판 모듈 참조)
rlconsensusAgentStatus, Params, Observation, Reward, Policy, AppliedParams, LastAction (v3.2.6부터 REST로도 제공)
svmSlot, Account, Program (v3.2.7은 두 네트워크 모두에 ClusterInfo를 추가하며 REST로도 제공, SVM 클러스터 식별 정보 참조)
qcaConfig

rlconsensus 쿼리는 v3.2.6부터 두 네트워크 모두에서 REST로 제공됩니다(AppliedParams와 LastAction 두 메서드가 추가됨). RL 합의 모듈을 참조하십시오. 직접 실행하는 노드에 grpcurl을 사용하거나 CLI 쿼리 명령을 사용하십시오. rdk 쿼리는 REST로도 사용할 수 있으며(RDK 모듈 참조), v3.2.2 이전에는 gRPC 전용이었습니다.

xQORE, BTC 리스테이킹(Babylon), FairBlock 모듈은 현재 릴리스에서 REST와 gRPC 모두 쿼리 서비스가 전혀 없습니다. v3.2.2 이전에는 쿼리 서비스가 없었던 인플레이션 및 가스 추상화 모듈은 REST로 제공됩니다(인플레이션 모듈 및 가스 추상화 모듈 참조).

표준 라우트​

표준 Cosmos SDK, IBC, EVM, QoreChain Native REST 라우트도 제공됩니다. 두 네트워크에서 확인된 예시는 다음과 같습니다:

엔드포인트설명
/cosmos/bank/v1beta1/supply총 공급량
/cosmos/bank/v1beta1/balances/{address}계정 잔액
/cosmos/staking/v1beta1/validators검증인
/cosmos/staking/v1beta1/params스테이킹 파라미터
/cosmos/distribution/v1beta1/params분배 파라미터
/cosmos/gov/v1/params/voting거버넌스 파라미터
/cosmos/slashing/v1beta1/params슬래싱 파라미터
/cosmos/upgrade/v1beta1/current_plan, /applied_plan/{name}예정된 / 적용된 업그레이드(메인넷에서 applied_plan/v3.2.3은 {"height":"3662051"}을 반환)
/cosmos/circuit/v1/disable_list네트워크 전체에서 비활성화된 메시지 유형
/cosmos/base/node/v1beta1/config노드 최소 가스 가격(두 네트워크 모두 0.1uqor)
/cosmos/base/tendermint/v1beta1/blocks/latest최신 블록
/cosmos/tx/v1beta1/txs, /txs/{hash}, /txs/block/{height}트랜잭션 검색 / 조회 / 블록별 조회
/cosmos/evm/vm/v1/paramsEVM 모듈 파라미터
/cosmos/evm/feemarket/v1/paramsEVM 수수료 시장 파라미터
/cosmwasm/wasm/v1/codes/paramsQoreChain Native 업로드/인스턴스화 권한
/ibc/apps/transfer/v1/paramsIBC 전송 파라미터
/ibc/core/client/v2/counterparty_info/{client_id}v3.2.6. 클라이언트에 등록된 IBC v2 카운터파티(없으면 404)
/ibc/core/client/v2/config/{client_id}v3.2.6. IBC v2 클라이언트 구성(allowed_relayers)
/cosmos/evm/erc20/v1/token_pairs, /token_pairs/{token}ERC20 토큰 쌍(테스트넷: 세 가지 Fest 테스트 토큰과 IBC 토큰 하나, 메인넷: 없음)

QoreChain Native 접두사는 /cosmwasm/wasm/v1/...이며, /cosmos/wasm/v1/...은 제공되지 않습니다.

IBC v2 클라이언트 라우트 (v3.2.6)​

IBC v2 클라이언트 쿼리 서비스는 이전에도 gRPC로 제공되었지만 REST 라우트가 빠져 있었습니다. v3.2.6이 이를 마운트합니다. 릴레이어는 여기서 클라이언트의 카운터파티를 읽습니다. 두 라우트 모두 경로에 클라이언트 ID(예: 07-<type>-0)를 받으며, 빈 ID는 400으로 응답합니다. 테스트넷은 2026년 10월 27일에, 메인넷은 2026년 11월 4일에 확인했습니다:

라우트테스트넷메인넷 (v3.2.6)
/ibc/core/client/v2/counterparty_info/{client_id}카운터파티와 함께 200, 또는 등록된 카운터파티가 없는 클라이언트에는 404(client 07-<type>-0 counterparty not found). 빈 ID는 400같은 형태: 카운터파티가 없는 클라이언트에는 404(client 07-tendermint-0 counterparty not found)(메인넷에는 아직 IBC 클라이언트가 없음)
/ibc/core/client/v2/config/{client_id}200, {"config":{"allowed_relayers":[]}}(빈 목록은 모든 릴레이어를 허용한다는 뜻)200, {"config":{"allowed_relayers":[]}}
/ibc/core/channel/v2/clients/{client_id}/next_sequence_send, /packet_commitments 및 그 밖의 IBC v2 채널 라우트응답함(클라이언트에 기록된 것이 없으면 404, 커밋먼트는 빈 목록과 함께 200)응답함, 같은 형태(2026년 11월 4일 확인)

IBC v1 라우트(/ibc/core/client/v1/..., /ibc/core/channel/v1/...)는 두 네트워크 모두에서 응답합니다. 작성 시점에 테스트넷에는 IBC 클라이언트 하나와 열린 전송 채널 하나(channel-0, IBC 디노미네이션 토큰 하나)가 있으며, 메인넷에는 IBC 클라이언트, 채널, IBC 디노미네이션 토큰이 없습니다. 레이트 리밋 모듈은 /Stride-Labs/ibc-rate-limiting/ratelimit/ratelimits에서, 08-wasm 체크섬 목록은 /ibc/lightclients/wasm/v1/checksums에서 응답합니다. 두 네트워크 모두에서 첫 번째는 빈 rate_limits 목록(설정된 한도 없음)을, 두 번째는 빈 checksums 목록을 반환합니다. 메인넷은 2026년 11월 4일 둘 다 200으로 응답했습니다(v3.2.6 이전에는 501로 응답). 패킷 포워딩 쿼리 라우트 /ibc/apps/packetforward/v1/params는 메인넷에서 501로 응답했습니다. 이에 대한 공개 라우트는 찾지 못했으므로, 그 설정은 그곳에서 REST로 읽을 수 없습니다.

테스트넷 테스트 토큰 (Fest)​

테스트넷 전용, 가치 없음

아래 세 토큰은 qorechain-diana 테스트넷에만 존재합니다. 빌더를 위한 테스트 토큰이며 가치가 없고, 메인넷에는 ERC20 토큰 쌍이 전혀 없습니다(2026년 10월 27일 확인: token_pairs가 비어 있고 뱅크 공급량에는 uqor만 있습니다). 거버넌스는 2026년 10월 27일(제안 26) 이들을 ERC20 토큰 쌍으로 등록했습니다.

테스트넷에서는 등록된 ERC20 토큰이 뱅크 코인으로도 존재하므로, 보유하고 전송할 수 있으며 AMM 풀의 두 번째 디노미네이션으로 사용할 수 있습니다. 뱅크 디노미네이션은 erc20: 뒤에 EIP-55 대소문자 혼합 체크섬 형식의 컨트랙트 주소가 붙은 것이며, 디놈 문자열은 대소문자를 구분합니다. 모두 소문자로 쓰면 다른 문자열이 되어 찾을 수 없습니다.

토큰컨트랙트 주소뱅크 디놈소수 자릿수
fUSD (FestUSD)0x97143B771D34ddb9130b807b135Ae675A5a963CAerc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA6
fETH (FestETH)0x02292293c13880a26242690eb70a0e42B8E91c28erc20:0x02292293c13880a26242690eb70a0e42B8E91c2818
fBTC (FestBTC)0x4604e7E45b2ecdbfbDc157103f5B2b62cb16451Aerc20:0x4604e7E45b2ecdbfbDc157103f5B2b62cb16451A8
# the three tokens and their display names / decimals
curl -s https://api-testnet.qore.host/cosmos/bank/v1beta1/denoms_metadata
# one denom: the case matters (this returns the metadata, the lowercase spelling returns 404)
curl -s "https://api-testnet.qore.host/cosmos/bank/v1beta1/denoms_metadata/erc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA"
# the ERC20 token pairs, and the supply of one denom
curl -s https://api-testnet.qore.host/cosmos/evm/erc20/v1/token_pairs
curl -s "https://api-testnet.qore.host/cosmos/bank/v1beta1/supply/by_denom?denom=erc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA"

denoms_metadata는 각 토큰을 symbol fUSD / fETH / fBTC, display FestUSD / FestETH / FestBTC, 그리고 표시 단위의 지수로서의 소수 자릿수와 함께 나열합니다. 잔액 쿼리(/cosmos/bank/v1beta1/balances/{address})는 보유자 잔액 중 변환된 부분을 erc20:... 디놈 아래에 보여 주며, 여전히 EVM 쪽에 있는 토큰은 ERC20 컨트랙트 자체의 balanceOf에 나타납니다. 두 형태 사이의 변환은 MsgConvertERC20(EVM에서 뱅크로)과 MsgConvertCoin(뱅크에서 EVM으로)으로 수행하며, MsgConvertERC20의 발신자는 qor1 bech32 주소로 작성해야 합니다. EVM 개발을 참조하십시오.

gRPC 리플렉션​

직접 실행하는 노드는 포트 9090에서 gRPC를 제공합니다. 서버 리플렉션이 활성화된 경우 grpcurl 같은 도구로 사용 가능한 서비스를 탐색할 수 있습니다:

grpcurl -plaintext localhost:9090 list

특정 서비스를 조회하려면:

grpcurl -plaintext -d '{"address":"qor1..."}' localhost:9090 qorechain.pqc.v1.Query/Account

qorechain.pqc.v1.Query에는 v3.2.3 노드에서 Account, EVMWindow, EVMDelegationConsent의 세 가지 메서드가 있으며, v3.2.4부터(테스트넷은 2026년 10월 19일부터, 메인넷은 2026년 10월 23일부터) ProtocolFeatures라는 네 번째 메서드가 있습니다. Params 메서드는 v3.2.6에서 추가되었으며(테스트넷은 2026년 10월 27일부터, 메인넷은 2026년 11월 4일부터), v3.2.6보다 오래된 노드에는 Params 메서드가 없습니다. v3.2.7(두 네트워크 모두)은 PQC 멀티시그와 텍스추얼 서명에 설명된 멀티시그 및 텍스추얼 문서 라우트를 추가합니다.

인증​

모든 REST 및 gRPC 엔드포인트는 기본적으로 인증되지 않습니다. 프로덕션 배포에서는 노드 앞에 리버스 프록시(예: Nginx 또는 Caddy)를 두어 TLS 종료와 접근 제어를 처리하십시오.