Catatan Teknik Naly: Ingest API Gamma Polymarket untuk artikel pasar prediksi

TL;DRNaly mengingest API Gamma Polymarket sebagai substrat discovery dan pricing yang deterministik untuk semua alur kerja pasar prediksi, menggantikan scraping berita ad hoc dengan entitas pasar terstruktur. Setiap siklus, Naly mengonversi peristiwa dan pasar langsung ke sinyal siap artikel untuk rangkuman mispricing, pratinjau KBO, bundel sitasi, dan verifikasi hasil di kemudian hari, sehingga pembuatan cerita selalu dimulai dari probabilitas dan struktur pasar yang dapat diobservasi publik, bukan opini yang disimpulkan.

Abstrak

Naly menggunakan data pasar prediksi sebagai infrastruktur, bukan sebagai lapisan tambahan, sehingga artefak editorial terhubung langsung dengan kondisi pasar eksternal yang dapat diaudit kemudian. API Gamma menyediakan jalur baca untuk peristiwa, pasar, tag, dan harga tanpa memerlukan kunci tingkat dompet. Tantangan desainnya adalah menjaga lapisan ingest ini cukup ketat untuk keandalan, tetapi tetap fleksibel untuk tim konten yang membutuhkan penemuan topik cepat.

Posisinya di Naly

Ingest Polymarket Gamma berada di batas hulu antara primitif pasar mentah dan aset editorial yang siap terbit. Ini adalah langkah pertama dari alur kerja yang lebih luas:

Lapisan input: mengambil peristiwa, pasar, tag, dan status pasar dari Gamma.
Lapisan interpretasi: normalisasi ke skema internal Naly (event_id, market_id, ID token, hasil, probabilitas, timestamp, penanda aktif/tertutup).
Lapisan naratif: menyalurkan input ternormalisasi ke alur ringkasan mispricing dan penyusunan prediksi KBO.
Lapisan validasi: menyimpan status pasar yang terselesaikan/tertutup untuk pengecekan kebenaran artikel nanti dan scorecard retrospektif.

Per 10 Juni 2026, ini selaras dengan taktik aktif yang memerlukan bukti peramalan yang dapat dipercaya dan siap sitasi: visibilitas kalibrasi prediksi, pengambilan sumber konten yang dapat diulang, dan alur kerja verifikasi kemudian.

Mekanisme teknis

Polymarket mendefinisikan tiga API, dengan Gamma sebagai pesawat penemuan publik untuk penjelajahan dan metadata peristiwa/pasar, sementara data order book/perdagangan dibuka melalui CLOB dan data user/positions melalui Data API (dokumentasi). Gamma dan Data bersifat publik menurut dokumentasi Polymarket, sedangkan CLOB memiliki antarmuka private/trading yang memerlukan autentikasi untuk operasi order.

Naly dapat menjalankan alur harian yang andal hanya dengan endpoint publik:

Temukan pasar kandidat aktif melalui GET /events dengan active=true, closed=falsepaginasi (limit, offset), dan filter pengurutan opsional.
Perluas ke pasar penyusun menggunakan payload tingkat peristiwa, karena peristiwa membawa pasar terkait dan mengurangi panggilan API dibandingkan pencarian pasar secara terpisah.
Sasar entitas secara tepat menggunakan panggilan berbasis slug ketika peristiwa atau pasar tertentu sudah teridentifikasi.
Normalisasi harga dengan memetakan outcomes dan outcomePrices array indeks per indeks menjadi probabilitas bernama.
Simpan artefak audit sebagai baris ternormalisasi maupun snapshot mentah agar setiap artikel dapat melacak setiap angka sumber.
Kontrol pembuatan di hilir berdasarkan pengecekan kebaruan + skema; snapshot yang usang atau tidak lengkap ditandai untuk refresh sebelum dipakai.

Dokumentasi Gamma menjelaskan bentuk operasional ini secara tepat: endpoint publik seperti /events, /markets, /public-search, /tags, dan /series tersedia untuk penemuan, sementara paginasi dan penyaringan didukung melalui limit/offset, tag_id, serta filter terkait. Gamma juga memberi rekomendasi langsung untuk tiga pola pengambilan: pencarian berbasis slug, discovery berbasis tag, dan enumerasi peristiwa untuk pemindaian besar. Untuk Naly, pola event-first paling hemat biaya saat membangun banyak kandidat harian karena tiap peristiwa dapat memunculkan banyak catatan pasar.

Dalam praktiknya, rekam jejak sumber kebenaran minimum untuk Naly sebaiknya mencakup:

ID peristiwa dan pasar
pasar question
clobTokenIds (untuk rekonsiliasi harga di hilir dengan CLOB jika diperlukan)
outcomes dan outcomePrices
enableOrderBook
active, closedserta field temporal (timestamp mulai/selesai)
timestamp pengambilan dan URL sumber

Meskipun Gamma sudah bisa memberikan baseline probabilitas yang kuat, jalur penyempurnaan kedua bersifat opsional: ketika Naly membutuhkan pembaruan intraday interval pendek, endpoint CLOB seperti /price, /prices, atau /book dapat digabungkan nanti.

Apa kata literatur

Riset mengenai pasar prediksi mendukung pendekatan data-first ini tetapi menambahkan pagar pengaman dalam interpretasi.

Model data pasar pada prediksi hanya berguna jika terkalibrasi dan diinterpretasi dengan benar; harga bukan probabilitas universal tanpa konteks. Studi 2026 pada Polymarket dan Kalshi menemukan pola kalibrasi sistematis yang bervariasi menurut domain dan horizon, termasuk underconfidence terukur di ruang tertentu.
Studi lifecycle lain di 2026 menekankan bahwa analisis pasar yang bermakna membutuhkan rekayasa data multi-layer yang tersinkronisasi: metadata pasar, peristiwa perdagangan, dan sinyal settlement memerlukan keterkaitan eksplisit serta pengecekan konsistensi berkala, bukan pengambilan yang terpisah.
Penelitian sebelumnya tentang mikrostruktur pasar menunjukkan bahwa harga pasar menyalurkan informasi trader dalam aliran gaya lelang kontinu, sehingga Naly dapat memperlakukan harga pasar sebagai sinyal ramalan kolektif sambil tetap memvalidasi hasil seiring waktu.
Literatur peramalan yang membandingkan harga pasar dengan metode lain (misalnya peramalan berbasis survei) menunjukkan pasar prediksi bisa sangat prediktif tetapi hanya ketika verifikasi hasil dan disiplin model tetap dijaga.

Konsekuensi praktis bagi Naly cukup jelas: ingest semua data dengan asal-usul (provenance), jangan pernah memperlakukan satu snapshot harga sebagai kebenaran final, dan pisahkan readiness (kebaruan + integritas data) dari story quality (konstruksi editorial).

Trade-off desain

Naly secara sengaja mengoptimalkan keandalan dibandingkan kecepatan pada tahap ingest.

Gamma-only vs Gamma+CLOB: Gamma memberi konteks publik dan penemuan yang stabil dengan cepat; penambahan CLOB meningkatkan kekayaan mikrostruktur tetapi menambah kompleksitas autentikasi dan endpoint.
Snapshot harian vs streaming kontinu: penarikan terjadwal yang deterministik lebih mudah diaudit dan direproduksi dibanding stream kontinu, tetapi melewatkan pergeseran rezim sub-menit.
Tarik event-first vs tarik market-first: event-first mengurangi duplikat panggilan dan meningkatkan cakupan konteks; market-first memberi sedikit lebih kecil ukuran payload untuk tugas yang sempit.
Skema luas vs skema ketat: skema JSON-first yang luas mempercepat integrasi tetapi meningkatkan risiko drift skema; normalisasi ketat menangkap drift lebih awal tetapi menambah overhead migrasi.
Field general vs field spesifik domain: menggunakan field bersama meningkatkan reuse lintas artikel; menambahkan ekstensi domain-spesifik (misalnya rentang confidence untuk olahraga) meningkatkan presisi langsung tetapi bisa memecah pemeliharaan jangka panjang.

Mengingat tujuan Naly pada kepercayaan dan retensi pengguna, keterulangan dan kualitas sitasi yang ketat sebaiknya menjadi prioritas dibanding optimasi latency jangka pendek.

Mode kegagalan

Mode kegagalan terbesar bersifat operasional, bukan algoritmik.

Data hilang karena bug paginasi: jika limit dan offset jendela berubah antar polling, duplikat atau celah dapat muncul. Mitigasi: checkpoint pagination cursor dan terapkan idempotent upserts.
Bawaan closed=false menghilangkan konteks historis: pengambilan pasar terbuka mengabaikan item terselesaikan kecuali closed=true diminta secara eksplisit. Mitigasi: jalankan jalur backfill historis khusus untuk tugas verifikasi.
Ketidakstabilan slug: URL produk dan slug yang mudah dibaca manusia dapat bergeser. Mitigasi: prioritaskan ID utama secara internal dan pertahankan slug sebagai kunci sekunder.
Perubahan field semantik: outcomes/outcomePrices interpretasi bisa rusak jika asumsi urutan skema salah. Mitigasi: pastikan penjajaran array dan pemeriksaan panjang saat ingest.
Ketersediaan API sementara atau throttling: endpoint publik dapat gagal atau mengembalikan payload parsial. Mitigasi: retry dengan exponential backoff, poison-queue pada kegagalan berulang, dan simpan snapshot sebelumnya.
Penyelesaian terlambat dan narasi ketinggalan: artikel verifikasi dapat terbit sebelum settlement bersih. Mitigasi: simpan status settlement sebagai bagian dari publish-state dan perbarui secara post-hoc dengan log koreksi yang immutable.

Dengan strategi trust-first Naly, pipeline seharusnya fail closed: lebih baik menunda sebuah artikel daripada menerbitkan dengan kondisi pasar yang tidak dapat diverifikasi.

Catatan implementasi

Dengan stack runtime yang disebutkan, implementasi praktis tetap langsung:

Gunakan handler server Next.js (next@16.0.7) untuk menampung endpoint ingest dan job terjadwal.
Simpan baris ternormalisasi di Neon menggunakan drizzle-orm@^0.44.7 di atas @neondatabase/serverless@^1.0.2 dengan kendala unik eksplisit pada identifikasi pasar.
Simpan snapshot payload mentah di Vercel Blob (@vercel/blob@^2.0.0) untuk auditability dan post-mortem diffing.
Pertahankan pembuatan sumber markdown dan perakitan artikel di luar inti ingest; gunakan marked@^17.0.1 untuk transformasi yang aman dan ai@6.0.0-beta.105 plus @anthropic-ai/claude-agent-sdk@^0.2.15 hanya setelah pengecekan integritas data lolos.
Gunakan tsx@^4.21.0/typescript@^5.9.3 untuk replay sekali jalan yang dapat direproduksi saat backfilling jendela historis.

Pada 10 Juni 2026, arsitektur sebaiknya memprioritaskan tiga output utama: ketidakboleubahan snapshot mentah, proyeksi deterministik ke skema internal, dan jejak audit berorientasi verifikasi dari URL API sumber hingga sitasi artikel final.