[ search · endpoint ]واجهة بحث · أسواق تنبؤ

واجهة بحث أسواق التنبؤ

استعلم عن عقود Polymarket وKalshi حول السياسة والاقتصاد والرياضة والأحداث الجارية. JSON مهيّأ مسبقًا لاسترداد التنبؤات الجماعية وإسناد الاحتمالات في سير عمل LLM.

●50 رصيد / استدعاء●30 طلب / دقيقةPOST /api/search/prediction-markets

[ 01 · live ]

جرّب بحث أسواق التنبؤ مباشرةً

أدخل مفتاح API الخاص بك ونفّذ استعلامًا حقيقيًا على نقطة النهاية المباشرة.

auth · x-api-key

مفتاح API

لا تملك مفتاح API؟

سجّل الدخول إلى حسابك لإنشاء وإدارة مفاتيح API.

تسجيل الدخول إدارة مفاتيح API

[ 02 · integrate ]

Integration guide

Copy a snippet, replace your API key, run. Works in any HTTP client — examples below in cURL, JavaScript, and Python.

spec

POST/api/search/prediction-markets

base

https://www.apipick.com

بحث دلالي في عقود أسواق التنبؤ Polymarket وKalshi. يُعيد عناوين الأسواق والملخصات وروابط المصدر.

parameters

querystringrequired

Natural-language search query

max_num_resultsintegeroptional

1–5, default 5

relevance_thresholdnumberoptional

0.0–1.0 quality filter

country_codestringoptional

ISO country code (e.g. US, GB)

start_datestringoptional

ISO date YYYY-MM-DD

end_datestringoptional

ISO date YYYY-MM-DD

curl -X POST "https://www.apipick.com/api/search/prediction-markets" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "2026 US presidential election",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'

● 200 · response

{
  "query": "2026 US presidential election",
  "results": [
    {
      "title": "Example result",
      "url": "https://example.com/article",
      "snippet": "Short excerpt of the page content…",
      "source_type": "web",
      "published_at": "2026-04-15",
      "score": 0.92
    }
  ],
  "result_count": 1,
  "credits_used": 50,
  "remaining_credits": 99
}

[ 03 · limits ]

Rate limits

Throttling is per API key, sliding 60-second window. Hit the limit and you get a clean 429 with a Retry-After header.

request rate

30req/min

Per API key, per endpoint. Sliding 60-second window.

concurrency

3concurrent

Max simultaneous in-flight requests per API key.

response headers

X-RateLimit-LimitMaximum requests allowed per minute

X-RateLimit-RemainingRequests remaining in the current window

X-RateLimit-ResetSeconds until the current window resets

Retry-AfterSeconds to wait before retrying (only on 429)

● 429 · too many requests

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded: 30 requests/minute per API key. Retry after 12s.",
  "retry_after": 12
}

[ faq ]

الأسئلة الشائعة

ما الأسواق المُغطاة؟

Polymarket (لامركزي، تسوية بـ USDC) وKalshi (منظّم من قِبَل CFTC). الأسواق الحيّة والمحلولة قابلة للبحث على حدٍّ سواء.

هل تُعاد الأسعار الحيّة؟

تشمل النتائج بيانات وصفية للسوق وروابط مصدر. للحصول على الأسعار اللحظية، اتبع رابط المصدر أو الواجهة الأصلية للسوق. نقطة النهاية مُحسّنة للاسترداد والاكتشاف، وليست لتسعيرات عالية التردد.

لماذا أستخدم هذا بدلًا من الذهاب مباشرةً؟

نقطة نهاية واحدة، تدفّق مصادقة واحد، بحث دلالي عبر المنصّتين، وفوترة أرصدة موحّدة. مفيد عندما يحتاج وكيل إلى إسناد ادّعاء احتمالي دون دمج واجهتين منفصلتين.

تصفية حسب التاريخ؟

نعم. start_date / end_date تُصفّي الأسواق حسب تاريخ الإدراج أو الحلّ.

مخطط أداة؟

GET /api/search/prediction-markets/tool-schema يُعيد تعريفات tool use لـ OpenAI وClaude.