Reference

API

Public read-only API. All endpoints return JSON and are cached for 60 seconds unless noted. Please credit ps99rap if you're using the API's.

Base URL https://ps99rap.com

Items

GET /api/items

Returns all tracked items with their current data.

Returns

Object mapping item ID -> item object (name, rap, exists, category, modifiers, ...)

GET /api/items/bulk

Returns rap and exists for a list of item IDs.

Parameters

ids query Comma-separated item IDs required

Returns

Object mapping item ID -> { rap, exists }

GET /api/items/rap_histories

Returns RAP history for multiple items.

Parameters

ids query Comma-separated item IDs required

last query Number of most recent data points to return. Defaults to 0 (all).

Returns

Object mapping item ID -> [[timestamp, rap], ...]

GET /api/items/exists_histories

Returns exists (supply) history for multiple items.

Parameters

ids query Comma-separated item IDs required

last query Number of most recent data points to return. Defaults to 0 (all).

Returns

Object mapping item ID -> [[timestamp, exists], ...]

GET /api/items/exists_rates

Returns the current exists growth rate (per hour) for all items that have one.

Returns

Object mapping item ID -> rate (number, exists/hr)

GET /api/search

Returns the full search index. Useful for autocomplete.

Returns

Object mapping item ID -> name string

GET /api/meta

Returns tier and variant metadata for items that have it. Omits items with no special tier or variant.

Returns

Object mapping item ID -> { t?: 'huge'|'titanic'|'gargantuan', v?: 'shiny'|'golden'|'rainbow'|'shiny_golden'|'shiny_rainbow' }

GET /api/item/{base_id}

Returns full data for a single item.

Parameters

base_id path Item ID, e.g. Huge_Cat required

Returns

{ success, data: item object }

GET /api/item/{base_id}/rap_history

Returns full RAP history for a single item.

Parameters

base_id path Item ID required

Returns

{ success, data: [[timestamp, rap], ...] }

GET /api/item/{base_id}/exists_history

Returns full exists (supply) history for a single item.

Parameters

base_id path Item ID required

Returns

{ success, data: [[timestamp, exists], ...] }

GET /api/item/{base_id}/variants

Returns all variants of an item (regular, golden, rainbow, shiny) or tiers if applicable.

Parameters

base_id path Base item ID without variant prefix required

Returns

{ success, data: [item objects], kind: 'variants'|'tiers' }

Market

GET /api/market

Returns time-series data for market-wide stats: market cap, total/huge/titanic/gargantuan exists and index histories.

Returns

{ market_cap_history, total_exists_history, huge_exists_history, titanic_exists_history, gargantuan_exists_history, huge_index_history, titanic_index_history, gargantuan_index_history } - each [[timestamp, value], ...]

GET /api/movers

Returns the top RAP and exists movers per item category over the past 24 hours.

Returns

Object with category keys, each containing rap and exists arrays of top movers

GET /api/tier_rates

Returns the linear regression exists growth rate (per hour) for Huge, Titanic, and Gargantuan tiers based on recent history.

Returns

{ huge: number|null, titanic: number|null, gargantuan: number|null }

Enchants

GET /api/enchants

Returns all enchants with RAP, power, diminishing threshold, empowered boost, and category.

Returns

Object mapping enchant ID -> { name, rap, power, diminish_power_threshold, empowered_boost, internal_category }

Tools

GET /api/eggs

Returns all eggs with their pet pools and estimated hatch percentages derived from exists counts.

Returns

Object mapping egg ID -> { name, pets: [[pet_id, weight, estimated_pct], ...], ... }

GET /api/get/exclusive-daycare

Returns all Huge, Titanic, and Gargantuan items with rap, exists, normal_exists, variant, and type - used for daycare cost calculations.

Returns

Array of { id, name, rap, exists, normal_exists, variant, type }