Prepare a launch
curl --request POST \
--url https://api.launch.o1.exchange/v1/launches/prepare \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'x-api-key: <api-key>' \
--data '
{
"chain_id": 8453,
"creator": "0x1111111111111111111111111111111111111111",
"quote_address": "0x1111111111111111111111111111111111111111",
"token": {
"name": "<string>",
"symbol": "<string>",
"image_base64": "<string>",
"description": "",
"website": "",
"x": "",
"telegram": "",
"editable_metadata": false,
"extra_metadata": []
},
"launch_product": "non-tax",
"tax": {
"buy_tax_bps": 4950,
"sell_tax_bps": 4950,
"creator_allocation_bps": 5000,
"dividend_allocation_bps": 5000,
"burn_allocation_bps": 5000,
"minimum_dividend_holding_raw": "1000000000000000000",
"creator_fee_recipient": "0x1111111111111111111111111111111111111111",
"anti_snipe_enabled": true,
"integrator": "0x1111111111111111111111111111111111111111"
},
"continuation_id": "<string>"
}
'import requests
url = "https://api.launch.o1.exchange/v1/launches/prepare"
payload = {
"chain_id": 8453,
"creator": "0x1111111111111111111111111111111111111111",
"quote_address": "0x1111111111111111111111111111111111111111",
"token": {
"name": "<string>",
"symbol": "<string>",
"image_base64": "<string>",
"description": "",
"website": "",
"x": "",
"telegram": "",
"editable_metadata": False,
"extra_metadata": []
},
"launch_product": "non-tax",
"tax": {
"buy_tax_bps": 4950,
"sell_tax_bps": 4950,
"creator_allocation_bps": 5000,
"dividend_allocation_bps": 5000,
"burn_allocation_bps": 5000,
"minimum_dividend_holding_raw": "1000000000000000000",
"creator_fee_recipient": "0x1111111111111111111111111111111111111111",
"anti_snipe_enabled": True,
"integrator": "0x1111111111111111111111111111111111111111"
},
"continuation_id": "<string>"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
chain_id: 8453,
creator: '0x1111111111111111111111111111111111111111',
quote_address: '0x1111111111111111111111111111111111111111',
token: {
name: '<string>',
symbol: '<string>',
image_base64: '<string>',
description: '',
website: '',
x: '',
telegram: '',
editable_metadata: false,
extra_metadata: []
},
launch_product: 'non-tax',
tax: {
buy_tax_bps: 4950,
sell_tax_bps: 4950,
creator_allocation_bps: 5000,
dividend_allocation_bps: 5000,
burn_allocation_bps: 5000,
minimum_dividend_holding_raw: '1000000000000000000',
creator_fee_recipient: '0x1111111111111111111111111111111111111111',
anti_snipe_enabled: true,
integrator: '0x1111111111111111111111111111111111111111'
},
continuation_id: '<string>'
})
};
fetch('https://api.launch.o1.exchange/v1/launches/prepare', 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://api.launch.o1.exchange/v1/launches/prepare",
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([
'chain_id' => 8453,
'creator' => '0x1111111111111111111111111111111111111111',
'quote_address' => '0x1111111111111111111111111111111111111111',
'token' => [
'name' => '<string>',
'symbol' => '<string>',
'image_base64' => '<string>',
'description' => '',
'website' => '',
'x' => '',
'telegram' => '',
'editable_metadata' => false,
'extra_metadata' => [
]
],
'launch_product' => 'non-tax',
'tax' => [
'buy_tax_bps' => 4950,
'sell_tax_bps' => 4950,
'creator_allocation_bps' => 5000,
'dividend_allocation_bps' => 5000,
'burn_allocation_bps' => 5000,
'minimum_dividend_holding_raw' => '1000000000000000000',
'creator_fee_recipient' => '0x1111111111111111111111111111111111111111',
'anti_snipe_enabled' => true,
'integrator' => '0x1111111111111111111111111111111111111111'
],
'continuation_id' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"x-api-key: <api-key>"
],
]);
$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://api.launch.o1.exchange/v1/launches/prepare"
payload := strings.NewReader("{\n \"chain_id\": 8453,\n \"creator\": \"0x1111111111111111111111111111111111111111\",\n \"quote_address\": \"0x1111111111111111111111111111111111111111\",\n \"token\": {\n \"name\": \"<string>\",\n \"symbol\": \"<string>\",\n \"image_base64\": \"<string>\",\n \"description\": \"\",\n \"website\": \"\",\n \"x\": \"\",\n \"telegram\": \"\",\n \"editable_metadata\": false,\n \"extra_metadata\": []\n },\n \"launch_product\": \"non-tax\",\n \"tax\": {\n \"buy_tax_bps\": 4950,\n \"sell_tax_bps\": 4950,\n \"creator_allocation_bps\": 5000,\n \"dividend_allocation_bps\": 5000,\n \"burn_allocation_bps\": 5000,\n \"minimum_dividend_holding_raw\": \"1000000000000000000\",\n \"creator_fee_recipient\": \"0x1111111111111111111111111111111111111111\",\n \"anti_snipe_enabled\": true,\n \"integrator\": \"0x1111111111111111111111111111111111111111\"\n },\n \"continuation_id\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("x-api-key", "<api-key>")
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://api.launch.o1.exchange/v1/launches/prepare")
.header("Idempotency-Key", "<idempotency-key>")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"chain_id\": 8453,\n \"creator\": \"0x1111111111111111111111111111111111111111\",\n \"quote_address\": \"0x1111111111111111111111111111111111111111\",\n \"token\": {\n \"name\": \"<string>\",\n \"symbol\": \"<string>\",\n \"image_base64\": \"<string>\",\n \"description\": \"\",\n \"website\": \"\",\n \"x\": \"\",\n \"telegram\": \"\",\n \"editable_metadata\": false,\n \"extra_metadata\": []\n },\n \"launch_product\": \"non-tax\",\n \"tax\": {\n \"buy_tax_bps\": 4950,\n \"sell_tax_bps\": 4950,\n \"creator_allocation_bps\": 5000,\n \"dividend_allocation_bps\": 5000,\n \"burn_allocation_bps\": 5000,\n \"minimum_dividend_holding_raw\": \"1000000000000000000\",\n \"creator_fee_recipient\": \"0x1111111111111111111111111111111111111111\",\n \"anti_snipe_enabled\": true,\n \"integrator\": \"0x1111111111111111111111111111111111111111\"\n },\n \"continuation_id\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.launch.o1.exchange/v1/launches/prepare")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"chain_id\": 8453,\n \"creator\": \"0x1111111111111111111111111111111111111111\",\n \"quote_address\": \"0x1111111111111111111111111111111111111111\",\n \"token\": {\n \"name\": \"<string>\",\n \"symbol\": \"<string>\",\n \"image_base64\": \"<string>\",\n \"description\": \"\",\n \"website\": \"\",\n \"x\": \"\",\n \"telegram\": \"\",\n \"editable_metadata\": false,\n \"extra_metadata\": []\n },\n \"launch_product\": \"non-tax\",\n \"tax\": {\n \"buy_tax_bps\": 4950,\n \"sell_tax_bps\": 4950,\n \"creator_allocation_bps\": 5000,\n \"dividend_allocation_bps\": 5000,\n \"burn_allocation_bps\": 5000,\n \"minimum_dividend_holding_raw\": \"1000000000000000000\",\n \"creator_fee_recipient\": \"0x1111111111111111111111111111111111111111\",\n \"anti_snipe_enabled\": true,\n \"integrator\": \"0x1111111111111111111111111111111111111111\"\n },\n \"continuation_id\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"chain_id": 8453,
"actor": "0x1111111111111111111111111111111111111111",
"prepared_at": "2026-07-31T12:00:00.000Z",
"expires_at": "2026-07-31T12:00:00.000Z",
"observed_block": "1000000000000000000",
"issues": [
{
"code": "<string>",
"severity": "blocking",
"detail": "<string>",
"asset": "0x1111111111111111111111111111111111111111",
"spender": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000",
"remediation_step_id": "<string>"
}
],
"steps": [
{
"id": "<string>",
"kind": "transaction",
"label": "<string>",
"depends_on": [
"<string>"
],
"transaction": {
"chain_id": 8453,
"from": "0x1111111111111111111111111111111111111111",
"to": "0x1111111111111111111111111111111111111111",
"data": "<string>",
"value": "1000000000000000000"
},
"simulation": {
"status": "succeeded",
"block_number": "1000000000000000000"
}
}
],
"predicted_token_address": "0x1111111111111111111111111111111111111111",
"suite_id": "<string>",
"metadata_uri": "<string>",
"image_url": "<string>",
"review": {
"market": "standard",
"token": {
"name": "<string>",
"symbol": "<string>",
"editable_metadata": true,
"extra_metadata": [
{
"key": "<string>",
"value": "<string>"
}
]
},
"quote_address": "0x1111111111111111111111111111111111111111",
"total_supply_raw": "1000000000000000000",
"pool_supply_raw": "1000000000000000000",
"launch_product": "non-tax",
"burn_rates": {
"buy_burn_rate": "1000000000000000000",
"sell_burn_rate": "1000000000000000000",
"rate_scale": "100000000"
},
"quote_revision": "1000000000000000000",
"expected_out_raw": "1000000000000000000",
"minimum_out_raw": "1000000000000000000",
"pool_id": "0x1111111111111111111111111111111111111111111111111111111111111111",
"dev_buy": {
"amount_in_raw": "1000000000000000000",
"slippage_bps": 2500,
"funding_token": "0x1111111111111111111111111111111111111111",
"spender": "0x1111111111111111111111111111111111111111",
"funding_decimals": 127,
"funding_symbol": "<string>"
},
"native_gas_estimate": {
"gas_units": "1000000000000000000",
"gas_price_wei": "1000000000000000000",
"execution_fee_raw": "1000000000000000000",
"gas_reserve_raw": "1000000000000000000",
"required_balance_raw": "1000000000000000000",
"includes_l1_data_fee": false
},
"tax": {
"buy_tax_bps": 4950,
"sell_tax_bps": 4950,
"creator_allocation_bps": 5000,
"dividend_allocation_bps": 5000,
"burn_allocation_bps": 5000,
"minimum_dividend_holding_raw": "1000000000000000000",
"creator_fee_recipient": "0x1111111111111111111111111111111111111111",
"anti_snipe_enabled": true,
"integrator": "0x1111111111111111111111111111111111111111"
},
"config_version": "1000000000000000000",
"ordinary_tax_preview": {
"rate_scale": "1000000000000000000000000",
"buy": {
"total_tax_rate": "1000000000000000000",
"protocol_rate": "1000000000000000000",
"remaining_tax_rate": "1000000000000000000",
"creator_rate": "1000000000000000000",
"burn_rate": "1000000000000000000",
"dividend_rate": "1000000000000000000",
"integrator_rate": "1000000000000000000"
},
"sell": {
"total_tax_rate": "1000000000000000000",
"protocol_rate": "1000000000000000000",
"remaining_tax_rate": "1000000000000000000",
"creator_rate": "1000000000000000000",
"burn_rate": "1000000000000000000",
"dividend_rate": "1000000000000000000",
"integrator_rate": "1000000000000000000"
},
"dividends_enabled": true
}
},
"creation_fee": {
"amount_raw": "1000000000000000000",
"currency_address": "0x1111111111111111111111111111111111111111",
"decimals": 127,
"symbol": "<string>"
},
"requires_reprepare": true,
"continuation_id": "<string>"
},
"meta": {
"request_id": "req_01JZZZZZZZZZZZZZZZZZZZZZZZ",
"generated_at": "2026-07-31T12:00:00.000Z",
"warnings": [
"<string>"
]
}
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}Launches
Prepare a launch
Validate inputs and any current creation-fee requirement, pin metadata, mine an 01 address, simulate against the verified chain snapshot, and return unsigned wallet steps.
POST
/
launches
/
prepare
Prepare a launch
curl --request POST \
--url https://api.launch.o1.exchange/v1/launches/prepare \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'x-api-key: <api-key>' \
--data '
{
"chain_id": 8453,
"creator": "0x1111111111111111111111111111111111111111",
"quote_address": "0x1111111111111111111111111111111111111111",
"token": {
"name": "<string>",
"symbol": "<string>",
"image_base64": "<string>",
"description": "",
"website": "",
"x": "",
"telegram": "",
"editable_metadata": false,
"extra_metadata": []
},
"launch_product": "non-tax",
"tax": {
"buy_tax_bps": 4950,
"sell_tax_bps": 4950,
"creator_allocation_bps": 5000,
"dividend_allocation_bps": 5000,
"burn_allocation_bps": 5000,
"minimum_dividend_holding_raw": "1000000000000000000",
"creator_fee_recipient": "0x1111111111111111111111111111111111111111",
"anti_snipe_enabled": true,
"integrator": "0x1111111111111111111111111111111111111111"
},
"continuation_id": "<string>"
}
'import requests
url = "https://api.launch.o1.exchange/v1/launches/prepare"
payload = {
"chain_id": 8453,
"creator": "0x1111111111111111111111111111111111111111",
"quote_address": "0x1111111111111111111111111111111111111111",
"token": {
"name": "<string>",
"symbol": "<string>",
"image_base64": "<string>",
"description": "",
"website": "",
"x": "",
"telegram": "",
"editable_metadata": False,
"extra_metadata": []
},
"launch_product": "non-tax",
"tax": {
"buy_tax_bps": 4950,
"sell_tax_bps": 4950,
"creator_allocation_bps": 5000,
"dividend_allocation_bps": 5000,
"burn_allocation_bps": 5000,
"minimum_dividend_holding_raw": "1000000000000000000",
"creator_fee_recipient": "0x1111111111111111111111111111111111111111",
"anti_snipe_enabled": True,
"integrator": "0x1111111111111111111111111111111111111111"
},
"continuation_id": "<string>"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
chain_id: 8453,
creator: '0x1111111111111111111111111111111111111111',
quote_address: '0x1111111111111111111111111111111111111111',
token: {
name: '<string>',
symbol: '<string>',
image_base64: '<string>',
description: '',
website: '',
x: '',
telegram: '',
editable_metadata: false,
extra_metadata: []
},
launch_product: 'non-tax',
tax: {
buy_tax_bps: 4950,
sell_tax_bps: 4950,
creator_allocation_bps: 5000,
dividend_allocation_bps: 5000,
burn_allocation_bps: 5000,
minimum_dividend_holding_raw: '1000000000000000000',
creator_fee_recipient: '0x1111111111111111111111111111111111111111',
anti_snipe_enabled: true,
integrator: '0x1111111111111111111111111111111111111111'
},
continuation_id: '<string>'
})
};
fetch('https://api.launch.o1.exchange/v1/launches/prepare', 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://api.launch.o1.exchange/v1/launches/prepare",
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([
'chain_id' => 8453,
'creator' => '0x1111111111111111111111111111111111111111',
'quote_address' => '0x1111111111111111111111111111111111111111',
'token' => [
'name' => '<string>',
'symbol' => '<string>',
'image_base64' => '<string>',
'description' => '',
'website' => '',
'x' => '',
'telegram' => '',
'editable_metadata' => false,
'extra_metadata' => [
]
],
'launch_product' => 'non-tax',
'tax' => [
'buy_tax_bps' => 4950,
'sell_tax_bps' => 4950,
'creator_allocation_bps' => 5000,
'dividend_allocation_bps' => 5000,
'burn_allocation_bps' => 5000,
'minimum_dividend_holding_raw' => '1000000000000000000',
'creator_fee_recipient' => '0x1111111111111111111111111111111111111111',
'anti_snipe_enabled' => true,
'integrator' => '0x1111111111111111111111111111111111111111'
],
'continuation_id' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"x-api-key: <api-key>"
],
]);
$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://api.launch.o1.exchange/v1/launches/prepare"
payload := strings.NewReader("{\n \"chain_id\": 8453,\n \"creator\": \"0x1111111111111111111111111111111111111111\",\n \"quote_address\": \"0x1111111111111111111111111111111111111111\",\n \"token\": {\n \"name\": \"<string>\",\n \"symbol\": \"<string>\",\n \"image_base64\": \"<string>\",\n \"description\": \"\",\n \"website\": \"\",\n \"x\": \"\",\n \"telegram\": \"\",\n \"editable_metadata\": false,\n \"extra_metadata\": []\n },\n \"launch_product\": \"non-tax\",\n \"tax\": {\n \"buy_tax_bps\": 4950,\n \"sell_tax_bps\": 4950,\n \"creator_allocation_bps\": 5000,\n \"dividend_allocation_bps\": 5000,\n \"burn_allocation_bps\": 5000,\n \"minimum_dividend_holding_raw\": \"1000000000000000000\",\n \"creator_fee_recipient\": \"0x1111111111111111111111111111111111111111\",\n \"anti_snipe_enabled\": true,\n \"integrator\": \"0x1111111111111111111111111111111111111111\"\n },\n \"continuation_id\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("x-api-key", "<api-key>")
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://api.launch.o1.exchange/v1/launches/prepare")
.header("Idempotency-Key", "<idempotency-key>")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"chain_id\": 8453,\n \"creator\": \"0x1111111111111111111111111111111111111111\",\n \"quote_address\": \"0x1111111111111111111111111111111111111111\",\n \"token\": {\n \"name\": \"<string>\",\n \"symbol\": \"<string>\",\n \"image_base64\": \"<string>\",\n \"description\": \"\",\n \"website\": \"\",\n \"x\": \"\",\n \"telegram\": \"\",\n \"editable_metadata\": false,\n \"extra_metadata\": []\n },\n \"launch_product\": \"non-tax\",\n \"tax\": {\n \"buy_tax_bps\": 4950,\n \"sell_tax_bps\": 4950,\n \"creator_allocation_bps\": 5000,\n \"dividend_allocation_bps\": 5000,\n \"burn_allocation_bps\": 5000,\n \"minimum_dividend_holding_raw\": \"1000000000000000000\",\n \"creator_fee_recipient\": \"0x1111111111111111111111111111111111111111\",\n \"anti_snipe_enabled\": true,\n \"integrator\": \"0x1111111111111111111111111111111111111111\"\n },\n \"continuation_id\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.launch.o1.exchange/v1/launches/prepare")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"chain_id\": 8453,\n \"creator\": \"0x1111111111111111111111111111111111111111\",\n \"quote_address\": \"0x1111111111111111111111111111111111111111\",\n \"token\": {\n \"name\": \"<string>\",\n \"symbol\": \"<string>\",\n \"image_base64\": \"<string>\",\n \"description\": \"\",\n \"website\": \"\",\n \"x\": \"\",\n \"telegram\": \"\",\n \"editable_metadata\": false,\n \"extra_metadata\": []\n },\n \"launch_product\": \"non-tax\",\n \"tax\": {\n \"buy_tax_bps\": 4950,\n \"sell_tax_bps\": 4950,\n \"creator_allocation_bps\": 5000,\n \"dividend_allocation_bps\": 5000,\n \"burn_allocation_bps\": 5000,\n \"minimum_dividend_holding_raw\": \"1000000000000000000\",\n \"creator_fee_recipient\": \"0x1111111111111111111111111111111111111111\",\n \"anti_snipe_enabled\": true,\n \"integrator\": \"0x1111111111111111111111111111111111111111\"\n },\n \"continuation_id\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"chain_id": 8453,
"actor": "0x1111111111111111111111111111111111111111",
"prepared_at": "2026-07-31T12:00:00.000Z",
"expires_at": "2026-07-31T12:00:00.000Z",
"observed_block": "1000000000000000000",
"issues": [
{
"code": "<string>",
"severity": "blocking",
"detail": "<string>",
"asset": "0x1111111111111111111111111111111111111111",
"spender": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000",
"remediation_step_id": "<string>"
}
],
"steps": [
{
"id": "<string>",
"kind": "transaction",
"label": "<string>",
"depends_on": [
"<string>"
],
"transaction": {
"chain_id": 8453,
"from": "0x1111111111111111111111111111111111111111",
"to": "0x1111111111111111111111111111111111111111",
"data": "<string>",
"value": "1000000000000000000"
},
"simulation": {
"status": "succeeded",
"block_number": "1000000000000000000"
}
}
],
"predicted_token_address": "0x1111111111111111111111111111111111111111",
"suite_id": "<string>",
"metadata_uri": "<string>",
"image_url": "<string>",
"review": {
"market": "standard",
"token": {
"name": "<string>",
"symbol": "<string>",
"editable_metadata": true,
"extra_metadata": [
{
"key": "<string>",
"value": "<string>"
}
]
},
"quote_address": "0x1111111111111111111111111111111111111111",
"total_supply_raw": "1000000000000000000",
"pool_supply_raw": "1000000000000000000",
"launch_product": "non-tax",
"burn_rates": {
"buy_burn_rate": "1000000000000000000",
"sell_burn_rate": "1000000000000000000",
"rate_scale": "100000000"
},
"quote_revision": "1000000000000000000",
"expected_out_raw": "1000000000000000000",
"minimum_out_raw": "1000000000000000000",
"pool_id": "0x1111111111111111111111111111111111111111111111111111111111111111",
"dev_buy": {
"amount_in_raw": "1000000000000000000",
"slippage_bps": 2500,
"funding_token": "0x1111111111111111111111111111111111111111",
"spender": "0x1111111111111111111111111111111111111111",
"funding_decimals": 127,
"funding_symbol": "<string>"
},
"native_gas_estimate": {
"gas_units": "1000000000000000000",
"gas_price_wei": "1000000000000000000",
"execution_fee_raw": "1000000000000000000",
"gas_reserve_raw": "1000000000000000000",
"required_balance_raw": "1000000000000000000",
"includes_l1_data_fee": false
},
"tax": {
"buy_tax_bps": 4950,
"sell_tax_bps": 4950,
"creator_allocation_bps": 5000,
"dividend_allocation_bps": 5000,
"burn_allocation_bps": 5000,
"minimum_dividend_holding_raw": "1000000000000000000",
"creator_fee_recipient": "0x1111111111111111111111111111111111111111",
"anti_snipe_enabled": true,
"integrator": "0x1111111111111111111111111111111111111111"
},
"config_version": "1000000000000000000",
"ordinary_tax_preview": {
"rate_scale": "1000000000000000000000000",
"buy": {
"total_tax_rate": "1000000000000000000",
"protocol_rate": "1000000000000000000",
"remaining_tax_rate": "1000000000000000000",
"creator_rate": "1000000000000000000",
"burn_rate": "1000000000000000000",
"dividend_rate": "1000000000000000000",
"integrator_rate": "1000000000000000000"
},
"sell": {
"total_tax_rate": "1000000000000000000",
"protocol_rate": "1000000000000000000",
"remaining_tax_rate": "1000000000000000000",
"creator_rate": "1000000000000000000",
"burn_rate": "1000000000000000000",
"dividend_rate": "1000000000000000000",
"integrator_rate": "1000000000000000000"
},
"dividends_enabled": true
}
},
"creation_fee": {
"amount_raw": "1000000000000000000",
"currency_address": "0x1111111111111111111111111111111111111111",
"decimals": 127,
"symbol": "<string>"
},
"requires_reprepare": true,
"continuation_id": "<string>"
},
"meta": {
"request_id": "req_01JZZZZZZZZZZZZZZZZZZZZZZZ",
"generated_at": "2026-07-31T12:00:00.000Z",
"warnings": [
"<string>"
]
}
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}{
"type": "https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found",
"title": "<string>",
"status": 499,
"code": "invalid_request",
"detail": "<string>",
"action": "<string>",
"instance": "<string>",
"request_id": "<string>",
"invalid_parameters": [
{
"name": "<string>",
"reason": "<string>",
"detail": "<string>",
"allowed": [
"<string>"
]
}
],
"suggested_endpoint": "<string>",
"resource": "<string>",
"chain_id": 8453,
"token_address": "0x1111111111111111111111111111111111111111",
"asset": "0x1111111111111111111111111111111111111111",
"actual_raw": "1000000000000000000",
"required_raw": "1000000000000000000"
}Authorizations
Production API key beginning with o1_launch_.
Headers
Generate a random UUID for each new request and reuse it only when retrying that exact request. A different payload is rejected.
Required string length:
1 - 255Body
application/json
Production chain ID: 8453 for Base, 4663 for Robinhood Chain, 143 for Monad, 5042 for Arc, 56 for BSC, or 196 for X Layer.
Available options:
8453, 4663, 143, 5042, 56, 196 Example:
8453
Wallet that will sign and send the prepared launch transaction.
Pattern:
^0x[0-9a-fA-F]{40}$Example:
"0x1111111111111111111111111111111111111111"
Launch route to use. The selected quote must be active for this market.
Available options:
standard, rwa Active quote address returned by GET /config for the selected chain and market. The zero address represents an active native-currency quote.
Pattern:
^0x[0-9a-fA-F]{40}$Example:
"0x1111111111111111111111111111111111111111"
Token identity, public profile, image, and optional metadata settings.
Show child attributes
Show child attributes
Tax selects the additional ERC20 suite, including when both tax rates are zero.
Available options:
non-tax, tax, wsto Required for tax launches; forbidden otherwise. Use the format returned for the active deployment. Mixed forms and mismatched deployment formats reject before metadata pinning. Live policy determines permitted rates, protocol clamps and dividend floor.
- Option 1
- Option 2
Show child attributes
Show child attributes
Optional atomic Dev Buy for active creation suites with an admitted adapter and reviewed funding route. Native funding requires no ERC20 approval; transaction value adds the live native creation fee when applicable. Quote funding requires exact adapter approval and a signed continuation; approval-only responses require repreparation before launch calldata is returned. Gas remains additional.
Show child attributes
Show child attributes
Signed approval continuation from the preceding response. Resend the unchanged request through the same API key with a new Idempotency-Key after the exact approval is confirmed.
Required string length:
16 - 32768