Gamma API ya Polymarket: Masoko, Matukio na Vitambulisho vya Tokeni (2026)

API · Marejeleo

Gamma API kwenye gamma-api.polymarket.com ndiyo "katalogi" - ndiyo jinsi unavyogundua masoko na matukio na kupata vitambulisho vya tokeni ambavyo CLOB huhitaji kufanya biashara. Ni ya umma, bila uthibitishaji, kwa hivyo unaweza kuchunguza kila endpoint kutoka kivinjari au curl sasa hivi, na vivyo hivyo zana hai kwenye ukurasa huu.

Endpoint utakazotumia kweli

Vigezo vya kawaida vya swali kwenye /markets na /events: active=true, closed=false, slug=, tag_slug=, order=volume24hr, ascending=false, limit= na offset= kwa kurasa.

GET /markets - ombi na jibu

Omba soko moja kwa slug. Unapata array (hata kwa soko moja), kwa hivyo chukua kipengele [0]:

curl -s "https://gamma-api.polymarket.com/markets?slug=will-it-rain-in-nyc-today" | jq '.[0]'

import requests, json
m = requests.get("https://gamma-api.polymarket.com/markets",
                 params={"slug": "will-it-rain-in-nyc-today"}).json()[0]

Jibu lililopunguzwa na kufafanuliwa (sehemu ambazo boti hujali):

{
  "id": "519284",
  "question": "Will it rain in NYC today?",
  "slug": "will-it-rain-in-nyc-today",
  "conditionId": "0x1f2e...c0",      // the market id (NOT what you trade on)
  "active": true,                    // listed and live
  "closed": false,                   // not yet resolved
  "acceptingOrders": true,           // the CLOB is currently taking orders
  "outcomes": "[\"Yes\", \"No\"]",          // JSON string -> parse it
  "clobTokenIds": "[\"7142...\", \"1098...\"]", // JSON string, aligned with outcomes
  "outcomePrices": "[\"0.62\", \"0.38\"]",     // JSON string, last prices
  "bestBid": 0.61,
  "bestAsk": 0.63,
  "lastTradePrice": 0.62,
  "volume24hr": 48213.5,
  "endDate": "2026-06-16T00:00:00Z"
}

Vitambulisho viwili vya tokeni za matokeo viko ndani ya clobTokenIds. Ndivyo ambavyo CLOB hufanya biashara navyo - visome na unaweza kuweka oda.

Kikwazo namba #1: sehemu za mfuatano zilizosimbwa kwa JSON

Gamma hurudisha clobTokenIds, outcomes na outcomePrices kama mifuatano iliyosimbwa kwa JSON ndani ya JSON, kwa hivyo lazima uifafanue mara ya pili. Na kamwe usihifadhi tokeni ipi ni "Yes": soma array iliyofafanuliwa ya outcomes na uramani kwa jina, kwa sababu mpangilio hauhakikishwi.

import requests, json
m = requests.get("https://gamma-api.polymarket.com/markets",
                 params={"slug": SLUG}).json()[0]
outcomes   = json.loads(m["outcomes"])        # e.g. ["Yes", "No"]
token_ids  = json.loads(m["clobTokenIds"])    # aligned with outcomes
prices     = json.loads(m["outcomePrices"])   # aligned with outcomes
yes_token  = token_ids[outcomes.index("Yes")]
print(yes_token, prices[outcomes.index("Yes")])

const r = await fetch(`https://gamma-api.polymarket.com/markets?slug=${SLUG}`);
const m = (await r.json())[0];
const outcomes  = JSON.parse(m.outcomes);
const tokenIds  = JSON.parse(m.clobTokenIds);
const yesToken  = tokenIds[outcomes.indexOf("Yes")];

curl -s "https://gamma-api.polymarket.com/markets?slug=$SLUG" | jq -r '.[0].clobTokenIds | fromjson | .[0]'

Jaribu kwenye soko halisi - bandika slug na uvute vitambulisho vyake vya tokeni hai:

Changanua masoko yanayoweza kufanyiwa biashara

Swali la kawaida la ugunduzi la boti huomba masoko yaliyo hai, wazi, yenye shughuli nyingi kwanza, katika kategoria moja:

GET https://gamma-api.polymarket.com/markets
    ?active=true&closed=false&order=volume24hr&ascending=false&limit=20&tag_slug=politics

Chuja matokeo upande wa mteja hadi masoko yanayoweza kweli kufanyiwa biashara kabla hujachukua hatua:

# keep only markets the CLOB will accept orders on right now
tradeable = [m for m in markets
             if m.get("active") and not m.get("closed") and m.get("acceptingOrders")]

Tafuta hai (hii huita /public-search, kisha hupakia vitambulisho vya tokeni kwa kila soko):

Kurasa na uchangamfu

• Kurasa: ongeza limit na offset na utembee hadi upate ukurasa mfupi. Weka limit ≤ 500 kwenye /events, ≤ 300 kwenye /markets.
• Uchangamfu: bei (bestBid, bestAsk, lastTradePrice) husogea kila mara. Gamma ni sawa kwa ugunduzi na bei ya kadirio, lakini nukuu na fanya biashara kutoka daftari hai la CLOB, si bei ya Gamma iliyohifadhiwa.
• Kuhifadhi: hifadhi ramani ya slug -> token_id (ni thabiti), si bei.

GET /events - makundi ya matokeo mengi

Tukio hufunga masoko yanayohusiana (mfano "NYC Mayoral Election" hushikilia soko moja kwa kila mgombea). Litumie kuonyesha kadi za matokeo mengi au kupata kila soko kuhusu mada:

curl -s "https://gamma-api.polymarket.com/events?slug=nyc-mayor-2025" | jq '.[0].markets | length'

Kila tukio lina array ya markets; kila kipengele kina sehemu za mfuatano zile zile za clobTokenIds / outcomes kama soko la ngazi ya juu, kwa hivyo uchambuzi ule ule hutumika.

Marejeleo ya sehemu (zile zinazouma)

Kifuatacho: CLOB API (fanya biashara kwa token_id) · Data API (historia na PnL) · Rekebisha hitilafu.