Catatan Rekayasa Naly: Polymarket Gamma sebagai Lapisan Snapshot Pasar yang Dapat Direproduksi

TL;DRIngestion Polymarket Gamma memberi Naly pandangan publik yang terstruktur tentang peristiwa pasar prediksi, pasar, hasil, harga, tag, dan metadata resolusi. Naly menggunakan lapisan itu untuk memilih kandidat artikel, menambatkan rangkuman mispricing, mendukung cerita prediksi KBO, menjaga sitasi sumber, dan membuat snapshot pasar yang tahan lama untuk verifikasi berikutnya. Klaim rekayasanya sederhana: kepercayaan editorial dimulai dari input pasar yang dapat direproduksi, bukan prosa yang dihasilkan.

Abstrak

API Polymarket Gamma harus diperlakukan sebagai sumber penemuan pasar dan metadata Naly, bukan sebagai antarmuka trading. Dokumentasi resmi Polymarket memisahkan Gamma dari API Data dan CLOB: Gamma mencakup event, market, tag, seri, metadata olahraga, pencarian, komentar, dan profil publik, sementara CLOB menangani order book, harga, spread, dan operasi trading terautentikasi. Untuk artikel Naly, batas itu berguna. Sebagian besar alur kerja editorial membutuhkan teks pertanyaan, identitas pasar, label hasil, probabilitas yang ditampilkan, tag kategori, tenggat, dan konteks resolusi sebelum membutuhkan detail order-book tingkat tick.

Tesis catatan ini adalah bahwa Naly harus menyerap Gamma ke dalam lapisan snapshot pasar berversi. Snapshot bukanlah kebenaran; snapshot adalah status pasar publik yang diamati pada waktu tertentu, dikaitkan dengan URL sumber dan payload mentah yang disimpan. Itu memungkinkan Naly memublikasikan apa yang disembunyikan orang lain: konteks pasar, batas sinyal, dan bukti persis yang digunakan saat artikel dibuat.

Posisinya di Naly

Ingestion Gamma berada sebelum pembuatan artikel dan setelah penemuan sumber eksternal. Dalam jalur publikasi Naly, ia menyediakan sisi pasar prediksi dari paket bukti untuk empat penggunaan hilir:

Rangkuman mispricing membutuhkan kandidat event dan market terkini, dengan metadata yang cukup untuk membandingkan probabilitas tersirat pasar dengan penalaran yang didukung sumber.
Artikel prediksi KBO membutuhkan market olahraga, tag tim atau event, tenggat event, dan label hasil yang dapat dirender tanpa konteks pasar yang dimasukkan secara manual.
Sitasi sumber membutuhkan URL pasar yang stabil, slug event, dan pengenal market agar pembaca dapat mengaudit mengapa artikel membahas kontrak tertentu.
Verifikasi prediksi membutuhkan snapshot historis agar resolusi berikutnya dapat dinilai terhadap probabilitas yang benar-benar dilihat Naly pada waktu publikasi.

Fakta runtime lokal penting terutama untuk bentuknya, bukan kebaruannya. TypeScript 5.9 dan tsx merupakan pilihan yang masuk akal untuk skrip ingestion; drizzle-orm dengan @neondatabase/serverless dapat menyimpan rekaman ternormalisasi dan JSON mentah; Next.js 16 dan React 19 dapat merender halaman artikel yang dihasilkan; paket ai dan Claude SDK dapat menggunakan paket bukti yang telah disiapkan hanya setelah ingestion membuat status pasar menjadi eksplisit.

Mekanisme teknis

Loop ingestion Gamma yang kuat memiliki enam tahap.

Penemuan. Gunakan event Gamma ketika Naly membutuhkan penemuan pasar aktif yang luas, dan gunakan slug market atau event ketika artikel ditambatkan ke URL Polymarket yang sudah diketahui. Panduan data pasar Polymarket merekomendasikan event untuk penemuan aktif yang lengkap karena event mencakup market terkait, sehingga mengurangi panggilan API. Untuk pekerjaan kategori seperti olahraga, tag dan metadata olahraga harus mempersempit crawl sebelum kandidat diberi peringkat.
Paginasi. Gamma mendukung endpoint bergaya offset dan endpoint keyset. Untuk crawling besar atau berulang, paginasi keyset lebih aman karena next_cursor menjadi token kelanjutan dan offset secara eksplisit ditolak pada endpoint market keyset. Untuk pekerjaan artikel bertarget yang lebih kecil, paginasi offset masih dapat diterima ketika jendela kueri sempit dan output langsung dibuat snapshot.
Normalisasi. Aturan normalisasi utama adalah bahwa label hasil dan harga hasil harus dipetakan berdasarkan posisi. Ikhtisar data pasar Polymarket mendokumentasikan array outcomes dan outcomePrices sebagai array satu-ke-satu, jadi disiplin indeks penting. Array yang tertukar bukan bug kosmetik; itu membalik interpretasi pasar dalam artikel.
Snapshotting. Simpan kolom ternormalisasi dan JSON mentah. Kolom ternormalisasi harus mencakup provider, timestamp pengambilan, id atau slug event, id atau slug market, teks pertanyaan, condition id jika ada, pengenal token jika ada, label hasil, harga hasil, flag aktif dan ditutup, waktu akhir, tag, URL sumber, dan hash payload. JSON mentah melindungi Naly dari drift skema dan memungkinkan verifikasi memutar ulang artefak ingestion yang persis.
Penilaian kandidat. Pekerjaan artikel harus memberi peringkat market menggunakan kriteria editorial, bukan kriteria eksekusi trading: kebaruan, volume atau likuiditas jika tersedia, kedekatan resolusi, ketersediaan sumber, kecocokan kategori, dan apakah market dapat menghasilkan kontras yang jelas bagi pembaca. Penilaian kandidat tidak boleh pernah menyiratkan bahwa harga market otomatis salah; penilaian harus menandai market sebagai layak diteliti.
Pengikatan publikasi. Saat artikel yang dihasilkan mengutip market, artikel harus menautkan ke id snapshot yang tersimpan, URL sumber Polymarket, dan set bukti eksternal yang digunakan penulis. Inilah perbedaan antara halaman yang mengatakan market berada di 62 persen dan halaman yang dapat membuktikan kapan, di mana, dan dari payload apa nilai itu berasal.

Batas laju adalah bagian dari mekanisme. Polymarket mendokumentasikan throttling yang ditegakkan Cloudflare dan batas Gamma khusus untuk /events, /markets, /tags, dan /public-search. Naly tidak perlu mendekati batas itu untuk publikasi harian, jadi sikap yang tepat adalah konservatif: konkurensi terbatas, retry dengan jitter, hash payload untuk idempotensi, dan peringatan ketika sebuah job menerima respons yang dibatasi, kosong, atau secara struktural tidak terduga.

Apa kata literatur

Karya arXiv terbaru mendukung desain yang mengutamakan snapshot. Jia et al. menggambarkan data pasar prediksi terdesentralisasi sebagai terfragmentasi di antara metadata off-chain, rekaman trading tingkat fill, dan event resolusi oracle, lalu berargumen untuk sistem relasional terpadu dengan resolusi pengenal, pembaruan inkremental, dan mekanisme konsistensi. Sistem publikasi Naly yang lebih kecil menghadapi kelas masalah yang sama: metadata pasar saja tidak cukup kecuali nantinya dapat digabungkan dengan harga, klaim artikel, dan hasil resolusi.

Studi kalibrasi Le secara langsung relevan dengan bahasa artikel. Dengan menggunakan dataset Kalshi dan Polymarket yang besar, makalah itu berargumen bahwa kalibrasi bergantung pada domain, horizon, dan efek ukuran trade; konsumen yang memperlakukan harga sebagai probabilitas pada nilai nominal dapat salah menafsirkannya secara sistematis. Bagi Naly, ini berarti artikel harus mengatakan probabilitas tersirat pasar, harga yang diamati, atau sinyal pasar publik, bukan kebenaran. Artikel dapat membahas kemungkinan mispricing hanya setelah memisahkan pengamatan pasar mentah dari model Naly atau penalaran yang didukung sumber.

Makalah mikrostruktur Polymarket dari Dubach terutama membahas data order-book, tetapi memberi peringatan berguna untuk desain ingestion: bukti pasar berfrekuensi tinggi memiliki mode kesalahan khusus sumber, keterlambatan ingestion, dan join yang penting. Gamma kurang granular dibanding feed order-book, tetapi prinsip yang sama berlaku. Sumber sebuah angka harus terlihat. Snapshot Gamma, midpoint CLOB, dan rekaman trade on-chain saling terkait tetapi tidak dapat dipertukarkan.

Madrigal-Cianci, Monsalve Maya, dan Breakey membingkai pasar prediksi sebagai masalah invers Bayesian, di mana riwayat probabilitas dan volume yang diamati bersifat berisik, endogen, dan dibentuk oleh tipe trader yang heterogen. Itu memperkuat sikap editorial Naly. Status pasar yang diserap adalah bukti, bukan vonis. Rekayasa yang baik membuat ketidakpastian itu dapat diperiksa alih-alih menghapusnya selama generasi.

Trade-off desain

Gamma versus CLOB adalah trade-off pertama. Gamma memberi Naly kemampuan penemuan, konteks artikel, dan metadata. CLOB memberi harga yang lebih tajam dan mekanika order-book. Untuk artikel rekayasa harian dan rangkuman pasar prediksi, Gamma harus menjadi input default karena menjawab tentang apa market tersebut. CLOB dapat ditambahkan ketika artikel membutuhkan spread, midpoint, atau presisi riwayat harga.

Ingestion yang mengutamakan event versus market adalah trade-off kedua. Event-first lebih murah untuk pemindaian luas karena satu event dapat berisi beberapa market dan metadata bersama. Market-first lebih bersih untuk verifikasi karena skor akhir melekat pada hasil biner tertentu. Naly harus menyerap kedua bentuk, tetapi membuat tautan artikel mengarah ke klaim tingkat market setiap kali satu hasil sedang dievaluasi.

JSON mentah versus skema bertipe adalah trade-off ketiga. JSON mentah saja mudah disimpan tetapi sulit dikueri dengan aman. Kolom bertipe saja mudah dikueri tetapi rapuh ketika field provider berevolusi. Pola yang tahan lama adalah keduanya: field bertipe untuk pemeringkatan, rendering, dan join; payload mentah untuk audit, replay, dan migrasi.

Render live versus render beku adalah trade-off keempat. Widget market live bisa berguna, tetapi klaim artikel harus terikat pada snapshot waktu publikasi. Jika tidak, artikel lama dapat diam-diam berubah makna ketika Polymarket bergerak, menutup, atau menyelesaikan market. Untuk strategi kepercayaan Naly, bukti beku mengalahkan kebaruan ketika halaman membuat klaim bertanggal.

Mode kegagalan

Kegagalan paling berbahaya adalah ketidakselarasan hasil-harga. Jika label Yes dan No diurai terpisah dari harga, artikel dapat membalik sinyal sambil tetap terlihat masuk akal.

Kegagalan kedua adalah penggunaan ulang market basi. Sebuah market dapat aktif saat penemuan dan sudah ditutup pada waktu publikasi. Setiap job artikel harus memvalidasi ulang field aktif, ditutup, diarsipkan, dan waktu akhir tepat sebelum mengikat snapshot.

Kegagalan ketiga adalah ambiguitas multi-market. Sebuah event Polymarket dapat berisi beberapa market yang dapat diperdagangkan. Sebuah rangkuman dapat mengutip event tersebut, tetapi rekaman verifikasi harus mengutip market dan hasil spesifik yang dievaluasi Naly.

Kegagalan keempat adalah drift skema. API publik mengubah nama field, default, dan relasi bersarang. Penyimpanan snapshot harus mencakup hash payload, versi parser, URL provider, dan kesalahan validasi agar drift dapat diamati.

Kegagalan kelima adalah klaim kalibrasi yang berlebihan. Harga market adalah sinyal publik yang berguna, tetapi literatur memperingatkan agar tidak memperlakukannya sebagai probabilitas bersih di semua domain dan horizon. Naskah Naly harus mempertahankan perbedaan antara probabilitas tersirat pasar, estimasi Naly, dan hasil yang terwujud.

Kegagalan keenam adalah hilangnya sitasi. Jika artikel hanya menyimpan markdown yang dirender, verifikasi berikutnya tidak dapat membuktikan halaman market dan payload mana yang mendukung klaim tersebut. Join artikel-market harus menjadi rekaman kelas satu, bukan prosa tertanam.

Catatan implementasi

Implementasi Naly yang praktis dapat menjaga kontrak ingestion tetap kecil:

provider: polymarket-gamma.
provider_url: endpoint Gamma persis atau URL market publik yang digunakan untuk penemuan.
fetched_at: timestamp server dalam UTC.
event_key dan market_key: pengenal atau slug provider yang stabil.
question: teks pertanyaan market kanonis.
outcomes: label berurutan.
outcome_prices: string desimal berurutan yang dinormalisasi menjadi nilai numerik hanya setelah validasi.
status: flag aktif, ditutup, diarsipkan, dan layak dipublikasikan.
raw_payload: respons provider lengkap.
payload_hash: hash deterministik untuk idempotensi dan replay.
parser_version: kontrak kode yang menafsirkan payload.

Generator artikel harus menerima ini sebagai bukti terstruktur, bukan sebagai teks prompt longgar. Ia kemudian dapat menghasilkan markdown melalui stack AI yang ada, merender dengan pipeline situs, dan menjaga sitasi tetap melekat pada rekaman sumber. Worker verifikasi nantinya dapat menggabungkan snapshot market artikel dengan data resolusi dan menilai apakah klaim yang dipublikasikan bertahan dengan baik seiring waktu.

Prinsip rekayasanya sengaja konservatif: ingest, normalisasi, snapshot, sitasi, lalu tulis. Urutan itu lebih lambat daripada meminta model menelusuri dan merangkum halaman market, tetapi menciptakan artefak yang benar-benar dibutuhkan Naly untuk akuisisi dan retensi: artikel publik yang bukti pasarnya dapat diputar ulang setelah hasilnya diketahui.