Gamma API

Polymarket Gamma API হ'ল পাবলিক REST API যা মার্কেট-স্তরের ডেটা প্রকাশ করে: markets, events, tags, series, এবং profiles। ডেভেলপার এবং ট্রেডাররা এটি ব্যবহার করে market তালিকা আনার জন্য, event মেটাডেটা ফেচ করার জন্য, এবং প্রমাণীকরণ ছাড়াও ইনডেক্স পেজ বা মার্কেট ডিরেক্টরি তৈরি করার জন্য।

Key takeaways

Gamma API পাবলিক এবং পড়ার জন্য কোনো authentication প্রয়োজন নেই। এটি ব্যবহার করে markets, events, tags, series, এবং profiles তালিকা করুন।
/markets রেট-লিমিটেড: 300 requests প্রতি 10 সেকেন্ডে। পেজিনেশন cursor-ভিত্তিক after_cursor ব্যবহার করে (offset প্রত্যাখ্যান করা হয়)।
উপযোগী কুয়েরি প্যারামিটারগুলোর মধ্যে আছে limit (max 1000), after_cursor, slug বা condition_ids এর মতো ফিল্টারিং অ্যারেগুলি, এবং closed বা active এর মতো বুলিয়ান ফ্ল্যাগ।
/markets এবং /events একসাথে ব্যবহার সতর্কতার সঙ্গে করুন: combined listing limit হল 900 req / 10 s; সম্পূর্ণ API লিমিট হল 4000 req / 10 s।

How the Gamma API is used

Gamma API হ'ল Polymarket মার্কেটসমূহ সম্পর্কিত প্রদর্শন-ভিত্তিক ডেটার canonical public surface। ফ্রন্ট-এন্ড, অ্যাগ্রিগেটর এবং রিসার্চ টুলগুলি /markets এবং /events মত এন্ডপয়েন্ট কল করে market তালিকা, ক্যাটাগরি পেজ এবং tag ফিল্টার পূরণ করে।

Important parameters and behaviors

limit: পেজ সাইজ নিয়ন্ত্রণ করে। ডিফল্ট 20, সর্বচ্চ 1000।
after_cursor: কোরসর-ভিত্তিক পেজিনেশন; offset HTTP 422 দিয়ে প্রত্যাখ্যান করা হয়—offset ব্যবহার করবেন না।
Filtering: কয়েকটি কুয়েরি প্যারামিটার অ্যারে গ্রহণ করে (উদাহরণ slug, id, condition_ids, clob_token_ids, question_ids, market_maker_address)।
Flags: closed (ডিফল্ট false), active, এবং archived মার্কেট স্টেট দিয়ে ফিল্টার করে।
Ordering: order প্যারামিটার কমা-সেপারেটেড ফিল্ড তালিকা গ্রহণ করে (উদাহরণ volume24hr,volume,liquidity,endDate), যা ascending (বুলিয়ান) দিয়ে জোড়া যায়।

Rate limits and practical guidance

/markets নির্দিষ্ট লিমিট: 300 requests প্রতি 10 সেকেন্ডে।
/markets + /events এর combined listing limit: 900 requests প্রতি 10 সেকেন্ডে।
Gamma API সমগ্র সারফেসের overall লিমিট: 4000 requests প্রতি 10 সেকেন্ডে।

যদি আপনি উচ্চ-থ্রুপুট ইনডেক্সিং পরিকল্পনা করেন, exponential backoff বাস্তবায়ন করুন এবং cursor-ভিত্তিক পেজিনেশন প্যাটার্ন মেনে চলুন। প্রয়োজনীয় স্থানে listings ক্যাশ করুন; একই রিসোর্স বারবার আগ্রাসী polling এড়িয়ে চলুন।

Example request (curl)

curl "https://gamma-api.polymarket.com/markets?limit=50&order=volume24hr&ascending=false"

In context on Polymarket

Gamma হল পাবলিক, unauthenticated read API যা আপনি ব্যবহার করবেন যখন UI তালিকা, tag পেজ, বা এমন ইন্টিগ্রেশন চান যেগুলো on-chain state প্রয়োজন নেই (on-chain positions এবং trades দেখতে Data API ব্যবহার করুন; order-book অপারেশনগুলির জন্য CLOB API ব্যবহার করুন)। যেহেতু Gamma read-only এবং public, এটি market ডিরেক্টরি এবং exploratory টুল তৈরি করার সঠিক জায়গা।

Gamma API

সংশ্লিষ্ট শব্দ