Skip to main content

Documentation Index

Fetch the complete documentation index at: https://daehan-base.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

x402는 트레이딩 데이터에 매우 적합합니다: 에이전트가 USDC로 호출별 결제를 처리하며 API 키 등록, 구독 관리, 속도 제한 티어 협상이 필요하지 않습니다. 에이전트가 데이터를 받고, 공급자가 결제를 받습니다 — 이것이 전부입니다.

​
모의 데모

​
시장 데이터에 x402를 사용하는 이유

  • API 키 관리 불필요 — 에이전트가 온디맨드로 결제; 교체하거나 안전하게 저장할 자격증명 없음
  • 사용한 만큼만 결제 — 항상 필요하지 않을 수 있는 데이터에 대한 월 구독 없음
  • 모든 지갑에서 작동 — Sponge Wallet의 x402 프록시, CDP Agentic Wallet 스킬, x402-axios 모두 결제를 자동으로 처리
  • 구성 가능 — 에이전트가 동일한 세션에서 여러 데이터 공급자를 호출하고 각각 별도로 결제 가능

​
x402 호환 엔드포인트 검색

x402 호환 서비스는 /.well-known/x402.json에 검색 문서를 게시합니다. Bazaar 카탈로그에서 x402 데이터 공급자의 큐레이션 목록을 탐색할 수도 있습니다.
search-for-service 스킬로 x402 Bazaar를 검색합니다:
Terminal
npx awal@latest x402 bazaar search "price feed"
이용 가능한 모든 리소스를 탐색하려면:
Terminal
npx awal@latest x402 bazaar list --network base

​
x402 데이터 소스 예시

​
CoinGecko — 가격 피드

CoinGecko는 x402 지원 엔드포인트를 통해 암호화폐 가격 피드, 시가 총액 데이터, 역사적 OHLCV를 제공합니다. 현재 ETH 가격 조회:
pay-for-service 스킬을 사용합니다:
Terminal
npx awal@latest x402 pay "https://api.coingecko.com/api/v3/simple/price?ids=ethereum&vs_currencies=usd"

​
Alchemy — 온체인 데이터

Alchemy는 https://x402.alchemy.com의 Agentic Gateway를 통해 온체인 데이터를 위한 향상된 API를 제공합니다 — 토큰 잔액, NFT 메타데이터, 멤풀 가시성, 디코딩된 트랜잭션 기록.
Alchemy의 x402 게이트웨이는 자체 @alchemy/x402 CLI를 통한 SIWE 지갑 인증을 사용합니다 — 일반 x402 bazaar 엔드포인트가 아닙니다. 요청하기 전에 아래 설정 단계를 따르세요.
1단계 — 지갑 설치 및 설정:
Terminal
npx @alchemy/x402 wallet generate
2단계 — SIWE 인증 토큰 생성:
Terminal
npx @alchemy/x402 sign --private-key ./wallet-key.txt > siwe-token.txt
3단계 — Base에서 토큰 잔액 조회:
Terminal
TOKEN=$(cat siwe-token.txt)

curl -s -X POST "https://x402.alchemy.com/base-mainnet/v2" \
  -H "Content-Type: application/json" \
  -H "Authorization: SIWE $TOKEN" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "alchemy_getTokenBalances",
    "params": ["0xYourAddress"]
  }'
게이트웨이가 402를 반환하면 CLI로 결제를 처리하고 재시도합니다:
Terminal
PAYMENT_SIG=$(npx @alchemy/x402 pay --private-key ./wallet-key.txt --payment-required "$PAYMENT_REQUIRED")
지갑 부트스트랩, 결제 처리, SDK 통합에 대한 전체 내용은 Alchemy Agentic Gateway 스킬을 참조하세요.

​
OpenClaw 에이전트에서 데이터 호출

Sponge Wallet 스킬 또는 CDP Agentic Wallet 스킬을 설치한 다음 에이전트에게 직접 프롬프트합니다: 
Get the current prices of ETH, BTC, and SOL from a paid data source

Check the token balances at 0xYourWatchAddress on Base
에이전트가 서비스 검색, 결제, 데이터 추출을 처리합니다. x402-axios를 사용한 커스텀 구현의 경우:
Terminal
npm install x402-axios axios
TypeScript
import { withPaymentInterceptor } from "x402-axios";
import axios from "axios";

// walletClient는 viem 호환 WalletClient여야 합니다
const client = withPaymentInterceptor(axios.create(), walletClient);

// 엔드포인트가 402를 반환하면 인터셉터가 자동으로 결제하고 재시도합니다
const response = await client.get("https://api.coingecko.com/api/v3/simple/price?ids=ethereum&vs_currencies=usd");
console.log(response.data);
인터셉터가 전체 402 → 결제 → 재시도 흐름을 처리합니다. viem WalletClient를 설정에 연결하는 방법은 x402 클라이언트 문서를 참조하세요.

​
관련 항목

트레이드 실행

Flashblocks 타이밍과 Base 수수료 조정을 사용한 스왑 실행입니다.

x402 프로토콜

전체 x402 흐름, 지원 네트워크, 오류 처리입니다.