# PokeAPI on Onekey

> 12 endpoints for PokeAPI (12 stable, 0 beta), 1 to 5 credits each. Category: Gaming. One key, one JSON shape.

Base URL: https://api.onekey.dev
Auth: header `x-api-key: <key>`. Call shape: `GET /v1/{platform}/{endpoint}?{params}`.
Every response is `{success, data, metadata, error}`; check `success` first. Cost is in `metadata.credits_charged`. Free when served from cache (0.2 credit for a cached response over 100 KB). Failed and not-found calls are refunded.
Status: stable = verified against the live source; beta = not yet verified, fields may be missing.

Page: https://onekey.dev/platforms/pokeapi
Reference (Markdown): https://onekey.dev/docs/api/pokeapi.md
All docs: https://onekey.dev/llms.txt

## Canonical fields returned

Unified-schema fields (same names on every platform), with how many of the 12 mapped PokeAPI endpoints return each:

- `entity.name` (string): 12
- `entity.id` (string): 11
- `entity.description` (string): 4
- `entity.type` (string): 2
- `media.thumbnailUrl` (URL): 2
- `entity.category` (string): 1
- `entity.url` (URL): 1
- plus 25 platform-specific fields under `ext.`

## Endpoints

### pokeapi.ability

Pokemon ability.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/pokeapi/ability?name=static` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `name` (string, required): Lowercase name or numeric id
- Fields returned: `entity.id`, `entity.name`, `entity.description`, `ext.generation`
- Reference: https://onekey.dev/docs/api/pokeapi/ability.md

### pokeapi.berry

Pokemon berry.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/pokeapi/berry?name=cheri` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `name` (string, required): Lowercase name or numeric id
- Fields returned: `entity.id`, `entity.name`, `ext.growthTime`, `ext.maxHarvest`, `ext.size`, `ext.firmness`
- Reference: https://onekey.dev/docs/api/pokeapi/berry.md

### pokeapi.evolution_chain

Pokemon evolution chain by chain id.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/pokeapi/evolution_chain?name=1` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `name` (string, required): Lowercase name or numeric id
- Fields returned: `entity.id`, `entity.name`, `ext.evolvesTo`
- Reference: https://onekey.dev/docs/api/pokeapi/evolution_chain.md

### pokeapi.generation

Pokemon generation.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/pokeapi/generation?name=1` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `name` (string, required): Lowercase name or numeric id
- Fields returned: `entity.id`, `entity.name`, `ext.region`, `ext.firstPokemon`
- Reference: https://onekey.dev/docs/api/pokeapi/generation.md

### pokeapi.item

Pokemon item.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/pokeapi/item?name=potion` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `name` (string, required): Lowercase name or numeric id
- Fields returned: `entity.id`, `entity.name`, `entity.category`, `entity.description`, `media.thumbnailUrl`, `ext.cost`
- Reference: https://onekey.dev/docs/api/pokeapi/item.md

### pokeapi.location

Pokemon world location.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/pokeapi/location?name=canalave-city` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `name` (string, required): Lowercase name or numeric id
- Fields returned: `entity.id`, `entity.name`, `ext.region`, `ext.area`
- Reference: https://onekey.dev/docs/api/pokeapi/location.md

### pokeapi.move

Pokemon move.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/pokeapi/move?name=thunderbolt` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `name` (string, required): Lowercase name or numeric id
- Fields returned: `entity.id`, `entity.name`, `entity.type`, `entity.description`, `ext.power`, `ext.accuracy`, `ext.pp`, `ext.damageClass`
- Reference: https://onekey.dev/docs/api/pokeapi/move.md

### pokeapi.nature

Pokemon nature.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/pokeapi/nature?name=adamant` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `name` (string, required): Lowercase name or numeric id
- Fields returned: `entity.id`, `entity.name`, `ext.increasedStat`, `ext.decreasedStat`
- Reference: https://onekey.dev/docs/api/pokeapi/nature.md

### pokeapi.pokemon

Pokemon by name or id.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/pokeapi/pokemon?name=pikachu` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `name` (string, required): Lowercase name or numeric id
- Fields returned: `entity.id`, `entity.name`, `entity.type`, `media.thumbnailUrl`, `ext.height`, `ext.weight`, `ext.baseExperience`, `ext.ability`
- Reference: https://onekey.dev/docs/api/pokeapi/pokemon.md

### pokeapi.pokemon_list

Paginated list of Pokemon names.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/pokeapi/pokemon_list` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `offset` (string, optional, default 0): Offset (0-99999)
- Fields returned: `entity.name`, `entity.url`
- Reference: https://onekey.dev/docs/api/pokeapi/pokemon_list.md

### pokeapi.species

Pokemon species (habitat, legendary flags, flavor text).
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/pokeapi/species?name=pikachu` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `name` (string, required): Lowercase name or numeric id
- Fields returned: `entity.id`, `entity.name`, `entity.description`, `ext.color`, `ext.habitat`, `ext.generation`, `ext.legendary`, `ext.captureRate`
- Reference: https://onekey.dev/docs/api/pokeapi/species.md

### pokeapi.type

Pokemon type and its first damage relation.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/pokeapi/type?name=electric` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `name` (string, required): Lowercase name or numeric id
- Fields returned: `entity.id`, `entity.name`, `ext.generation`, `ext.strongAgainst`
- Reference: https://onekey.dev/docs/api/pokeapi/type.md

## Sample request

```bash
curl "https://api.onekey.dev/v1/pokeapi/ability?name=static" \
  -H "x-api-key: YOUR_API_KEY"
```