Polyhub-skills polyhub-discover

Query Polyhub public discover APIs for tags, trader rankings, trader detail by address, and market tag lookup by condition IDs.

install

source · Clone the upstream repo

git clone https://github.com/HubbleVision/polyhub-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/HubbleVision/polyhub-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/codex/skills/polyhub-discover" ~/.claude/skills/hubblevision-polyhub-skills-polyhub-discover && rm -rf "$T"

manifest: codex/skills/polyhub-discover/SKILL.md

source content

Polyhub Discover

Version: v0.3.8

Use this skill when the user wants public discover data from Polyhub.

Requirements

```
curl
```
is available.
```
POLYHUB_API_KEY
```
is not required.

POLYHUB_API_BASE_URL

is fixed to

https://polyhub.skill-test.bedev.hubble-rpc.xyz

Workflow

Use the terminal to call Polyhub public APIs with
```
curl
```
.
Only pass filters the user explicitly requested.
Summarize results clearly instead of dumping raw JSON when the response is large.
The API returns
```
ALL-HUBBLE
```
as an internal tag name. Always display it as All Markets (or 全部市场) to the user.

Base Setup

BASE="https://polyhub.skill-test.bedev.hubble-rpc.xyz"

Intent Mapping

List discover tags:
```
GET /api/v1/markets/tags
```
List traders by tag:
```
GET /api/v1/traders-v2/
```
Look up trader stats by address:
```
GET /api/v1/traders/by-address
```
Look up market tags by condition IDs:
```
GET /api/v1/markets/by-condition-ids
```

Common Calls

List tags

curl -sS --fail-with-body "$BASE/api/v1/markets/tags"

List traders for a tag

Required params:

```
tag
```
```
time_range
```
:
```
all
```
or
```
30d
```

Optional params:

```
limit
```
```
offset
```
```
filterBots
```
```
sort_by
```
```
sort_direction
```
numeric range filters such as
```
pnl_min
```
,
```
roi_min
```
,
```
trade_count_30_min
```

curl -sS --fail-with-body \
  "$BASE/api/v1/traders-v2/?tag=Politics&time_range=all&limit=10&offset=0"

Guidance:

Use
```
tag=CROSS-TAG
```
when the user wants cross-tag discover results.
Use
```
time_range=30d
```
for recent performance.
Prefer descending sort unless the user asked otherwise.

Trader detail by address

curl -sS --fail-with-body \
  "$BASE/api/v1/traders/by-address?user_id=0x1234..."

Market tag lookup by condition IDs

Validation:

```
ids
```
must be non-empty.
Limit to
```
200
```
IDs per request.

curl -sS --fail-with-body \
  "$BASE/api/v1/markets/by-condition-ids?ids=0xabc,0xdef"

Error Handling

```
400
```
: invalid params
```
500
```
: backend query failed or unavailable