AI 에이전트가 자율적으로 결제할 수 있는 53개의 호출당 결제 (pay-per-call) API 구축 (x402 + Base 상의 USDC)
요약
AI 에이전트가 계정 생성이나 카드 입력 없이도 자율적으로 API 비용을 지불할 수 있도록 x402 프로토콜과 USDC를 활용한 pay-per-call API 팜을 구축했습니다. 웹 툴링, 기업 데이터, 재무 정보 등 53개의 엔드포인트를 제공하며 에이전트의 데이터 접근 마찰을 최소화합니다.
핵심 포인트
- x402 프로토콜을 통해 402 Payment Required 응답 시 온체인 USDC로 즉시 결제 가능
- 계정 생성, API 키 관리, 신용카드 입력 등 인간 중심의 인증 절차 제거
- 웹 추출, 프랑스/영국 기업 데이터, 미국 상장사 재무 정보 등 53개 API 제공
- Base 네트워크를 활용하여 가스비 부담 없이 에이전트가 직접 비용 지불
AI 에이전트들은 자신들에게 필요한 데이터가 무엇인지 결정하는 데 점점 능숙해지고 있습니다. 하지만 데이터를 얻기 위한 인간 중심의 서류 작업에는 서툽니다. 계정 생성, 이메일 확인 클릭, API 키 붙여넣기, 신용카드 입력 등이 바로 그것입니다. 이 모든 과정은 자율 에이전트가 스스로 넘을 수 없는 벽입니다.
x402는 그 벽을 제거합니다. 이것은 개방형 결제 프로토콜입니다. 서버가 402 Payment Required로 응답하면, 클라이언트는 온체인(on-chain) 상에서 몇 센트의 USDC를 결제하고, 요청이 통과됩니다. 계정도, 키도, 인간도 필요 없습니다. 그래서 저는 정확히 그런 방식으로 소비되도록 설계된 API 팜(farm)을 구축했습니다.
포함된 내용
Base URL: https://api.x-402.online/ — 루트(root)는 기계가 읽을 수 있는 JSON 카탈로그를 반환하며, 에이전트를 위한 /openapi.json 및 /llms.txt가 제공됩니다.
53개의 엔드포인트(endpoints)가 있으며, 모두 Base(Polygon 및 Arbitrum도 허용)에서 결제되는 USDC 기반의 호출당 결제(pay-per-call) 방식입니다 (최소 $0.005부터):
- 웹 툴링 (Web tooling) — 깔끔한 마크다운(markdown) 추출, JS 렌더링된 HTML, 스크린샷, PDF, 링크/메타데이터 추출
- 프랑스 기업 및 오픈 데이터 (French business & open data) — 기업 조회 (SIREN/SIRET), 전체 KYB 서류, 재무 점수, 부동산 AVM(자동 가치 산정 모델) 및 투자 스코어카드, BODACC, 지적도(cadastre), DVF 판매 가격, 지오코딩(geocoding), 날씨, 공휴일, IBAN 검증 등
- 영국 기업 데이터 (UK company data) — Companies House 프로필, 임원, PSC/실소유자, 단일 호출 KYB 판정
- 미국 상장 기업 (US public companies) — SEC EDGAR 프로필, 연간 재무제표, 공시 자료, 단일 호출 재무 스냅샷
마찰(friction) 자체가 곧 가치입니다. 이 API들은 가입, 키, 또는 복잡한 파싱(XBRL, 등록부 등)이 필요한 소스들을 감싸서, 하나의 깔끔하고 결제 가능한 호출로 노출합니다.
에이전트의 사용 방식
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";
...
에이전트의 지갑에는 Base 상의 USDC만 있으면 됩니다. 클라이언트 측에서는 가스(gas) 비용이 필요하지 않습니다. 중개자(facilitator)가 결제를 처리하기 때문입니다.
현재 라이브 상태이며 이미 결제가 이루어지고 있습니다.
실제 온체인 결제(on-chain payments)가 오늘 진행되고 있습니다 (BaseScan에서 확인 가능). 계정이나 키를 관리하는 번거로운 과정 없이 기업 데이터, 웹 추출(web extraction), 또는 오픈 데이터 조회(open-data lookups)가 필요한 에이전트를 구축하고 있다면, https://api.x-402.online/로 연결하여 에이전트가 스스로 비용을 지불하게 하세요.
피드백을 환영합니다 — 에이전트들이 실제로 요청하는 엔드포인트(endpoints)를 기꺼이 추가하겠습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기