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

# launches api

> token launch endpoints

# launches api

## launch token

```
POST /launch
```

creates a new token on pump.fun with optional atomic dev buy, bundle buys, snipers, swarm buys, and volume generation — all in one call.

### required fields

<ParamField body="token_name" type="string" required>
  token name
</ParamField>

<ParamField body="token_ticker" type="string" required>
  ticker symbol (max 10 chars)
</ParamField>

<ParamField body="metadata_uri" type="string" required>
  ipfs metadata uri (from `/ipfs/upload`)
</ParamField>

<ParamField body="dev_wallet_address" type="string" required>
  `dev` type wallet — creates the token
</ParamField>

### optional fields

<ParamField body="dev_buy_sol" type="number" default="0">
  sol for dev buy (atomic with create in same jito bundle)
</ParamField>

<ParamField body="jito_tip" type="number" default="0.0001">
  jito tip for bundle priority
</ParamField>

<ParamField body="reserved_mint_keypair" type="string">
  base58 keypair from `/launch/reserve-mint`
</ParamField>

### phase toggles

<ParamField body="bundles_enabled" type="boolean" default="false">
  enable bundle buys
</ParamField>

<ParamField body="snipers_enabled" type="boolean" default="false">
  enable sniper buys
</ParamField>

<ParamField body="regulars_enabled" type="boolean" default="false">
  enable regular buys
</ParamField>

<ParamField body="swarms_enabled" type="boolean" default="false">
  enable swarm buys
</ParamField>

<ParamField body="volumes_enabled" type="boolean" default="false">
  enable volume generation
</ParamField>

### bundle config

<ParamField body="bundle_groups" type="object[]">
  array of bundle groups
</ParamField>

<ParamField body="bundle_groups[].block_target" type="number">
  block target (0 = atomic with create)
</ParamField>

<ParamField body="bundle_groups[].wallets" type="object[]">
  `{ wallet_address, amount }` — must be `bundle` type wallets
</ParamField>

### sniper config

<ParamField body="sniper_wallets" type="object[]">
  `{ wallet_address, amount, block_target }` — must be `snipe` type wallets
</ParamField>

### auto-sell

<ParamField body="auto_sell_enabled" type="boolean" default="false">
  schedule automatic sell after launch
</ParamField>

<ParamField body="auto_sell_delay_secs" type="number">
  seconds before auto-sell triggers
</ParamField>

<ParamField body="auto_sell_target_pct" type="number">
  target percentage gain to trigger sell
</ParamField>

### special modes

<ParamField body="angel_mode_enabled" type="boolean" default="false">
  enable angel mode (fee sharing + buyback)
</ParamField>

<ParamField body="fee_sharing_enabled" type="boolean" default="false">
  enable pump.fun creator fee sharing
</ParamField>

## upload metadata

```
POST /ipfs/upload
```

multipart form upload. returns `metadata_uri` for use in launch.

| field         | type       | required |
| ------------- | ---------- | -------- |
| `file`        | image file | yes      |
| `name`        | string     | yes      |
| `symbol`      | string     | yes      |
| `description` | string     | no       |
| `twitter`     | string     | no       |
| `telegram`    | string     | no       |
| `website`     | string     | no       |

## reserve vanity mint

```
POST /launch/reserve-mint
```

pre-generate a keypair for a vanity mint address. pass the `reserved_mint_keypair` to the launch endpoint.

## history

```
GET /launch/history
```

<ParamField query="limit" type="number" default="20">
  max results
</ParamField>

## launch details

```
GET /launch/:id
```

returns full launch details including all phases and their results.

## launch wallets

```
GET /launch/:id/wallets
```

returns all wallets that participated in a launch.

## launch by token

```
GET /launch/by-token/:token_mint
```

look up a launch by its token mint address.

## saved configs

```
GET /launch/configs              → list saved configs
PUT /launch/configs              → save config
DELETE /launch/configs/:name     → delete config
```

save and load launch configurations for quick reuse.