> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inkyswap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Overview

> What APIs InkyPump exposes and which one to use for what.

InkyPump exposes three things you can integrate against:

1. The V2 smart contracts on Ink mainnet
2. The InkyPump REST API at `inkypump.com`
3. The InkyPump MCP server, a stdio server for editors like Claude Code and Codex

Pick based on what you are building.

## When to use each

| You want to...                                   | Use                                               |
| ------------------------------------------------ | ------------------------------------------------- |
| Read token state, list tokens, fetch leaderboard | [InkyPump REST API](#inkypump-rest-api)           |
| Launch or trade tokens from a backend            | [V2 contracts](/api-reference/contracts/overview) |
| Read swap quotes for the broader InkySwap DEX    | [InkySwap REST API](#inkyswap-rest-api)           |
| Drive InkyPump from your editor or an AI agent   | [MCP server](/api-reference/mcp)                  |

## V2 contracts

Direct contract integration. Read state, broadcast trades, listen for events.

| Resource         | Address (Ink mainnet)                        |
| ---------------- | -------------------------------------------- |
| InkyPump V2 hook | `0x4cC8F6d5B7cE150CCC0A9B7664532B1283b96AC4` |
| RPC              | `https://rpc-gel.inkonchain.com`             |

For full surface and examples, see [Contracts Overview](/api-reference/contracts/overview).

## InkyPump REST API

JSON over HTTPS at `https://inkypump.com`. No auth required for read endpoints. Image uploads require a captcha token.

| Endpoint                                      | Returns                                              |
| --------------------------------------------- | ---------------------------------------------------- |
| `GET /api/tokens/recent-v2?limit=N`           | Recently launched V2 tokens                          |
| `GET /api/token?address=0x...`                | Token details, V1 or V2                              |
| `GET /api/tokens/by-owner?owner=0x...`        | Tokens created by an address                         |
| `GET /api/tokens/batch?addresses=0x...,0x...` | Token details for a list of addresses                |
| `GET /api/leaderboard?limit=N`                | Aggregated points and rankings                       |
| `GET /api/referral/stats?address=0x...`       | Referral attribution stats for a wallet              |
| `GET /api/eoti`                               | Current Emperor of the INK                           |
| `GET /api/eoti?includeBidData=true`           | Current Emperor plus open auction bid data           |
| `GET /api/koti`                               | Current King of the INK (top performing curve)       |
| `POST /api/upload`                            | Image upload (token logos, requires Turnstile token) |
| `GET /api/chat?tokenAddress=0x...&limit=N`    | Token chat messages                                  |

See the [InkyPump API](/api-reference/inkypump/get-token) section for per endpoint pages.

## InkySwap REST API

Separate from InkyPump. Covers the wider InkySwap DEX on Ink.

| Endpoint          | Returns                  |
| ----------------- | ------------------------ |
| `GET /api/pairs`  | InkySwap liquidity pairs |
| `GET /api/quote`  | Swap quote for the DEX   |
| `GET /api/tokens` | Listed tokens on the DEX |

See [InkySwap API](/api-reference/inkyswap/get-pairs).

## MCP server

A stdio MCP at the `@inkyswap/pump-mcp` npm package. Runs locally. Connects to your editor and exposes V2 tools (`launch_token`, `preview_launch`, `wallet_info`, `recent_launches`, `launch_status`).

See [MCP Server](/api-reference/mcp).

## Versions

The V2 contracts are the current launch system. V1 contracts still respond to read calls. Anything tagged "V2" on this page is the live system. Anything tagged "V1" is documented for compatibility.