تخطي إلى المحتوى
POST AI agent ready /v1/exchange/search

Crypto Search API - ابحث عن العملات المعدنية بالاسم أو الرمز

يبحث في سجل العملات المشفرة عن العملات المعدنية التي تطابق استعلامك. إرجاع معرف العملة (المستخدم في نقاط النهاية الأخرى)، والاسم الكامل، ورمز المؤشر، ورتبة القيمة السوقية. مثالية لبناء مدخلات الإكمال التلقائي، ومنتقي العملات، وواجهات مستخدم التشفير المبنية على البحث.

Parameters

stringrequired

Search query matching coin name or ticker symbol.

Code examples

curl -X POST https://api.botoi.com/v1/exchange/search \
  -H "Content-Type: application/json" \
  -d '{"query":"ethereum"}'

When to use this API

منتقي العملات الإكمال التلقائي في واجهات المستخدم التجارية

أثناء قيام المستخدم بالكتابة في حقل بحث العملة، قم بالاستعلام عن نقطة النهاية هذه بإدخال مرتد (150-300 مللي ثانية). عرض العملات المعدنية المطابقة مع اسمها ورمزها ورتبتها. عندما يحدد المستخدم عملة معدنية، قم بتمرير معرفها إلى نقطة نهاية سعر التشفير لجلب البيانات المباشرة.

دليل العملات وصفحات الاستكشاف

أنشئ دليلًا قابلاً للبحث عن العملات المشفرة. اسمح للمستخدمين بتصفح العملات حسب الاسم، والتصفية حسب تصنيف القيمة السوقية، والنقر للوصول إلى الصفحات التفصيلية التي تعرض الأسعار المباشرة والرسوم البيانية وبيانات السوق.

استيراد المحفظة مع مطابقة غامضة

عندما يقوم مستخدم بلصق قائمة بأسماء العملات أو الرموز من جدول بيانات، استخدم نقطة النهاية هذه لحل كل إدخال إلى معرف العملة الأساسي. تعامل مع الإدخالات الغامضة (على سبيل المثال، "ETH" التي تطابق كلاً من Ethereum وEthereum Classic) من خلال إظهار منتقي توضيح المستخدم.

Frequently asked questions

هل يمكنني البحث عن طريق رمز المؤشر؟
نعم. يتطابق الاستعلام مع اسم العملة ورمز المؤشر. سيؤدي البحث عن "btc" إلى عرض Bitcoin، والبحث عن "ethereum" سيؤدي إلى عرض Ethereum.
كيف يمكنني استخدام معرف العملة من النتائج؟
يتم استخدام حقل المعرف (على سبيل المثال، "الإيثيريوم") كمعلمة للعملة في نقطة نهاية سعر التشفير. ابحث عن العملة هنا، ثم قم بتمرير معرفها للحصول على بيانات الأسعار المباشرة.
هل تتم إضافة العملات الجديدة تلقائيًا؟
يتم تحديث سجل العملة بانتظام. تظهر العملات المعدنية الجديدة المدرجة في البورصات الرئيسية في غضون أيام من إدراجها. قد تستغرق العملات المعدنية الجديدة جدًا أو ذات القيمة الصغيرة وقتًا أطول للظهور.
ماذا يمثل Market_cap_rank؟
إن Market_cap_rank هو التصنيف العالمي للعملة من حيث القيمة السوقية. المرتبة الأولى هي البيتكوين، والمرتبة الثانية هي الإيثريوم، وهكذا. يساعد ذلك المستخدمين على تقييم الحجم النسبي للعملة وأهميتها بسرعة.
هل البحث حساس لحالة الأحرف؟
لا، فالبحث حساس لحالة الأحرف. تُرجع كل من "Bitcoin" و"bitcoin" و"BITCOIN" نفس النتائج.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.