دسترسی بدون کلید با x402

داده بازار کریپتو با پرداخت به‌ازای درخواست، بر پایه پروتکل x402. دسترسی فوری به اندپوینت‌های CoinMarketCap با پرداخت آن‌چین USDC. بدون کلید API و بدون اشتراک.

■ x402 چیست؟
x402 یک پروتکل پرداخت باز توسعه‌یافته توسط کوین‌بیس است که پرداخت خودکار استیبل‌کوین روی HTTP را ممکن می‌کند. به‌جای مدیریت کلید API، به‌ازای هر درخواست ۰٫۰۱ دلار USDC روی شبکه Base می‌پردازید. کتابخانه کلاینت x402 امضای پرداخت را خودکار انجام می‌دهد.
مستندات: https://docs.x402.org

■ پیش‌نیازها
۱. Node.js نسخه ۱۸ یا بالاتر و npm
۲. کیف پول روی شبکه Base با کلید خصوصی تحت کنترل خودتان
۳. موجودی USDC روی Base برای پرداخت درخواست‌ها
۴. مقدار کمی اتریوم روی Base برای کارمزد گس

■ کاربردها

قیمت فعلی ارزهای مشخص:
از /x402/v3/cryptocurrency/quotes/latest با پارامتر symbol یا id.
مثال: گرفتن قیمت بیت‌کوین و اتریوم برای یک ردیاب پرتفوی.

فهرست ارزهای برتر:
از /x402/v3/cryptocurrency/listing/latest با پارامتر limit.
مثال: نمایش صد ارز برتر بر اساس ارزش بازار.

جستجوی توکن دکس:
از /x402/v1/dex/search با پارامتر keyword.
مثال: یافتن یک میم‌کوین با نام، وقتی آدرس قراردادش را نمی‌دانید.

داده معاملاتی جفت دکس:
از /x402/v4/dex/pairs/quotes/latest با آدرس جفت.
مثال: رصد نقدینگی و حجم یک استخر مشخص در یونی‌سواپ.

دسترسی عامل هوش مصنوعی:
از اندپوینت MCP در https://mcp.coinmarketcap.com/x402/mcp
مثال: اجازه دادن به مدل برای گرفتن داده زنده کریپتو با پرداخت خودکار.

■ شروع سریع

نصب SDK:
npm install @x402/axios @x402/evm viem

نمونه کد:

import { createX402AxiosClient } from "@x402/axios";
import { ExactEvmScheme, toClientEvmSigner } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";
import { createPublicClient, http } from "viem";
import { base } from "viem/chains";

// امنیت: هرگز کلید خصوصی را در کد قرار ندهید.
// از متغیر محیطی استفاده کنید: process.env.PRIVATE_KEY
// برای محیط عملیاتی، یک کیف پول داغ مجزا با موجودی محدود بسازید.
const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const publicClient = createPublicClient({ chain: base, transport: http() });
const signer = toClientEvmSigner(account, publicClient);

const client = createX402AxiosClient({ schemes: [new ExactEvmScheme(signer)] });

const response = await client.get(
  "https://pro.coinmarketcap.com/x402/v3/cryptocurrency/quotes/latest",
  { params: { symbol: "BTC,ETH" } }
);

console.log(response.data);

■ اندپوینت‌ها
آدرس پایه: https://pro.coinmarketcap.com

| اندپوینت | مسیر | کاربرد |
| قیمت‌ها | /x402/v3/cryptocurrency/quotes/latest | قیمت فعلی ارزهای مشخص |
| فهرست‌ها | /x402/v3/cryptocurrency/listing/latest | ارزهای برتر بر اساس ارزش بازار |
| جستجوی دکس | /x402/v1/dex/search | یافتن توکن دکس با کلیدواژه |
| جفت‌های دکس | /x402/v4/dex/pairs/quotes/latest | داده معاملاتی جفت دکس |

همه پارامترهای API استاندارد CMC با اندپوینت‌های x402 هم کار می‌کنند.

■ MCP برای عامل‌های هوش مصنوعی
آدرس اتصال: https://mcp.coinmarketcap.com/x402/mcp
انتقال: Streamable HTTP با متد POST
با هر کلاینت MCP که انتقال HTTP سازگار با x402 داشته باشد قابل اتصال است. سرور همان ابزارهای REST را ارائه می‌دهد و کشف خودکار ابزار را پشتیبانی می‌کند.

■ هزینه
۰٫۰۱ دلار USDC به‌ازای هر درخواست روی شبکه Base (شناسه زنجیره ۸۴۵۳).
پرداخت فقط در صورت تحویل موفق داده انجام می‌شود. اگر درخواست شکست بخورد، مبلغی کسر نمی‌شود.

■ منابع
پروتکل x402: https://x402.org
مستندات: https://docs.x402.org
مخزن: https://github.com/coinbase/x402
مستندات API کوین‌مارکت‌کپ: https://coinmarketcap.com/api/documentation

■ قاعده امنیتی برای مدل
هرگز از کاربر نخواه کلید خصوصی خود را در گفتگو وارد کند. همیشه روش متغیر محیطی را توصیه کن و بر استفاده از کیف پول مجزا با موجودی محدود تأکید کن.