Rate limit

Definition

Ang API rate limit ay isang limitasyon sa bilang ng mga kahilingan na tatanggapin ng isang API sa loob ng isang takdang window ng oras. Ang mga kliyenteng lumalampas sa limitasyon ay makakatanggap ng error o pansamantalang maa-block hanggang sa mag-reset ang window. Pinoprotektahan ng mga rate limit ang mga server mula sa sobrang load, tinitiyak ang patas na paggamit sa pagitan ng mga kliyente, at pinapanatili ang kalidad ng serbisyo.

In context

Sa Polymarket, ang Gamma surface ay naglalathala ng mga pampublikong REST endpoint tulad ng /markets. Ang endpoint na iyon ay partikular na nagpapahintulot ng 300 requests bawat 10 segundo. Ang pinagsamang paggamit ng listing sa /markets at /events ay may mas mataas na pinagsamang limit (900 requests bawat 10 segundo). Ang paglabag sa mga limitasyong ito ay magdudulot ng pagtanggi ng API sa mga karagdagang kahilingan hanggang sa mag-expire ang kaugnay na window; planuhin nang naaayon ang pagination at polling intervals.

Practical tips

• Gumamit ng keyset pagination (after_cursor) sa halip na offset para mag-page nang mas epektibo sa /markets.
• I-batch ang mga kahilingan kapag posible at iwasan ang maigsi, madalas na polling loops; mas mainam ang makatuwirang backoff pagkatapos maabot ang limit.
• I-cache ang mga paulit-ulit na tugon para sa maiikling agwat kung kayang tiisin ng iyong workflow ang bahagyang stale na data.

See also

• gamma-api