واجهة REST + MCP API مصممة للوكلاء المستقلين. أنشئ حسابًا، اشحنه بالعملات المشفرة، وأصدر بطاقات في 4 استدعاءات — بدون أي تدخل بشري، بدون KYC، مع scopes وحدود معدل كاملة لكل مفتاح.
النقاط الطرفية أدناه هي الأساس — الأنماط هي ما يطلقه مطورو الوكلاء فعليًا.
وكلاء يقررون ما يشترونه وينفذون عملية الشراء دون موافقة بشرية. تُصدر الـAPI بطاقة جديدة لكل معاملة، تخصمها، ثم تحذفها — دون ترك أي سطح دفع قابل لإعادة الاستخدام.
إصدار برمجي لبطاقة BIN-471938 (Visa Business) واحدة لكل حساب إعلاني على Meta أو Google أو TikTok. قم بتدوير البطاقات كل 30-60 يومًا للحفاظ على نظافة الحسابات.
الأسواق أو المنصات التي تحتاج إلى بطاقة فريدة لكل معاملة مستخدم نهائي. أصدر، اخصم، احذف في أقل من 10 ثوانٍ — بدون نطاق PCI، بدون عبء تخزين البطاقات.
سجّل في التجارب المجانية على نطاق واسع. تحصل كل تجربة على بطاقة بالحد الأدنى من الشحن؛ حذف البطاقة قبل التجديد يحجب الخصم التلقائي بشكل نظيف.
وكلاء متعددو المستأجرين يفوترون خدمات SaaS الخارجية (AWS، OpenAI، Cloudflare، GitHub) ببطاقة لكل مساحة عمل. تصبح التكاليف قابلة للنسب إلى العميل دون كشف هوية الفوترة الرئيسية.
يطلب كل عامل بطاقة عبر الـAPI لحظة احتياجه إلى سطح دفع، يستخدمها للإجراء المقصود، ثم يغلقها. تكلفة الوحدة 1.50 دولار جزء يسير من أي بديل آخر.
أربعة استدعاءات API تنقل الوكيل من «لا يوجد حساب» إلى «بطاقة جاهزة للخصم». استبدل TOKEN بـbearer الخاص بك، وCARD_ID بالعدد الصحيح المُرجَع في الخطوة 3.
/.well-known/openapi.json
AI plugin manifest /.well-known/ai-plugin.json
MCP endpoint POST /api/v1/mcp
# Create an anonymous account. Returns seed + Bearer token (ONE TIME). curl -X POST https://cryptotopcard.com/api/v1/auth/signup \ -H "Content-Type: application/json" \ -d '{"name":"my-agent"}'
# Create a top-up: request $100 net in USDT (TRC-20). # Returns the deposit address + exact crypto amount (gross, includes 2% fee). curl -X POST https://cryptotopcard.com/api/v1/topups \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{"coin":"USDTTRC","amount":100}' # {... "deposit_address":"T...", "crypto_amount":"102.92", "net_credit_usd":100}
# Once the balance shows the credited amount, issue a card. curl -X POST https://cryptotopcard.com/api/v1/cards \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{"bin_id":"471938","amount":150,"label":"meta-acct-7"}' # {... "card_number":"4719 ...", "card_exp":"02/29", "card_cvv":"136"}
# When the card has served its purpose, delete it. Remaining balance refunds instantly. curl -X DELETE https://cryptotopcard.com/api/v1/cards/$CARD_ID \ -H "Authorization: Bearer $TOKEN"
نفس Bearer tokens تعمل على نقطة نهاية MCP عند /api/v1/mcp. بمجرد التهيئة، يستدعي نموذج LLM `list_bins` و`create_topup` و`issue_card` و`freeze_card` كأدوات أصلية — دون الحاجة إلى تغليف الكود.
أضف إلى ~/Library/Application Support/Claude/claude_desktop_config.json تحت mcpServers:
"cryptotopcard": {
"command": "npx",
"args": ["-y", "mcp-remote",
"https://cryptotopcard.com/api/v1/mcp",
"--header", "Authorization:Bearer ctk_live_..."]
}
في إعدادات GPT المخصص، أضف Action واستورد مواصفات OpenAPI:
Import OpenAPI from:
https://cryptotopcard.com/.well-known/openapi.json
Auth: API Key (Bearer)
في إعدادات Cursor → Features → Model Context Protocol، أضف خادمًا جديدًا بنقل HTTP:
HTTP transport:
url: https://cryptotopcard.com/api/v1/mcp
authorization: Bearer ctk_live_...
بعد الاتصال، اطلب من النموذج «أصدر بطاقة Visa Business بقيمة 200 دولار ممولة بـUSDT» وسيقوم بسلسلة `list_bins → list_coins → create_topup → issue_card` تلقائيًا، عارضًا عنوان الإيداع ومنتظرًا تأكيدك.
تسعة عشر مسارًا في المجموع. النقاط العامة (بدون مصادقة) للاكتشاف والتسجيل؛ كل ما عداها يتطلب Bearer token مع scope مناسب للعملية.
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/coins | اسرد العملات المشفرة المدعومة الـ20 (عام). |
| GET | /api/v1/bins | اسرد فئات BIN السبع + الرسوم (عام). |
| POST | /api/v1/auth/signup | أنشئ حسابًا مجهولًا. يُرجع seed + أول API token (لمرة واحدة). |
| POST | /api/v1/auth/login | استبدل عبارة seed بـAPI token جديد. |
| GET | /api/v1/me | معلومات الحساب الحالية: الرصيد، عدد البطاقات، scopes. |
| POST | /api/v1/topups | أنشئ فاتورة إيداع بالعملة المشفرة. يدفع العميل المبلغ الإجمالي (شامل رسوم 2%)، ويُضاف الصافي إلى الرصيد. |
| GET | /api/v1/topups/:id | احصل على الحالة الحالية لعملية شحن. |
| POST | /api/v1/topups/:id/cancel | ألغِ عملية شحن قيد الانتظار (لا تأثير بعد الدفع). |
| GET | /api/v1/cards | اسرد البطاقات النشطة والمجمدة (آخر 4 أرقام فقط). |
| POST | /api/v1/cards | أصدر بطاقة جديدة. يخصم 1.50 دولار + المبلغ من الرصيد. |
| GET | /api/v1/cards/:id | تفاصيل البطاقة الكاملة (PAN، تاريخ الانتهاء، CVV) لبطاقة واحدة. |
| POST | /api/v1/cards/:id/freeze | احجب جميع الخصومات على البطاقة. قابل للعكس. |
| POST | /api/v1/cards/:id/unfreeze | أعد تفعيل بطاقة مجمدة. |
| POST | /api/v1/cards/:id/topup | انقل الأموال من رصيد الحساب إلى رصيد البطاقة. |
| DELETE | /api/v1/cards/:id | أغلق بطاقة. يُسترد الرصيد المتبقي إلى الحساب فورًا. |
| GET | /api/v1/keys | اسرد مفاتيح API للمتصل (البيانات الوصفية فقط، بدون token). |
| POST | /api/v1/keys | أنشئ مفتاح API جديدًا. يُرجع الـtoken مرة واحدة. |
| DELETE | /api/v1/keys/:id | إلغِ مفتاح API. |
| POST | /api/v1/mcp | خادم MCP (JSON-RPC 2.0). نفس مصادقة Bearer. |
كل طلب يُصادق عليه بـBearer token لكل مستخدم (ctk_live_…). تُخزَّن الـtokens مُجزَّأة بـsha256 في حالة السكون؛ لا نخزّن القيمة الخام أبدًا. يحمل كل token قائمة scope مفصولة بفواصل (read، topups، cards) — لا يمكن لـtoken بدون «cards» إصدار بطاقة.
ثلاثة scopes متاحة. الافتراضي للـtokens الجديدة هو read,topups,cards — أسقط scopes عند إنشاء token (POST /keys with scopes: "read") لتقليل نصف قطر الانفجار.
read — نقاط GET (معلومات الحساب، سرد البطاقات، سرد عمليات الشحن).topups — POST /topups، /topups/:id/cancel.cards — POST /cards، /cards/:id/freeze، /cards/:id/unfreeze، /cards/:id/topup، DELETE /cards/:id، GET /cards/:id (حساس).لا يوجد استرداد قائم على البريد الإلكتروني. عبارة seed المُرجَعة عند التسجيل هي بيانات الاعتماد الوحيدة — إن فُقدت، فإن الحساب ورصيده غير قابلين للاسترداد. احتفظ بها في مدير أسرار. قم بتدوير tokens الـAPI بحرية عبر POST /keys.
النقاط العامة تعمل دون حساب. التسجيل يستغرق POST واحدة. جرّب البداية السريعة من النهاية إلى النهاية قبل التكامل.
اقرأ البداية السريعة