# Create Coin

> 🚧 **Coming Soon** - This endpoint is not yet live.

> 🔑 **Authentication required.** See [API Key](/apis/api-key.md) for setup and rate limits.

## `POST` /services/v2/create-coin-tx

Creates a new token on the Solana blockchain and returns a signed transaction to broadcast.

```
POST https://api.anoncoin.it/services/v2/create-coin-tx
```

***

## Request Headers

| Header      | Value        | Description                    |
| ----------- | ------------ | ------------------------------ |
| `x-api-key` | Your API key | **Required.** Anoncoin API key |

***

## Request Body (`form-data`)

| Field                   | Type | Required | Description                                                             |
| ----------------------- | ---- | -------- | ----------------------------------------------------------------------- |
| `tickerName`            | text | ✅        | Name of the token (e.g., `Thanos`)                                      |
| `tickerSymbol`          | text | ✅        | Symbol / ticker (e.g., `THANOS`)                                        |
| `description`           | text | ✅        | Description / lore for the coin                                         |
| `tickerImage`           | file | ✅        | Image file for the coin logo                                            |
| `twitterLink`           | text | ❌        | X (Twitter) link for the coin                                           |
| `telegramLink`          | text | ❌        | Telegram link for the coin                                              |
| `validateOnly`          | text | ❌        | Pass `"true"` to validate without creating. Default: `"false"`          |
| `feePayerWalletAddress` | text | ❌        | **Whitelisted users only.** Wallet address to claim fee externally      |
| `externalLink`          | text | ❌        | **Whitelisted users only.** External link to store                      |
| `lockTicker`            | text | ❌        | **Whitelisted users only.** Pass `"true"` to lock the ticker for 1 hour |

***

## Examples

### 1. Validate Only (Success)

Pass `validateOnly="true"` to check if the token can be created without actually creating it.

**Request:**

```bash
curl --location 'https://api.anoncoin.it/services/v2/create-coin-tx' \
  --header 'x-api-key: YOUR_API_KEY' \
  --form 'tickerImage=@"/path/to/thanos-logo.png"' \
  --form 'tickerName="Thanos"' \
  --form 'tickerSymbol="THANOS"' \
  --form 'description="Destroyed half of the world"' \
  --form 'twitterLink="https://x.com/ThanosCoin"' \
  --form 'telegramLink="https://t.me/ThanosCoin"' \
  --form 'validateOnly="true"'
```

**Response:**

```json
{
    "status": true,
    "message": "Token validation successful",
    "data": null,
    "requestId": "88994de0-f310-11f0-9f26-1b1f1981f29e"
}
```

***

### 2. Create a Token (Success)

Creates the token and returns a signed transaction to broadcast to Solana.

**Request:**

```bash
curl --location 'https://api.anoncoin.it/services/v2/create-coin-tx' \
  --header 'x-api-key: YOUR_API_KEY' \
  --form 'tickerImage=@"/path/to/thanos-logo.png"' \
  --form 'tickerName="Thanos"' \
  --form 'tickerSymbol="THANOS"' \
  --form 'description="Destroyed half of the world"' \
  --form 'twitterLink="https://x.com/ThanosCoin"' \
  --form 'telegramLink="https://t.me/ThanosCoin"'
```

**Response:**

```json
{
    "status": true,
    "message": "Token transaction created successfully",
    "data": {
        "mintAddress": "DKTd8fN2cRyLTVKZPV4tDnSgTGGeMsqwFDAC2X82YDUB",
        "meteoraConfigKey": "3EP2jpbQv8Uf3Ri9HxUFaes7VcmLBK9hH2eiqmL5weTt",
        "signedTransaction": "4ayPq9i72YWMLAkz6hmk56kkikQ3of1m1tNW5aTpG2PfrafD95nTMTN47r4ZhazRWwfgPzvVWD5LHry2wENNeo99ULoAZuTZ5mtV4ejVRFXe1PXvDkaqmX7Tn8k32zBvKsvWGqQ5vb...",
        "blockhash": "AyCmKPVHfm2E1NhLChq2GgjRW48Qd2gJMq6MR1w5vTCo",
        "lastValidBlockHeight": 438351945,
        "blockhashExpiresInSeconds": 59
    },
    "requestId": "72f200a0-26b3-11f1-af11-012a5eb3689c"
}
```

> ⚠️ **Important:** You must **broadcast the `signedTransaction`** to the Solana network before the blockhash expires (\~59 seconds).

#### Response Fields

* `status` : `true` on success.
* `message` : Status message.
* `requestId` : Unique request identifier.
* `data` :
  * `mintAddress` : The Solana token mint address for the newly created token.
  * `meteoraConfigKey` : The Meteora config key used during token creation.
  * `signedTransaction` : The signed transaction in base58 encoded string format, ready to be broadcast.
  * `blockhash` : The blockhash used for the transaction.
  * `lastValidBlockHeight` : The block height until which the transaction remains valid.
  * `blockhashExpiresInSeconds` : Time in seconds until the blockhash expires.

***

### 3. Failure (Duplicate Ticker)

If the ticker symbol is already taken, the API returns an error.

**Request:**

```bash
curl --location 'https://api.anoncoin.it/services/v2/create-coin-tx' \
  --header 'x-api-key: YOUR_API_KEY' \
  --form 'tickerImage=@"/path/to/thanos-logo.png"' \
  --form 'tickerName="Thanos"' \
  --form 'tickerSymbol="THANOS"' \
  --form 'description="Destroyed half of the world"' \
  --form 'twitterLink="https://x.com/ThanosCoin"' \
  --form 'telegramLink="https://t.me/ThanosCoin"' \
  --form 'validateOnly="true"'
```

**Response:**

```json
{
    "status": false,
    "message": "tickerSymbol already exists",
    "data": null,
    "errorCode": null,
    "requestId": "0a06a7c0-f310-11f0-9f26-1b1f1981f29e"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.anoncoin.it/apis/create-token.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.