带筛选的榜单
按盈亏排名的实体。未购买的实体显示代号和解锁价(revealCents)。无密钥:20 行样本。有密钥:每次最多 200 行;每次调用扣除 limit 行,每日额度为 20,000 行(用完返回 403)。mine=1 列出你解锁过的地址,免费。绝不扣费。
查询参数
GET /v1/periods 给出的窗口 ID(30d 或 7d)。默认 30d。未知值返回 400。
排序字段。默认 realizedPnl;无效值按 realizedPnl 排序。
可选值: realizedPnlroiOnBuyseligiblewinsLossesnFillsconditionsgrossBuyUsdcunrealizedPnlwinLofillsPerDaylastFill
排序方向。除 asc 外均按 desc。
可选值: ascdesc
返回行数,范围 1-200(匿名上限 20)。超出范围返回 400。有密钥时,无论实际返回多少行,均按此值扣除每日行数额度。
取值范围: 1 <= x <= 200
跳过的行数,0-100000(匿名固定为 0)。
取值范围: 0 <= x <= 100000
设为 1 时只列你解锁过的地址(需要密钥,否则 401)。不扣行数额度;minEligible 默认为 0。
可选值: 1
已结算市场数下限(胜 + 负 + 持平)。默认 5。
取值范围: 0 <= x <= 100000
胜负场次下限(不含持平)。不传表示不限;网站用 10。
取值范围: 0 <= x <= 100000
已实现盈亏下限(美元)。可以为负。
取值范围: -1000000000000 <= x <= 1000000000000
按买入额计算的 ROI 下限(0.2 = 20%)。
取值范围: -100 <= x <= 1000000
胜率 Wilson 95% 下界的下限。
取值范围: 0 <= x <= 1
实体在窗口内参与交易的地址数上限(1 = 单一地址)。
取值范围: 1 <= x <= 100000
窗口内成交笔数下限。
取值范围: 0 <= x <= 1000000000000
窗口内买入总额下限,单位美元(grossBuyUsdc)。
取值范围: 0 <= x <= 1000000000000000
按最近成交时间划分:不足 24 小时为 active,不足 7 天为 quiet,更早为 dormant。
可选值: activequietdormant
按 maker 成交金额占总成交额的比例划分:>=0.8 为 maker,<=0.2 为 taker,其余为 two-sided。
可选值: makertakertwo-sided
窗口内交易过这个类别的实体。
可选值: crypto-updowncryptoesportssportspoliticseconomygeopoliticsscience-techcultureotherunknown
需同时传 category(否则返回 400)。该类别成交额占比的下限,范围为 (0, 1]。
取值范围: x <= 1
解锁价位,逗号分隔,命中任一即可(0 = 免费 … 5)。无论 period 取何值,均按 30d 窗口定价。
返回字段
anon = 没有有效密钥;subscriber = 有生效的推送订阅或套餐。
可选值: anonfreesubscriber
当前账户的套餐和剩余解锁额度(登录后返回)。
匿名 20 行样本时为 true。
实际生效的筛选条件。
可选值: realizedPnlroiOnBuyseligiblewinsLossesnFillsconditionsgrossBuyUsdcunrealizedPnlwinLofillsPerDaylastFill
可选值: ascdesc
该窗口所用账本的第一个 UTC 日。
窗口内的实体数(不随筛选变化)。mine=1 时是你解锁过的地址数。
仅 mine=1 的第一页返回:已解锁但在该窗口内没有成交的地址。
状态码
message 说明应传什么。retry-after 响应头。