x402 Quicknode 에서: 개발자와 AI를 위한 즉각적인 블록체인 접근 Agents

Quicknode

2026년 2월 17일 — 읽는 데 11분 소요

공유하기

선호하는 소스로 추가

Quicknode 이제 x402 에서 요청당 과금 방식의 액세스를 지원하여, 개발자와 AI agents 사용자가 130개 이상의 네트워크에 걸쳐 있는 블록체인 엔드포인트에 지갑 인증을 통해 즉시 액세스할 수 있게 되었습니다. 여기에는 RPC, WebSocket, REST 및 gRPC 인터페이스가 포함됩니다. Base, Solana 또는 Polygon 에서 USDC로 결제하고 몇 분 안에 호출을 시작하세요.

x402 이는 ‘ Quicknode ’의 기존 요금제를 보완하는 추가형 액세스 방식입니다. 프로덕션 워크로드를 운영하는 팀은 ‘ Quicknode ’의 표준 요금제를 통해 SLA, 전담 지원, 크레딧 기반 청구 등의 혜택을 누릴 수 있습니다. ‘ x402 ’는 가볍고 허가 없이 이용할 수 있는 액세스가 우선시되는 사용 사례에 대한 새로운 옵션을 제공합니다.

이 글에서는 x402 가 무엇인지, Quicknode 와 어떻게 연동되는지, 이를 통해 무엇을 만들 수 있는지, 그리고 시작하는 방법에 대해 다룹니다.

x402 란 무엇인가요?

x402 코인베이스(Coinbase)가 개발한 개방형 결제 프로토콜로, HTTP에 네이티브 결제 기능을 도입합니다. 이 프로토콜은 오랫동안 예약되어 있던 HTTP 402 “결제 필요(Payment Required)” 상태 코드를 부활시켜, 이를 인터넷을 위한 실용적인 결제 레이어로 전환합니다.

개념은 간단합니다. 클라이언트가 x402 기능을 지원하는 endpoint 에 결제 없이 요청을 보내면, 서버는 402 상태 코드를 반환하며 결제 안내(가격, 허용되는 토큰, 네트워크, 지갑 주소)를 포함합니다. 클라이언트는 USDC 결제 승인서에 서명하여 요청 헤더에 첨부한 후 다시 시도합니다. 서버는 중개자를 통해 결제를 검증하고, 온체인에서 결제를 처리한 뒤 요청된 데이터를 반환합니다.

이는 특히 AI agents 분야에서 큰 의미를 지닙니다. 기존의 결제 시스템은 사람이 직접 가입 절차를 진행하고, 인증 정보를 관리하며, 청구 주기를 처리해야 합니다. x402 는 이러한 모든 과정을 제거합니다. 지갑을 보유한 agent 는 사람의 개입 없이도 API 서비스를 자율적으로 탐색하고, 요금을 지불하며, 서비스를 이용할 수 있습니다.

Quicknode 가 지원하는 이유 x402

Quicknode 80개 이상의 체인과 130개 이상의 네트워크에 걸쳐 개발자와 기업에 블록체인 인프라를 제공합니다. 해당 인프라에 접근하려면 일반적으로 계정을 생성하고 API 키를 관리해야 하며, 이는 실제 운영용 애플리케이션을 구축하는 팀에게 적합합니다.

x402 점차 늘어나는 사용자층, 즉 AI agents, 신속한 프로토타이핑을 하는 사용자, 그리고 계획을 확정하기 전에 테스트를 진행하고자 하는 개발자들을 위한 보완적인 접근 경로를 추가합니다. Quicknode 엔드포인트에서 ‘ x402 ’ 기능이 활성화되면, 지갑을 보유한 누구나(또는 어떤 것이든) 다음을 수행할 수 있습니다:

• 130개 이상의 블록체인 네트워크에 걸쳐 RPC, WebSocket, REST 및 gRPC 엔드포인트에 액세스하세요

• 드로다운 크레딧 모델을 활용한 USDC 기반 요청당 결제 방식입니다. 잔액을 한 번만 충전하면, 요청할 때마다 크레딧에서 자동으로 차감되므로 호출당 결제 지연이 발생하지 않습니다.

• EVM 및 Solana 지갑을 모두 지원하는 지갑 기반 인증(Sign-In with X / SIWx)을 통해 인증합니다.

• devnet USDC를 사용하여 최대 10,000건의 무료 요청으로 시작해 보세요

결제 네트워크는 쿼리 대상 엔드포인트와 분리되어 있습니다. 즉, Base 에서 USDC로 결제하고 Solana 호출을 수행하거나, Solana 에서 USDC로 결제하고 Ethereum 을 쿼리하거나, Polygon 에서 USDC로 결제할 수 있습니다. 결제를 수행하는 체인과 쿼리를 수행하는 체인이 일치할 필요는 없습니다.

x402 Quicknode 의 일반 요금제와 비교

x402 이는 추가적인 서비스입니다. Quicknode 의 표준 요금제를 대체하지 않습니다. 프로덕션 워크로드를 운영하는 팀은 계속해서 표준 SLA 요금제, 전용 지원 서비스 및 더 높은 사용 한도를 이용해야 합니다.

지원되는 결제 네트워크

Quicknode x402 의 구현 버전은 현재 다음 플랫폼에서 USDC 결제를 지원합니다:

• Base (mainnet 및 Sepolia testnet)

• Solana (mainnet 및 devnet)

• Polygon (mainnet 및 Amoy testnet)

추가 결제 네트워크가 활발히 추가되고 있습니다. ‘ x402 ’ 프로토콜은 설계상 체인에 구애받지 않으므로, 새로운 중개자가 참여함에 따라 지원 범위를 확대하는 것은 간단합니다.

테스트를 위해 개발자는 Base 의 Sepolia, Solana 의 개발자 네트워크, 또는 Polygon 의 Amoy에서 devnet USDC를 사용하여 Quicknode 의 모든 운영용 엔드포인트에 대해 최대 10,000건의 무료 요청을 이용할 수 있습니다.

작동 원리: 기술적 측면 Flow

agent 나 개발자가 Quicknode 에 x402 가 활성화된 요청을 보내면 내부적으로 다음과 같은 과정이 진행됩니다:

1. 초기 요청: 클라이언트는 결제 관련 헤더를 포함하지 않은 상태로 Quicknode ,x402 ,endpoint 으로 HTTP 요청을 보냅니다.

2. 402 응답: 서버는 HTTP 402 응답과 함께 결제 세부 정보가 포함된 PAYMENT-REQUIRED 헤더를 반환합니다. 이 헤더에는 요청당 가격, 허용되는 토큰(USDC), 지원되는 네트워크(Base, Solana, Polygon) 및 결제 대상 지갑 주소가 포함됩니다.

3. 지갑 인증: 클라이언트는 SIWx(Sign-In with X)를 사용하여 인증합니다. Quicknode 의 구현은 SIWx를 사용하여 JWT 토큰을 발급하며, 요청마다 발생하는 서명 검증 오버헤드(호출당 10~20ms가 추가됨)를 피함으로써 성능을 최적화합니다.

4. 결제 승인: 클라이언트는 EIP-3009(EVM용) 또는 이에 상응하는 Solana 서명 방식을 사용하여 USDC 이체 승인서에 서명합니다. 이는 클라이언트에게 가스 비용이 발생하지 않는 작업입니다.

5. 결제와 함께 재시도: 클라이언트는 X-PAYMENT 헤더에 서명된 결제 정보를 포함하여 원래 요청을 다시 시도합니다.

6. 검증 및 정산: 진행자는 서명된 승인서를 검증하고, 온체인에서 USDC 이체를 처리한 뒤 결제를 확인합니다.

7. 답변: Quicknode 는 요청된 데이터를 반환합니다.

x402 클라이언트 라이브러리는 2단계부터 6단계까지를 자동으로 처리합니다. 개발자의 관점에서 보면, 이 코드는 표준 HTTP 요청처럼 보입니다.

만들 수 있는 것들

자율적 블록체인 접근 기능을 갖춘 AI 기반 Agents

가장 즉각적인 활용 사례는 사전 설정된 API 키 없이도 AI agents 가 블록체인 데이터와 상호작용할 수 있도록 하는 것입니다. agent 는 다음과 같은 기능을 수행할 수 있습니다:

• 체인 간 토큰 가격 및 포트폴리오 잔액 조회

• 지갑 활동 및 거래 내역 모니터링

• DeFi 프로토콜에 대한 블록체인 읽기 작업 실행

• 분석을 위해 과거 블록 데이터에 접근하기

사람이 먼저 계정을 만들 필요 없이 모두 가능합니다.

AI 기반 인프라 관리를 위한 MCP 서버

Quicknode의 공식 MCP 서버 (@quicknode/mcp)는 Claude 및 Cursor와 같은 AI 어시스턴트에 블록체인 인프라 관리 기능을 직접 통합합니다. MCP 서버를 통해 AI 어시스턴트는 여러 네트워크에 걸쳐 Quicknode 엔드포인트를 설정 및 구성하고, 사용량과 청구 내역을 모니터링하며, 자연어 명령을 통해 인프라를 관리할 수 있습니다. 이는 x402 과 잘 어울립니다. MCP 서버를 사용하여 Quicknode 인프라를 프로비저닝하고 관리하며, x402 을 통해 지갑 인증 방식의 경량 endpoint 액세스를 이용할 수 있습니다.

npx를 통해 설치하기:

npx -y @quicknode/mcp

npm에서 해당 패키지를 확인해 보세요: npmjs.com/package/@quicknode/mcp

AI 코딩을 위한 블록체인 기술 Agents

Quicknode 또한 ‘Blockchain Skills’라는 경량 참조 패키지를 제공하며, 이 패키지는 AI 코딩 agents 에 Quicknode 제품군 전체에 대한 정확하고 최신 정보를 제공합니다. 다음 명령어 하나만 입력하면 Claude Code, Cursor, Codex, Windsurf 또는 스킬 호환이 가능한 agent 에 이 패키지를 추가할 수 있습니다:

npx skills add quicknode-labs/blockchain-skills

약 240개의 토큰으로 구성되어 있어, 컨텍스트 창을 불필요하게 복잡하게 만들지 않으면서도 ‘ agent ’에 올바른 엔드포인트, 정확한 매개변수, 그리고 최신 모범 사례를 제공합니다 . github.com/quicknode-labs/blockchain-skills에서 완전한 오픈 소스로 공개되어 있습니다. skills.sh/quicknode-labs/blockchain-skills의 스킬 레지스트리에서 확인해 보세요 .

요청당 과금 방식의 개발 및 프로토타이핑

여러 체인에서 아이디어를 테스트하고자 하는 개발자는 x402 을 통해 Quicknode 에서 지원하는 모든 네트워크에 요금제 가입 없이도 접속할 수 있습니다. 프로토타입을 구축하고, 실제로 수행한 RPC 호출에 대해 USDC로 몇 센트만 지불한 뒤 다음 단계로 넘어가면 됩니다.

Quicknode Admin API 는 계정 및 인프라 구성에 대한 포괄적인 프로그래매틱 제어 기능을 제공하여, 와 개발자가 간단한 REST 호출을 통해 엔드포인트를 생성하고, 보안을 관리하며, 사용량을 모니터링할 수 있도록 합니다. agents

HyperCore CLI (다음과 함께) x402

Quicknode의 오픈소스 HyperCore CLI 도구는 x402 의 요청당 과금 방식도 지원합니다. 개발자들은 Quicknode 계정이 없어도 지갑을 통해 요청당 요금을 지불함으로써, 터미널에서 직접 Hyperliquid 데이터 세트(거래, 주문, 체결, TWAP, 호가장 업데이트, 이벤트, 블록)를 스트리밍하고 백필할 수 있습니다.

전역적으로 설치하려면:

npm install -g @quicknode/hypercore-cli

CLI는 WebSocket 및 gRPC 을 통한 실시간 스트리밍, 간격 복구를 지원하는 자동 재연결, 이력 데이터 보충, 그리고 JSON, CSV 또는 SQLite로의 출력 기능을 지원합니다.

콘텐츠 및 API 수익화

개발자는 x402 에서 제공하는 서비스를 이용하는 것 외에도, Quicknode 의 오픈소스 툴을 활용하여 x402 기반의 자체 API를 구축할 수도 있습니다:

• x402-rails: Rails 애플리케이션에 x402 결제 장벽을 추가하기 위한 Ruby 젬

• x402-결제: 서명된 결제 헤더를 생성하는 Ruby 젬

• qn-x402-examples: EVM 및 Solana 결제 흐름에 대한 구현 예시

@quicknode/x402 및 @quicknode/x402-solana npm 패키지

그 @quicknode/x402 npm 패키지는 Quicknode 의 x402 게이트웨이와 연동하는 데 권장되는 방법입니다. 이 패키지는 전체 인증 및 결제 프로세스( flow )를 단일 설치로 통합하여, SIWX 지갑 인증, JWT 세션 관리, x402 결제 처리를 모두 지원합니다.

이전에는 Quicknode 에서 x402 와 연동하려면 SIWX 서명, JWT 토큰 수명 주기, 결제 헤더 생성을 수동으로 처리해야 했습니다. 이 패키지는 이러한 모든 과정을 추상화합니다. Agents 및 개발자들은 이 패키지를 설치하고 지갑을 연결한 후, 단 몇 분 만에 인증된 유료 요청을 시작할 수 있습니다.

npm i @quicknode/x402

이 패키지는 EVM 및 Solana 지갑을 모두 지원하며, 지원되는 모든 결제 네트워크(Base, Solana, Polygon)에서 작동합니다.

@quicknode/x402 npm에서: npmjs.com/package/@quicknode/x402

출처: github.com/quicknode-labs/quicknode-x402

Solana 사용자분들께: 그 @quicknode/x402-solana npm 래핑 @quicknode-x402 그리고 다음을 사용할 수 있는 기능을 추가합니다. Solana 키트 Quicknode 의 RPC 서비스를 즉시 이용할 수 있습니다.

@quicknode/x402-solana npm에서: npmjs.com/package/@quicknode/x402-solana

출처: github.com/quicknode-labs/x402-solana

그 Admin API

Quicknode Admin API 는 개발자와 에 엔드포인트 생성 및 보안 구성부터 사용량 모니터링 및 팀 관리에 이르기까지, 계정 및 인프라 운영 전반에 대한 완전한 프로그래매틱 제어 기능을 제공하며, 이 모든 작업은 표준 REST 호출을 통해 수행됩니다. 및 MCP 서버와 결합되면, 는 블록체인 데이터를 조회할 뿐만 아니라, 이에 필요한 인프라를 프로비저닝하고 관리할 수도 있습니다. agents x402 agent

시작하기

선행 조건

• 암호화폐 지갑(EVM 호환 지갑 또는 Solana 지갑)

• Base, Polygon 또는 Solana 에서 USDC를 이용하실 수 있습니다(무료 테스트를 원하시면 devnet USDC를 이용하세요).

• Node.js 18 이상 및 @quicknode/x402 패키지 (npm i @quicknode/x402)

Devnet USDC 빠른 시작 가이드 (무료)

테스트를 위해 devnet USDC를 사용하여 최대 10,000건의 무료 요청을 수행할 수 있습니다:

1. Circle USDC 페이크트에서 Base Sepolia USDC를 받아보세요

2. 또는 Solana 페이크트에서 Solana 개발자 네트워크(devnet) USDC를 받으세요.

3. 아니면 Circle USDC 페이크트에서 Polygon Amoy USDC를 받아보세요.

4. '시작하기' 가이드를 따르세요

제작 준비

실제 USDC를 사용한 프로덕션 환경에서는 다음과 같이 하십시오:

1. Base, Solana 또는 다음 사이트에서 USDC로 지갑에 자금을 충전하세요. Polygon

2. @quicknode/x402 패키지를 설치하세요 (npm i @quicknode/x402)

3. 요청은 다음으로 보내주십시오. Quicknode x402 endpoint

요청당 지불 금액이 미미하기 때문에, 대량의 agent 워크로드와 개발 테스트 모두에 적합합니다.

오픈 소스와 생태계

Quicknode 자사 엔드포인트에서 결제를 가능하게 하는 것을 넘어, x402 생태계에 막대한 투자를 해왔습니다:

• x402 Explorer: x402 결제 흐름을 테스트하기 위한 샘플 앱

• x402 비디오 유료화 데모: 다음을 사용하여 비디오 콘텐츠에 페이월을 적용하는 방법을 보여주는 예시 x402

• x402 Rails 통합: Ruby on Rails API에 x402 를 추가하는 가이드

• x402 페이월 가이드: 구현 방법에 대한 포괄적인 안내 x402

• llms.txt: LLM 및 agent 의 검색 가능성을 위한 기계 가독형 문서입니다. 프로토콜 자체는 오픈 소스이며, Coinbase에서 github.com/coinbase/에서 관리하고 있습니다. x402

• @quicknode/x402 패키지: npmjs.com/package/@quicknode/x402

자주 묻는 질문

Quicknode 의 ‘ x402 ’이란 무엇인가요?

x402 Quicknode 의 이 기능은 USDC를 사용하여 엔드포인트(RPC, WebSocket, REST 및 )에 지갑 인증을 거친 후 요청당 결제 방식으로 접근할 수 있게 해주는 알파 단계 기능입니다. 이 기능은 HTTP 402 Payment Required 표준을 사용하며, Coinbase의 공개 프로토콜인 을 기반으로 구축되었습니다. Quicknode gRPC x402

x402 는 Quicknode 계정이나 요금제를 대체하나요?

x402 는 추가적인 서비스입니다. 이 서비스는 Quicknode 의 표준 요금제와 함께 상호 보완적인 이용 경로를 제공합니다. 프로덕션 워크로드를 운영하는 팀은 SLA, 전용 지원 및 더 높은 사용 한도를 위해 표준 요금제를 계속 사용해야 합니다. x402 는 AI agents, 신속한 프로토타이핑 및 허가 없이도 이용할 수 있는 서비스를 위해 설계되었습니다.

x402 를 사용하려면 Quicknode 계정이 필요한가요?

x402 에 접속하려면 지갑 인증이 필요합니다. Quicknode 계정이나 API 키가 아닌, 암호화폐 지갑과 USDC가 필요합니다.

어떤 결제 네트워크를 지원하나요?

현재 USDC 결제는 Base (mainnet 및 Sepolia testnet), Solana (mainnet 및 devnet), Polygon (mainnet 및 Amoy testnet)에서 지원됩니다. 추가 결제 네트워크가 지속적으로 추가되고 있습니다. 결제 네트워크는 쿼리하는 체인과 일치할 필요가 없습니다.

AI agents 가 x402 를 자율적으로 사용할 수 있을까요?

네. ‘ x402 ’는 자율적인 agent 접속을 위해 설계되었습니다. 자금이 충전된 지갑을 보유한 agent 는 사람의 개입 없이도 Quicknode 엔드포인트를 검색하고, 인증하며, 요금을 지불하고, 서비스를 이용할 수 있습니다.

x402 는 실제 운영 환경에 적용할 수 있을까요?

x402 Quicknode 의 해당 서비스는 현재 알파 단계에 있습니다. 기능은 정상적으로 작동하며 사용이 가능하지만, 표준 요금제와 동일한 SLA 보장은 제공되지 않습니다. 가동 시간 보장 및 전담 지원이 필요한 프로덕션 워크로드의 경우, 표준 요금제를 이용하시기 바랍니다. Quicknode Quicknode

요청 한 건당 비용은 얼마인가요?

요청당 과금 방식의 요금은 최소한이며 USDC로 책정됩니다. 개발자는 devnet USDC를 사용하여 무료로 테스트할 수 있으며, 이를 통해 프로덕션 RPC 엔드포인트에 대해 최대 10,000건의 무료 요청을 이용할 수 있습니다.

인증에 어떤 지갑이 지원되나요?

EVM 호환 지갑 또는 Solana 지갑이라면 무엇이든 가능합니다. 인증에는 SIWx(Sign-In with X)가 사용되며, 이는 EVM 및 Solana 지갑 서명을 모두 지원합니다.

기술 요약

자료

• 안내: x402 Payments를 통해 Quicknode 엔드포인트에 액세스하기

• 예시: github.com/quicknode-labs/qn-guide-examples

• 동영상 안내: x402 를 시작하는 방법 Quicknode

• x402 프로토콜 설명: x402 결제 프로토콜이란 무엇인가요?

• 샘플 앱: Quicknode 샘플 앱 라이브러리

• HyperCore CLI: npmjs.com/package/@quicknode/hypercore-cli

• llms.txt: x402.quicknode.com/llms.txt

• x402 생태계: x402.org/ecosystem

• MCP 서버: npmjs.com/package/@quicknode/mcp

• 블록체인 기술: github.com/quicknode-labs/blockchain-skills

• @quicknode/x402 패키지: npmjs.com/package/@quicknode/x402

• Quicknode Admin API: https://www.quicknode.com/admin-api

Quicknode 80개 이상의 체인과 130개 이상의 네트워크를 아우르며 개발자와 기업에 블록체인 인프라를 제공합니다. 표준 요금제로 시작하거나, ‘ x402 ’의 요청당 과금 방식(pay-per-request)을 통해 즉시 엔드포인트에 접속해 보세요.