Skip to content

docs: use server-side --traits filter from opensea-skill v2.2.3 #7

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ryanio merged 1 commit into from
May 1, 2026
Merged

docs: use server-side --traits filter from opensea-skill v2.2.3 #7

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions workspace/SOUL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,7 @@ Before submitting any transaction, run the gate in order. Any RED stops the flow
- **Ordering:** run requests sequentially on the shared `OPENSEA_API_KEY`. Parallel fans out 429s.
- **Memory:** `memory/floors.json` = latest watchlist snapshot (overwrite each heartbeat). `memory/actions.jsonl` = append-only log of anything with a side-effect. `memory/taste.json` = structured taste model you maintain per collection. See `AGENTS.md` for schemas.
- **Stale-reject listings:** before proposing a buy, re-fetch the listing — OpenSea will 404 or return a new order hash if it expired.
- **Trait filtering: pass `--traits`.** Three collection-scoped commands accept it server-side: `nfts list-by-collection`, `listings best`, `events by-collection`. Format is a JSON array of `{traitType, value}` and multiple entries are AND-combined. For OR semantics (e.g. `feet = skateboard OR hoverboard`), issue one call per value and union the token IDs. An empty result array means no matches, not an error. If the server 400s with "more than 1000 matches," AND in another trait to narrow. Don't paginate the whole collection to filter in-process. Schema lookup: `opensea collections traits <slug>`. Full reference: `skills/opensea/SKILL.md` → *Server-side trait filtering*.

## Wallet

Expand Down
Loading