Launch a coin in one call

curl --request POST \
  --url https://runners.family/api/launch/create \
  --header 'Content-Type: application/json' \
  --data '
{
  "owner": "So11111111111111111111111111111111111111112",
  "name": "<string>",
  "symbol": "<string>",
  "image": "<string>",
  "description": "",
  "website": "",
  "x": "",
  "telegram": "",
  "quoteMint": "So11111111111111111111111111111111111111112",
  "firstBuy": "1000000",
  "slippageBps": 2500
}
'

import requests

url = "https://runners.family/api/launch/create"

payload = {
    "owner": "So11111111111111111111111111111111111111112",
    "name": "<string>",
    "symbol": "<string>",
    "image": "<string>",
    "description": "",
    "website": "",
    "x": "",
    "telegram": "",
    "quoteMint": "So11111111111111111111111111111111111111112",
    "firstBuy": "1000000",
    "slippageBps": 2500
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    owner: 'So11111111111111111111111111111111111111112',
    name: '<string>',
    symbol: '<string>',
    image: '<string>',
    description: '',
    website: '',
    x: '',
    telegram: '',
    quoteMint: 'So11111111111111111111111111111111111111112',
    firstBuy: '1000000',
    slippageBps: 2500
  })
};

fetch('https://runners.family/api/launch/create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://runners.family/api/launch/create",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'owner' => 'So11111111111111111111111111111111111111112',
    'name' => '<string>',
    'symbol' => '<string>',
    'image' => '<string>',
    'description' => '',
    'website' => '',
    'x' => '',
    'telegram' => '',
    'quoteMint' => 'So11111111111111111111111111111111111111112',
    'firstBuy' => '1000000',
    'slippageBps' => 2500
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://runners.family/api/launch/create"

	payload := strings.NewReader("{\n  \"owner\": \"So11111111111111111111111111111111111111112\",\n  \"name\": \"<string>\",\n  \"symbol\": \"<string>\",\n  \"image\": \"<string>\",\n  \"description\": \"\",\n  \"website\": \"\",\n  \"x\": \"\",\n  \"telegram\": \"\",\n  \"quoteMint\": \"So11111111111111111111111111111111111111112\",\n  \"firstBuy\": \"1000000\",\n  \"slippageBps\": 2500\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://runners.family/api/launch/create")
  .header("Content-Type", "application/json")
  .body("{\n  \"owner\": \"So11111111111111111111111111111111111111112\",\n  \"name\": \"<string>\",\n  \"symbol\": \"<string>\",\n  \"image\": \"<string>\",\n  \"description\": \"\",\n  \"website\": \"\",\n  \"x\": \"\",\n  \"telegram\": \"\",\n  \"quoteMint\": \"So11111111111111111111111111111111111111112\",\n  \"firstBuy\": \"1000000\",\n  \"slippageBps\": 2500\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://runners.family/api/launch/create")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"owner\": \"So11111111111111111111111111111111111111112\",\n  \"name\": \"<string>\",\n  \"symbol\": \"<string>\",\n  \"image\": \"<string>\",\n  \"description\": \"\",\n  \"website\": \"\",\n  \"x\": \"\",\n  \"telegram\": \"\",\n  \"quoteMint\": \"So11111111111111111111111111111111111111112\",\n  \"firstBuy\": \"1000000\",\n  \"slippageBps\": 2500\n}"

response = http.request(request)
puts response.read_body

{
  "transaction": "<string>",
  "mint": "So11111111111111111111111111111111111111112",
  "pool": "So11111111111111111111111111111111111111112",
  "config": "So11111111111111111111111111111111111111112",
  "quoteMint": "So11111111111111111111111111111111111111112",
  "mode": "standard",
  "blockhash": "<string>",
  "lastValidBlockHeight": "<string>",
  "metadataUri": "<string>",
  "costs": {
    "configRent": "1000000",
    "poolRent": "1000000",
    "totalRent": "1000000",
    "firstBuyRent": "1000000",
    "wrappedSolRent": "<string>"
  },
  "firstBuyQuote": {
    "amountIn": "1000000",
    "tokensOut": "1000000",
    "minimumOut": "1000000",
    "supplyBps": 123,
    "slippageBps": 123
  }
}

{
  "error": "<string>",
  "code": "request_invalid"
}

{
  "error": "<string>",
  "code": "request_invalid"
}

{
  "error": "<string>",
  "code": "request_invalid"
}

{
  "error": "<string>",
  "code": "request_invalid"
}

{
  "error": "<string>",
  "code": "request_invalid"
}

{
  "error": "<string>",
  "code": "request_invalid"
}

POST

api

launch

create

Launch a coin in one call

curl --request POST \
  --url https://runners.family/api/launch/create \
  --header 'Content-Type: application/json' \
  --data '
{
  "owner": "So11111111111111111111111111111111111111112",
  "name": "<string>",
  "symbol": "<string>",
  "image": "<string>",
  "description": "",
  "website": "",
  "x": "",
  "telegram": "",
  "quoteMint": "So11111111111111111111111111111111111111112",
  "firstBuy": "1000000",
  "slippageBps": 2500
}
'

import requests

url = "https://runners.family/api/launch/create"

payload = {
    "owner": "So11111111111111111111111111111111111111112",
    "name": "<string>",
    "symbol": "<string>",
    "image": "<string>",
    "description": "",
    "website": "",
    "x": "",
    "telegram": "",
    "quoteMint": "So11111111111111111111111111111111111111112",
    "firstBuy": "1000000",
    "slippageBps": 2500
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    owner: 'So11111111111111111111111111111111111111112',
    name: '<string>',
    symbol: '<string>',
    image: '<string>',
    description: '',
    website: '',
    x: '',
    telegram: '',
    quoteMint: 'So11111111111111111111111111111111111111112',
    firstBuy: '1000000',
    slippageBps: 2500
  })
};

fetch('https://runners.family/api/launch/create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://runners.family/api/launch/create",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'owner' => 'So11111111111111111111111111111111111111112',
    'name' => '<string>',
    'symbol' => '<string>',
    'image' => '<string>',
    'description' => '',
    'website' => '',
    'x' => '',
    'telegram' => '',
    'quoteMint' => 'So11111111111111111111111111111111111111112',
    'firstBuy' => '1000000',
    'slippageBps' => 2500
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://runners.family/api/launch/create"

	payload := strings.NewReader("{\n  \"owner\": \"So11111111111111111111111111111111111111112\",\n  \"name\": \"<string>\",\n  \"symbol\": \"<string>\",\n  \"image\": \"<string>\",\n  \"description\": \"\",\n  \"website\": \"\",\n  \"x\": \"\",\n  \"telegram\": \"\",\n  \"quoteMint\": \"So11111111111111111111111111111111111111112\",\n  \"firstBuy\": \"1000000\",\n  \"slippageBps\": 2500\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://runners.family/api/launch/create")
  .header("Content-Type", "application/json")
  .body("{\n  \"owner\": \"So11111111111111111111111111111111111111112\",\n  \"name\": \"<string>\",\n  \"symbol\": \"<string>\",\n  \"image\": \"<string>\",\n  \"description\": \"\",\n  \"website\": \"\",\n  \"x\": \"\",\n  \"telegram\": \"\",\n  \"quoteMint\": \"So11111111111111111111111111111111111111112\",\n  \"firstBuy\": \"1000000\",\n  \"slippageBps\": 2500\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://runners.family/api/launch/create")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"owner\": \"So11111111111111111111111111111111111111112\",\n  \"name\": \"<string>\",\n  \"symbol\": \"<string>\",\n  \"image\": \"<string>\",\n  \"description\": \"\",\n  \"website\": \"\",\n  \"x\": \"\",\n  \"telegram\": \"\",\n  \"quoteMint\": \"So11111111111111111111111111111111111111112\",\n  \"firstBuy\": \"1000000\",\n  \"slippageBps\": 2500\n}"

response = http.request(request)
puts response.read_body

{
  "transaction": "<string>",
  "mint": "So11111111111111111111111111111111111111112",
  "pool": "So11111111111111111111111111111111111111112",
  "config": "So11111111111111111111111111111111111111112",
  "quoteMint": "So11111111111111111111111111111111111111112",
  "mode": "standard",
  "blockhash": "<string>",
  "lastValidBlockHeight": "<string>",
  "metadataUri": "<string>",
  "costs": {
    "configRent": "1000000",
    "poolRent": "1000000",
    "totalRent": "1000000",
    "firstBuyRent": "1000000",
    "wrappedSolRent": "<string>"
  },
  "firstBuyQuote": {
    "amountIn": "1000000",
    "tokensOut": "1000000",
    "minimumOut": "1000000",
    "supplyBps": 123,
    "slippageBps": 123
  }
}

{
  "error": "<string>",
  "code": "request_invalid"
}

{
  "error": "<string>",
  "code": "request_invalid"
}

{
  "error": "<string>",
  "code": "request_invalid"
}

{
  "error": "<string>",
  "code": "request_invalid"
}

{
  "error": "<string>",
  "code": "request_invalid"
}

{
  "error": "<string>",
  "code": "request_invalid"
}

Body

application/json

The coin's details and image. Name, symbol, description and links follow the metadata rules in the Launch a coin guide.

owner

string

required

The creator's wallet; it signs the returned transaction and pays.

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$

Example:

"So11111111111111111111111111111111111111112"

name

string

required

symbol

string

required

Pattern: ^[A-Z0-9]{1,10}$

image

string

required

Image bytes: PNG, JPEG, GIF or WebP, at most 5 MiB and 4096 x 4096 pixels.

imageType

enum<string>

required

Available options:

image/png,

image/jpeg,

image/gif,

image/webp

description

string

default:""

website

string

default:""

string

default:""

string

default:""

quoteMint

string

Pair token; defaults to SOL.

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$

Example:

"So11111111111111111111111111111111111111112"

mode

enum<string>

Defaults to standard for SOL and rewards otherwise.

Available options:

standard,

rewards

firstBuy

string

Creator's initial buy in quote-token atoms; default "0".

Pattern: ^[0-9]{1,20}$

Example:

"1000000"

priority

enum<string>

Priority fee level: the 50th, 75th or 95th percentile of recent fees paid for the same accounts, at least 1,000 / 10,000 / 100,000 micro-lamports per compute unit, and at most 50,000 / 200,000 / 1,000,000 lamports in total.

Available options:

normal,

fast,

turbo

slippageBps

integer

Required range: 0 <= x <= 5000

Response

The launch transaction to sign and send.

transaction

string

required

Legacy wire signed by everyone except the creator (the RUNNERS launchpad signer and the new mint). Add the creator's signature to these bytes and send it to any RPC before the blockhash expires.

mint

string

required

Base58 Solana address.

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$

Example:

"So11111111111111111111111111111111111111112"

pool

string

required

Base58 Solana address.

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$

Example:

"So11111111111111111111111111111111111111112"

config

string

required

Base58 Solana address.

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$

Example:

"So11111111111111111111111111111111111111112"

quoteMint

string

required

Base58 Solana address.

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$

Example:

"So11111111111111111111111111111111111111112"

mode

enum<string>

required

Available options:

standard,

rewards

blockhash

string

required

lastValidBlockHeight

string

required

Block height as a decimal string.

Pattern: ^(0|[1-9][0-9]{0,19})$

metadataUri

string

required

costs

object

required

Rent the creator locks when the launch lands, in lamports (network and priority fees are separate). configRent is "0" when a shared config already exists. firstBuyRent is the token account an initial buy creates: included in poolRent and totalRent only when the launch has an initial buy (prepare knows its firstBuy; an estimate does not, so add firstBuyRent to an estimate for a launch with an initial buy). Every coin is a Token-2022 mint with its metadata in the mint: no metadata account or metadata fee. Rent uses the network's current rate.

Show child attributes

firstBuyQuote

object | null

required

Show child attributes