Search active RocketVault card listings
search_marketplace_listingsRead-only
Searches anonymous public active listings with structured card and budget filters. At least one card identity filter is required; field schemas describe exact and substring matching. Results include public listing IDs, freshness, and current asking prices rather than sold comps. More than 100 matches sets refinement_required=true and returns no next cursor. Availability and prices can change after retrieval.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | recent | |
| team | No | Case-insensitive substring match against the stored team. | |
| year | No | Exact card year. | |
| brand | No | Case-insensitive substring match against the stored brand. | |
| grade | No | Exact stored grade string, such as 10 or 9.5. | |
| query | No | Full-text search across public listing card details; results are not exact-card matches by themselves. | |
| sport | No | Case-insensitive exact match against the stored sport. | |
| cursor | No | ||
| player | No | Case-insensitive substring match against the stored player name. | |
| max_year | No | Inclusive upper bound for card year. | |
| min_year | No | Inclusive lower bound for card year. | |
| parallel | No | Case-insensitive substring match against the stored parallel. | |
| set_name | No | Case-insensitive substring match against the stored set name. | |
| is_insert | No | ||
| is_rookie | No | ||
| page_size | No | ||
| raw_graded | No | ||
| card_number | No | Exact card-number match; one leading # is ignored by the marketplace. | |
| is_numbered | No | ||
| is_autograph | No | ||
| accepts_offers | No | ||
| grading_company | No | Case-insensitive exact grading-company match. | |
| max_price_cents | No | Maximum asking price in USD cents. | |
| min_price_cents | No | Minimum asking price in USD cents. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| listings | Yes | ||
| page_size | Yes | ||
| next_cursor | Yes | ||
| total_matches | Yes | ||
| refinement_required | Yes | ||
| marketplace_available | Yes |