# Rip.fun — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Browse and search trading cards, packs, and sets while tracking real-time market prices and price history on the rip.fun marketplace. Monitor trending cards, view detailed card and pack information, check recent mystery pack pulls, and analyze price changes to stay informed on the trading card market.

**Category:** Marketplaces | **Website:** [rip.fun/](https://rip.fun/) | **Docs:** [parse.bot/marketplace/65ee62d0-08c0-4262-84a5-0b6f58964c2f/rip-fun-api](https://parse.bot/marketplace/65ee62d0-08c0-4262-84a5-0b6f58964c2f/rip-fun-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-rip-fun-api-65ee62d0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_card_activity

Fetch recent on-chain activity (mints, reveals, transfers, sales) for a specific card. Returns card instances with their ownership and activity history plus a user map for resolving wallet addresses to profiles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `card_id` | string | Yes | Card ID (e.g. 'sv8pt5-1'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rip-fun-api-65ee62d0/get_card_activity \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"card_id":"<string>"}'
```

### get_card_detail

Get full details for a specific card by its ID. Returns SvelteKit node-graph data containing card attributes, pricing, and images.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `card_id` | string | Yes | Card ID in format 'setid-number' (e.g. 'sv8pt5-1', 'ecard1-6vh'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rip-fun-api-65ee62d0/get_card_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"card_id":"<string>"}'
```

### get_card_price_change

Get 24-hour and 7-day price change percentages for a specific card, along with a human-readable analysis reason and good-buy percentage score.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `card_id` | string | Yes | Card ID in format 'setid-number' (e.g. 'sv8pt5-1', 'base1-4'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rip-fun-api-65ee62d0/get_card_price_change \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"card_id":"<string>"}'
```

### get_card_price_history

Fetch historical price data for a specific card over a configurable time range. Returns an array of timestamped price points with source and metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `card_id` | string | Yes | Card ID (e.g. 'sv8pt5-1'). |
| `range` | string | No | Time range for history. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rip-fun-api-65ee62d0/get_card_price_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"card_id":"<string>","range":"<string>"}'
```

### get_explore_sets

Browse all expansion sets available on the platform. Returns SvelteKit node-graph data containing set listings with names, logos, and random card previews.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rip-fun-api-65ee62d0/get_explore_sets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_market_trending_cards

Fetch trending cards from the marketplace homepage. Returns SvelteKit node-graph data containing trending card listings and market information.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rip-fun-api-65ee62d0/get_market_trending_cards \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_mystery_pack_recent_pulls

Fetch the global recent pulls feed from the Mystery Packs page, showing what users have recently pulled from mystery packs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of recent pulls to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rip-fun-api-65ee62d0/get_mystery_pack_recent_pulls \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### get_pack_activity

Fetch recent on-chain activity (sales, transfers, redemptions) for a specific booster pack. Returns activity records and a user map for resolving wallet addresses to profiles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `pack_id` | string | Yes | Pack ID (e.g. 'sv8pt5-pebp'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rip-fun-api-65ee62d0/get_pack_activity \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pack_id":"<string>"}'
```

### get_pack_detail

Get full details for a booster pack by its ID, including name, price, set information, and images. Returns SvelteKit node-graph data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `pack_id` | string | Yes | Pack ID (e.g. 'sv8pt5-pebp'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rip-fun-api-65ee62d0/get_pack_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pack_id":"<string>"}'
```

### get_pack_price_history

Fetch historical retail and market price data for a specific pack (TCGPlayer aggregated prices) over a configurable time range.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `pack_id` | string | Yes | Pack ID (e.g. 'sv8pt5-pebp'). |
| `range` | string | No | Time range for history. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rip-fun-api-65ee62d0/get_pack_price_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pack_id":"<string>","range":"<string>"}'
```

### get_set_cards

List all cards within a specific expansion set with market prices, sorted by price descending. Supports pagination. Returns detailed card objects including attacks, abilities, and pricing data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page. |
| `page` | integer | No | Page number for pagination. |
| `set_id` | string | Yes | Set ID (e.g. 'sv8pt5', 'ecard1'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rip-fun-api-65ee62d0/get_set_cards \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","set_id":"<string>"}'
```

### search

Full-text search across cards, packs, sets, and user profiles on rip.fun. Returns matching results in each category up to the specified limit. Query matches card names, set names, and usernames.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return per category. |
| `query` | string | Yes | Search keyword (e.g. 'charizard', 'pikachu'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rip-fun-api-65ee62d0/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```