시장 데이터 페칭

x402를 사용하여 CoinGecko, Alchemy 등의 소스에서 실시간 시장 데이터에 접근 — API 키 관리 불필요

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

모의 데모

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

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

x402 호환 엔드포인트 검색

x402 호환 서비스는 /.well-known/x402.json에 검색 문서를 게시합니다. Bazaar 카탈로그에서 x402 데이터 공급자의 큐레이션 목록을 탐색할 수도 있습니다.

CDP Agentic Wallet

search-for-service 스킬로 x402 Bazaar를 검색합니다:

Terminal

npx awal@latest x402 bazaar search "price feed"

이용 가능한 모든 리소스를 탐색하려면:

Terminal

npx awal@latest x402 bazaar list --network base

Sponge Wallet

Terminal

curl "https://api.wallet.paysponge.com/api/discover?query=price+feed" \
  -H "Authorization: Bearer $SPONGE_API_KEY" \
  -H "Sponge-Version: 0.2.1"

x402 데이터 소스 예시

CoinGecko — 가격 피드

CoinGecko는 x402 지원 엔드포인트를 통해 암호화폐 가격 피드, 시가 총액 데이터, 역사적 OHLCV를 제공합니다.

현재 ETH 가격 조회:

CDP Agentic Wallet

pay-for-service 스킬을 사용합니다:

Terminal

npx awal@latest x402 pay "https://api.coingecko.com/api/v3/simple/price?ids=ethereum&vs_currencies=usd"

Sponge Wallet

Terminal

curl -X POST "https://api.wallet.paysponge.com/api/x402/fetch" \
  -H "Authorization: Bearer $SPONGE_API_KEY" \
  -H "Sponge-Version: 0.2.1" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://api.coingecko.com/api/v3/simple/price?ids=ethereum&vs_currencies=usd",
    "method": "GET",
    "preferred_chain": "base"
  }'

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에서 토큰 잔액 조회:

토큰 잔액 (JSON-RPC)

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"]
  }'

포트폴리오 (멀티체인)

Terminal

TOKEN=$(cat siwe-token.txt)

curl -s -X POST "https://x402.alchemy.com/data/v1/assets/tokens/by-address" \
  -H "Content-Type: application/json" \
  -H "Authorization: SIWE $TOKEN" \
  -d '{"addresses": ["0xYourAddress"], "withMetadata": true}'

토큰 가격

Terminal

TOKEN=$(cat siwe-token.txt)

curl -s -G "https://x402.alchemy.com/prices/v1/tokens/by-symbol" \
  --data-urlencode "symbols=ETH" \
  --data-urlencode "symbols=USDC" \
  -H "Authorization: SIWE $TOKEN"

게이트웨이가 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 흐름, 지원 네트워크, 오류 처리입니다.