polybaskets-overview

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

PolyBaskets Overview

PolyBaskets 概述

What Is PolyBaskets

什么是PolyBaskets

PolyBaskets is an ETF-style prediction market aggregator on Vara Network. It bundles multiple Polymarket outcomes into a single weighted basket — a portfolio in one trade.

PolyBaskets 是 Vara Network 上一款ETF式预测市场聚合器。它将多个Polymarket的结果打包到一个单一的加权篮子中——一次交易即可完成一个投资组合的配置。

The Agent Loop

Agent 流程

Claim CHIP  →  Search markets  →  Build basket  →  Create on-chain  →  Bet  →  Wait  →  Claim payout

Claim CHIP — free daily token claim with streak bonuses (consecutive days = more CHIP)
Search Polymarket — find interesting active markets via the Gamma API
Build your basket — pick 1-10 markets, choose YES/NO for each, assign percentage weights (must sum to 100%)
Create basket on-chain — submit your basket to the BasketMarket contract (returns a basket ID)
Approve + Bet — approve CHIP spend for BetLane, get a signed quote, place your bet (one bet covers the whole basket)
Wait — markets resolve on Polymarket, settler proposes on-chain settlement
Claim — if settlement index > your entry index, you profit. Collect payout.
Repeat — claim more CHIP tomorrow, bet on your own or someone else's basket

You can also skip steps 2-4 and bet on an existing basket created by another user.

领取CHIP  →  搜索市场  →  创建篮子  →  链上创建  →  下注  →  等待  →  领取赔付

领取CHIP — 每日免费领取代币，连续领取可获得 streak 奖励（连续天数越多，领取的CHIP越多）
搜索Polymarket — 通过Gamma API查找感兴趣的活跃市场
创建你的篮子 — 选择1-10个市场，为每个市场选择YES/NO选项，分配百分比权重（权重总和必须为100%）
链上创建篮子 — 将你的篮子提交至BasketMarket合约（返回一个篮子ID）
授权+下注 — 授权BetLane使用CHIP，获取签名报价，进行下注（一次下注覆盖整个篮子）
等待 — Polymarket上的市场完成结算，结算者在链上发起结算提案
领取赔付 — 如果结算指数大于你的入场指数，即可获利。领取赔付金额。
重复操作 — 次日领取更多CHIP，下注自己或其他用户创建的篮子

你也可以跳过步骤2-4，直接下注其他用户已创建的篮子。

CHIP Token

CHIP代币

CHIP is the platform's free betting token (BetToken contract). Agents earn CHIP through:

Daily claim — call
```
BetToken/Claim
```
once per day
Streak bonuses — each consecutive day increases the claim amount by
```
streak_step
```
up to
```
streak_cap_days
```
Winning bets — payouts from settled baskets

CHIP is used to bet on baskets via the BetLane contract (approve CHIP → place bet).

CHIP是平台的免费下注代币（基于BetToken合约）。Agent可通过以下方式获取CHIP：

每日领取 — 每日调用一次
```
BetToken/Claim
```
接口
连续领取奖励 — 每多连续领取一天，领取金额会增加
```
streak_step
```
，直至达到
```
streak_cap_days
```
上限
下注获胜 — 已结算篮子的赔付金额

CHIP通过BetLane合约用于篮子下注（授权CHIP使用 → 下注）。

Core Concepts

核心概念

Basket

篮子

A named collection of 1-10 Polymarket outcomes with percentage weights (must sum to 100%). Each item specifies:

A Polymarket market (by numeric ID and slug)
A selected outcome (YES or NO)
A weight in basis points (e.g. 40% = 4000 bps, all must sum to 10000 bps = 100%)

一个命名的集合，包含1-10个带百分比权重的Polymarket结果（权重总和必须为100%）。每个条目需指定：

一个Polymarket市场（通过数字ID和slug标识）
选定的结果（YES或NO）
基点权重（例如40% = 4000基点，所有权重总和必须为10000基点 = 100%）

Basket Index

篮子指数

The index is a weighted probability score:

index = sum( weight_bps[i] / 10000 * probability[i] )

Ranges from 0.0 to 1.0. When a user bets, the current index is recorded on their

Position

index_at_creation_bps

(u16, 1-10000). The basket itself does not store an index — it is computed from live Polymarket prices.

See

../references/index-math.md

for formulas and worked examples.

指数是一个加权概率得分：

index = sum( weight_bps[i] / 10000 * probability[i] )

取值范围为0.0到1.0。用户下注时，当前指数会被记录在其

Position

中，作为

index_at_creation_bps

（16位无符号整数，取值1-10000）。篮子本身不存储指数——它是根据Polymarket实时价格计算得出的。

有关公式和示例，请参阅

../references/index-math.md

。

Position

持仓

A user's bet on a basket. Records:

```
shares
```
— amount of VARA (or BET tokens) wagered
```
index_at_creation_bps
```
— the basket index when the bet was placed (entry price)
```
claimed
```
— whether payout has been collected

用户对某个篮子的下注记录。包含：

```
shares
```
— 下注的VARA（或BET代币）数量
```
index_at_creation_bps
```
— 下注时的篮子指数（入场价格）
```
claimed
```
— 是否已领取赔付

Payout

赔付

After settlement:

payout = shares * (settlement_index / entry_index)

If settlement index > entry index: profit. If lower: loss.

结算后：

payout = shares * (settlement_index / entry_index)

如果结算指数大于入场指数：获利。如果低于入场指数：亏损。

Settlement Lifecycle

结算生命周期

Active  →  SettlementPending  →  Settled
           (12-min challenge)     (users can claim)

Active — basket accepts bets
SettlementPending — settler proposes resolution with each item's final outcome from Polymarket. A challenge window begins (duration configured by
```
liveness_ms
```
, default 12 minutes).
Settled — after the challenge window, settler finalizes. Users can now claim payouts.

活跃中  →  待结算  →  已结算
           （12分钟挑战期）     （用户可领取赔付）

活跃中 — 篮子接受下注
待结算 — 结算者根据Polymarket中每个条目的最终结果发起结算提案。挑战期开始（时长由
```
liveness_ms
```
配置，默认12分钟）。
已结算 — 挑战期结束后，结算者完成最终结算。用户现在可以领取赔付。

Three Programs

三个核心程序

Program	Role
BasketMarket	Core contract: baskets, VARA bets, settlements, claims
BetToken	Fungible token (BET) with daily claim and streak bonuses
BetLane	Alternative betting lane using BET tokens instead of VARA

程序	角色
BasketMarket	核心合约：篮子管理、VARA下注、结算、赔付领取
BetToken	可 fungible 代币（BET），支持每日领取和连续奖励
BetLane	替代下注通道，使用BET代币而非VARA

Two Asset Kinds

两种资产类型

Each basket has an

asset_kind

set at creation:

Bet (CHIP) — the default. Users bet with CHIP tokens via BetLane (claim daily → approve → bet). This is the primary path for agents.
Vara — users bet with native TVARA tokens via BasketMarket. May be disabled on some deployments.

The asset kind determines which program handles bets and claims for that basket.

每个篮子在创建时都会设置

asset_kind

：

Bet (CHIP) — 默认类型。用户通过BetLane使用CHIP代币下注（每日领取 → 授权 → 下注）。这是Agent的主要操作路径。
Vara — 用户通过BasketMarket使用原生TVARA代币下注。部分部署环境可能禁用此类型。

资产类型决定了哪个程序处理该篮子的下注和赔付领取操作。

Where to Go Next

下一步操作指引

Full flow (recommended):

Claim CHIP tokens:
```
../basket-bet/SKILL.md
```
(Step 1)
Search markets and create a basket:
```
../basket-create/SKILL.md
```
Approve and bet on your basket:
```
../basket-bet/SKILL.md
```
(Steps 4-5)
Browse baskets and check positions:
```
../basket-query/SKILL.md
```
Claim payout:
```
../basket-claim/SKILL.md
```

Settler role only:

Settle a basket:
```
../basket-settle/SKILL.md
```

完整流程（推荐）：

领取CHIP代币：
```
../basket-bet/SKILL.md
```
（步骤1）
搜索市场并创建篮子：
```
../basket-create/SKILL.md
```
授权并下注你的篮子：
```
../basket-bet/SKILL.md
```
（步骤4-5）
浏览篮子并查看持仓：
```
../basket-query/SKILL.md
```
领取赔付：
```
../basket-claim/SKILL.md
```

仅结算者角色：

结算篮子：
```
../basket-settle/SKILL.md
```