Ghi chú kỹ thuật của Naly: Polymarket Gamma như một lớp ảnh chụp thị trường có thể tái lập

TL;DRViệc thu nạp Polymarket Gamma cung cấp cho Naly một góc nhìn công khai, có cấu trúc về các sự kiện thị trường dự đoán, thị trường, kết quả, giá, thẻ và siêu dữ liệu phân giải. Naly dùng lớp này để chọn ứng viên bài viết, neo các bản tổng hợp định giá sai, hỗ trợ các câu chuyện dự đoán KBO, lưu giữ trích dẫn nguồn và tạo các ảnh chụp thị trường bền vững cho việc xác minh sau này. Luận điểm kỹ thuật rất đơn giản: niềm tin biên tập bắt đầu từ đầu vào thị trường có thể tái lập, không phải văn bản do AI tạo.

Tóm tắt

Polymarket Gamma API nên được xem là nguồn khám phá thị trường và siêu dữ liệu của Naly, không phải một giao diện giao dịch. Tài liệu chính thức của Polymarket tách Gamma khỏi Data và CLOB API: Gamma bao phủ sự kiện, thị trường, thẻ, chuỗi, siêu dữ liệu thể thao, tìm kiếm, bình luận và hồ sơ công khai, trong khi CLOB xử lý sổ lệnh, giá, chênh lệch giá và các thao tác giao dịch đã xác thực. Với các bài viết của Naly, ranh giới đó rất hữu ích. Phần lớn quy trình biên tập cần văn bản câu hỏi, danh tính thị trường, nhãn kết quả, xác suất hiển thị, thẻ danh mục, hạn chót và bối cảnh phân giải trước khi cần chi tiết sổ lệnh ở cấp tick.

Luận đề của ghi chú này là Naly nên thu nạp Gamma vào một lớp ảnh chụp thị trường có phiên bản. Ảnh chụp không phải là sự thật; nó là trạng thái thị trường công khai được quan sát tại một thời điểm cụ thể, gắn với URL nguồn và các payload thô được lưu giữ. Điều đó cho phép Naly công bố những gì người khác che giấu: bối cảnh thị trường, giới hạn của tín hiệu và bằng chứng chính xác được dùng khi một bài viết được tạo.

Vị trí của nó trong Naly

Việc thu nạp Gamma nằm trước khâu tạo bài viết và sau khâu khám phá nguồn bên ngoài. Trong lộ trình xuất bản của Naly, nó cung cấp phần thị trường dự đoán của gói bằng chứng cho bốn mục đích hạ nguồn:

Các bản tổng hợp định giá sai cần ứng viên sự kiện và thị trường hiện tại, với đủ siêu dữ liệu để so sánh xác suất hàm ý từ thị trường với lập luận có nguồn hỗ trợ.
Các bài viết dự đoán KBO cần thị trường thể thao, thẻ đội hoặc sự kiện, hạn chót sự kiện và nhãn kết quả có thể được hiển thị mà không phải nhập tay bối cảnh thị trường.
Trích dẫn nguồn cần URL thị trường ổn định, slug sự kiện và định danh thị trường để độc giả có thể kiểm tra vì sao bài viết thảo luận một hợp đồng cụ thể.
Xác minh dự đoán cần các ảnh chụp lịch sử để kết quả phân giải sau này có thể được chấm điểm theo xác suất mà Naly thực sự thấy tại thời điểm xuất bản.

Các sự kiện runtime cục bộ chủ yếu quan trọng ở hình dạng hệ thống, không phải tính mới. TypeScript 5.9 và tsx là lựa chọn hợp lý cho các script thu nạp; drizzle-orm với @neondatabase/serverless có thể lưu các bản ghi đã chuẩn hóa và JSON thô; Next.js 16 và React 19 có thể hiển thị các trang bài viết kết quả; các gói ai và Claude SDK chỉ nên sử dụng gói bằng chứng đã chuẩn bị sau khi việc thu nạp đã làm rõ trạng thái thị trường.

Cơ chế kỹ thuật

Một vòng lặp thu nạp Gamma vững chắc có sáu giai đoạn.

Khám phá. Dùng sự kiện Gamma khi Naly cần khám phá rộng các thị trường đang hoạt động, và dùng slug thị trường hoặc sự kiện khi một bài viết được neo vào một URL Polymarket đã biết. Hướng dẫn dữ liệu thị trường của Polymarket khuyến nghị dùng sự kiện để khám phá đầy đủ các thị trường đang hoạt động vì sự kiện bao gồm các thị trường liên quan, giúp giảm số lệnh gọi API. Với công việc theo danh mục như thể thao, thẻ và siêu dữ liệu thể thao nên thu hẹp phạm vi crawl trước khi xếp hạng ứng viên.
Phân trang. Gamma hỗ trợ cả endpoint kiểu offset và endpoint keyset. Với việc crawl lớn hoặc lặp lại, phân trang keyset an toàn hơn vì next_cursor trở thành token tiếp tục và offset bị từ chối rõ ràng trên endpoint thị trường keyset. Với các tác vụ bài viết nhỏ hơn và có mục tiêu, phân trang offset vẫn có thể chấp nhận được khi cửa sổ truy vấn hẹp và đầu ra được chụp lại ngay lập tức.
Chuẩn hóa. Quy tắc chuẩn hóa then chốt là nhãn kết quả và giá kết quả phải được ánh xạ theo vị trí. Tổng quan dữ liệu thị trường của Polymarket ghi rõ outcomes và outcomePrices là các mảng một-một, nên kỷ luật chỉ mục rất quan trọng. Một mảng bị hoán đổi không phải lỗi thẩm mỹ; nó đảo ngược cách bài viết diễn giải thị trường.
Chụp ảnh. Lưu cả cột đã chuẩn hóa lẫn JSON thô. Các cột đã chuẩn hóa nên bao gồm nhà cung cấp, dấu thời gian fetch, id hoặc slug sự kiện, id hoặc slug thị trường, văn bản câu hỏi, condition id khi có, định danh token khi có, nhãn kết quả, giá kết quả, cờ active và closed, thời điểm kết thúc, thẻ, URL nguồn và hash payload. JSON thô bảo vệ Naly trước trôi dạt schema và cho phép xác minh phát lại đúng artifact thu nạp.
Chấm điểm ứng viên. Các tác vụ bài viết nên xếp hạng thị trường bằng tiêu chí biên tập, không phải tiêu chí thực thi giao dịch: độ mới, khối lượng hoặc thanh khoản khi có, mức gần thời điểm phân giải, tính sẵn có của nguồn, độ phù hợp danh mục và liệu thị trường có tạo được tương phản rõ ràng cho độc giả hay không. Chấm điểm ứng viên không bao giờ được hàm ý rằng một giá thị trường tự động là sai; nó chỉ nên đánh dấu một thị trường là đáng nghiên cứu.
Ràng buộc xuất bản. Khi một bài viết được tạo trích dẫn một thị trường, bài viết đó nên liên kết tới id ảnh chụp đã lưu, URL nguồn Polymarket và tập bằng chứng bên ngoài mà người viết đã dùng. Đây là khác biệt giữa một trang nói rằng thị trường ở mức 62 percent và một trang có thể chứng minh khi nào, ở đâu và từ payload nào giá trị đó xuất hiện.

Giới hạn tốc độ là một phần của cơ chế. Polymarket ghi rõ việc giới hạn do Cloudflare thực thi và các giới hạn Gamma cụ thể cho /events, /markets, /tags, và /public-search. Naly không cần tiến gần các giới hạn đó cho xuất bản hằng ngày, nên tư thế đúng là thận trọng: giới hạn đồng thời, thử lại với jitter, hash payload để bảo đảm idempotency, và cảnh báo khi một tác vụ nhận được phản hồi bị giới hạn, rỗng hoặc có cấu trúc bất thường.

Các tài liệu nghiên cứu nói gì

Các công trình arXiv gần đây ủng hộ thiết kế ưu tiên ảnh chụp. Jia et al. mô tả dữ liệu thị trường dự đoán phi tập trung bị phân mảnh giữa siêu dữ liệu off-chain, bản ghi giao dịch ở cấp fill và sự kiện phân giải oracle, rồi lập luận cho một hệ thống quan hệ thống nhất có phân giải định danh, cập nhật gia tăng và cơ chế nhất quán. Hệ thống xuất bản nhỏ hơn của Naly có cùng lớp vấn đề: chỉ siêu dữ liệu thị trường là chưa đủ nếu về sau nó không thể được nối với giá, tuyên bố trong bài viết và kết quả phân giải.

Nghiên cứu hiệu chỉnh của Le liên quan trực tiếp đến ngôn ngữ bài viết. Sử dụng các bộ dữ liệu Kalshi và Polymarket lớn, bài báo lập luận rằng hiệu chỉnh phụ thuộc vào lĩnh vực, thời hạn và hiệu ứng quy mô giao dịch; người tiêu dùng xem giá như xác suất nguyên trạng có thể diễn giải sai một cách có hệ thống. Với Naly, điều này có nghĩa là bài viết nên nói xác suất hàm ý từ thị trường, giá quan sát được, hoặc tín hiệu thị trường công khai, chứ không phải sự thật. Bài viết chỉ có thể thảo luận một khả năng định giá sai sau khi tách quan sát thị trường thô khỏi mô hình của Naly hoặc lập luận có nguồn hỗ trợ.

Bài báo về vi cấu trúc Polymarket của Dubach chủ yếu nói về dữ liệu sổ lệnh, nhưng đưa ra một cảnh báo hữu ích cho thiết kế thu nạp: bằng chứng thị trường tần suất cao có các dạng lỗi phụ thuộc nguồn, độ trễ thu nạp và các phép nối quan trọng. Gamma ít chi tiết hơn nguồn cấp sổ lệnh, nhưng cùng nguyên tắc vẫn áp dụng. Nguồn gốc của một con số phải nhìn thấy được. Một ảnh chụp Gamma, một midpoint CLOB và một bản ghi giao dịch on-chain có liên quan nhưng không thể thay thế cho nhau.

Madrigal-Cianci, Monsalve Maya, và Breakey định khung thị trường dự đoán như các bài toán nghịch đảo Bayes, trong đó lịch sử xác suất và khối lượng quan sát được là nhiễu, nội sinh và bị định hình bởi các kiểu nhà giao dịch không đồng nhất. Điều đó củng cố lập trường biên tập của Naly. Trạng thái thị trường được thu nạp là bằng chứng, không phải phán quyết. Kỹ thuật tốt khiến sự bất định đó có thể kiểm tra được thay vì xóa nhòa nó trong quá trình tạo nội dung.

Đánh đổi thiết kế

Gamma so với CLOB là đánh đổi đầu tiên. Gamma cho Naly khả năng khám phá, bối cảnh bài viết và siêu dữ liệu. CLOB cho giá sắc nét hơn và cơ chế sổ lệnh. Với các bài viết kỹ thuật hằng ngày và tổng hợp thị trường dự đoán, Gamma nên là đầu vào mặc định vì nó trả lời thị trường nói về điều gì. CLOB có thể được thêm khi bài viết cần chênh lệch giá, midpoint hoặc độ chính xác lịch sử giá.

Thu nạp ưu tiên sự kiện so với ưu tiên thị trường là đánh đổi thứ hai. Ưu tiên sự kiện rẻ hơn cho quét rộng vì một sự kiện có thể chứa nhiều thị trường và siêu dữ liệu chung. Ưu tiên thị trường sạch hơn cho xác minh vì điểm số cuối cùng gắn với một kết quả nhị phân cụ thể. Naly nên thu nạp cả hai hình dạng nhưng để liên kết bài viết trỏ tới tuyên bố cấp thị trường bất cứ khi nào một kết quả đơn lẻ đang được đánh giá.

JSON thô so với schema có kiểu là đánh đổi thứ ba. Chỉ dùng JSON thô thì dễ lưu nhưng khó truy vấn an toàn. Chỉ dùng cột có kiểu thì dễ truy vấn nhưng giòn khi trường của nhà cung cấp tiến hóa. Mẫu bền vững là dùng cả hai: trường có kiểu cho xếp hạng, hiển thị và phép nối; payload thô cho kiểm toán, phát lại và di trú.

Hiển thị trực tiếp so với hiển thị đóng băng là đánh đổi thứ tư. Một widget thị trường trực tiếp có thể hữu ích, nhưng tuyên bố trong bài viết phải ràng buộc với ảnh chụp tại thời điểm xuất bản. Nếu không, một bài viết cũ có thể âm thầm đổi nghĩa khi Polymarket dịch chuyển, đóng hoặc phân giải một thị trường. Với chiến lược niềm tin của Naly, bằng chứng đóng băng tốt hơn độ mới khi một trang đưa ra tuyên bố có mốc thời gian.

Các dạng lỗi

Lỗi nguy hiểm nhất là lệch khớp kết quả-giá. Nếu Yes và No được phân tích nhãn tách rời khỏi giá, bài viết có thể đảo ngược tín hiệu trong khi vẫn trông hợp lý.

Lỗi thứ hai là tái sử dụng thị trường đã cũ. Một thị trường có thể đang hoạt động trong lúc khám phá và đã đóng vào thời điểm xuất bản. Mỗi tác vụ bài viết nên xác thực lại các trường active, closed, archived và end-time ngay trước khi ràng buộc ảnh chụp.

Lỗi thứ ba là mơ hồ đa thị trường. Một sự kiện Polymarket có thể chứa nhiều thị trường có thể giao dịch. Một bản tổng hợp có thể trích dẫn sự kiện, nhưng bản ghi xác minh phải trích dẫn thị trường và kết quả cụ thể mà Naly đã đánh giá.

Lỗi thứ tư là trôi dạt schema. API công khai thay đổi tên trường, giá trị mặc định và quan hệ lồng nhau. Lưu trữ ảnh chụp nên bao gồm hash payload, phiên bản parser, URL nhà cung cấp và lỗi xác thực để có thể quan sát trôi dạt.

Lỗi thứ năm là tuyên bố quá mức về hiệu chỉnh. Giá thị trường là một tín hiệu công khai hữu ích, nhưng tài liệu nghiên cứu cảnh báo không nên xem nó là một xác suất sạch trên mọi lĩnh vực và thời hạn. Nội dung của Naly nên giữ rõ khác biệt giữa xác suất hàm ý từ thị trường, ước tính của Naly và kết quả thực tế.

Lỗi thứ sáu là mất trích dẫn. Nếu một bài viết chỉ lưu markdown đã render, xác minh sau này không thể chứng minh trang thị trường và payload nào đã hỗ trợ tuyên bố. Các phép nối bài viết-thị trường nên là bản ghi hạng nhất, không phải văn bản nhúng.

Ghi chú triển khai

Một triển khai thực tế của Naly có thể giữ hợp đồng thu nạp ở quy mô nhỏ:

provider: polymarket-gamma.
provider_url: endpoint Gamma chính xác hoặc URL thị trường công khai được dùng để khám phá.
fetched_at: dấu thời gian máy chủ theo UTC.
event_key và market_key: định danh hoặc slug ổn định của nhà cung cấp.
question: văn bản câu hỏi thị trường chuẩn tắc.
outcomes: nhãn có thứ tự.
outcome_prices: chuỗi thập phân có thứ tự, chỉ được chuẩn hóa thành giá trị số sau khi xác thực.
status: cờ active, closed, archived và publishability.
raw_payload: phản hồi đầy đủ của nhà cung cấp.
payload_hash: hash tất định cho idempotency và phát lại.
parser_version: hợp đồng mã đã diễn giải payload.

Trình tạo bài viết nên nhận dữ liệu này như bằng chứng có cấu trúc, không phải văn bản prompt rời rạc. Sau đó nó có thể tạo markdown thông qua stack AI hiện có, render bằng pipeline của site và giữ trích dẫn gắn với bản ghi nguồn. Một worker xác minh về sau có thể nối ảnh chụp thị trường của bài viết với dữ liệu phân giải và chấm điểm xem tuyên bố đã xuất bản có đứng vững theo thời gian hay không.

Nguyên tắc kỹ thuật cố ý thận trọng: thu nạp, chuẩn hóa, chụp ảnh, trích dẫn, rồi mới viết. Thứ tự đó chậm hơn việc yêu cầu một mô hình duyệt và tóm tắt một trang thị trường, nhưng nó tạo ra artifact mà Naly thực sự cần cho thu hút và giữ chân người dùng: một bài viết công khai mà bằng chứng thị trường có thể được phát lại sau khi kết quả đã được biết.