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

# Four.meme

> Create, buy, and sell methods for the `four_meme` transaction socket platform.

Use `platform: "four_meme"` for four.meme launches and trades on BNB Chain.

## Methods

| Type                                    | Purpose                                                     |
| --------------------------------------- | ----------------------------------------------------------- |
| `create_with_image_url`                 | Launch with a hosted image URL.                             |
| `create_with_image_blob`                | Launch with raw image bytes.                                |
| `create_with_image_url_and_transaction` | Launch with a client-fetched four.meme transaction payload. |
| `buy`                                   | Buy an existing four.meme token.                            |
| `sell`                                  | Sell an existing four.meme token.                           |

## Create fields

Shared fields:

* `transaction_data`
* `launch_data`

Four.meme-specific fields:

| Field                       | Type                                | Notes                                                   |
| --------------------------- | ----------------------------------- | ------------------------------------------------------- |
| `image_url` or `image_blob` | `string` or `number[]`              | Depends on the create variant.                          |
| `buy_config`                | `BnbBuyConfig`                      | Amounts can be sent as strings or numbers.              |
| `gwei`                      | `number \| string`                  | Rounded to an integer gas price.                        |
| `fast_mode`                 | `boolean`                           | Hint to route through the private proxy when available. |
| `quote_token`               | `BNB \| U \| ASTER \| USD1 \| USDC` | Defaults to `BNB`.                                      |
| `is_meme_rush`              | `boolean`                           | Restricted access flow.                                 |

### `BnbBuyConfig`

Standard:

```json theme={null}
{
  "type": "standard",
  "buy_amount": "10000000000000000"
}
```

Bundled:

```json theme={null}
{
  "type": "bundled",
  "buy_amount": "10000000000000000",
  "bundles": [
    {
      "pubkey": "0xBUNDLE_WALLET",
      "buy_amt": "5000000000000000",
      "delay": 0
    }
  ]
}
```

### Example: `create_with_image_url`

```json theme={null}
{
  "platform": "four_meme",
  "type": "create_with_image_url",
  "transaction_data": {
    "rpcs": [],
    "identifier": "four_create_1",
    "priority_fee": 0,
    "payer_wallet": "0xYOUR_WALLET"
  },
  "launch_data": {
    "name": "Four Coin",
    "symbol": "FOUR",
    "description": "Example four.meme launch",
    "twitter": "https://x.com/example/status/1",
    "attached_referral": null,
    "website": "https://example.com",
    "generated": false,
    "multi_deploy_count": 1
  },
  "image_url": "https://example.com/image.png",
  "buy_config": {
    "type": "standard",
    "buy_amount": "10000000000000000"
  },
  "gwei": 1,
  "fast_mode": false,
  "quote_token": "BNB",
  "is_meme_rush": false
}
```

### `create_with_image_url_and_transaction`

This variant is for clients that already fetched the four.meme create payload themselves. The nested `transaction_payload` uses camelCase keys because it mirrors the upstream four.meme API response.

```json theme={null}
{
  "platform": "four_meme",
  "type": "create_with_image_url_and_transaction",
  "transaction_data": {
    "rpcs": [],
    "identifier": "four_prefetched_1",
    "priority_fee": 0,
    "payer_wallet": "0xYOUR_WALLET"
  },
  "launch_data": {
    "name": "Four Coin",
    "symbol": "FOUR",
    "description": "Example four.meme launch",
    "twitter": "https://x.com/example/status/1",
    "attached_referral": null,
    "website": null,
    "generated": false,
    "multi_deploy_count": 1
  },
  "image_url": "https://static.four.meme/example.png",
  "transaction_payload": {
    "createArg": "0x...",
    "signature": "0x...",
    "symbolAddress": "0xTOKEN"
  },
  "buy_config": {
    "type": "standard",
    "buy_amount": "10000000000000000"
  },
  "gwei": 1,
  "fast_mode": false,
  "quote_token": "BNB",
  "is_meme_rush": false
}
```

## Buy

| Field              | Type                | Notes                                             |
| ------------------ | ------------------- | ------------------------------------------------- |
| `transaction_data` | object              | Shared request metadata.                          |
| `token`            | `string`            | four.meme token address.                          |
| `to`               | `string \| null`    | Optional recipient; defaults to the payer wallet. |
| `buy_config`       | `FourMemeBuyConfig` | `amap` or `amount`.                               |
| `gwei`             | `number \| string`  | Gas price.                                        |
| `fast_mode`        | `boolean`           | Optional proxy hint.                              |
| `quote_token`      | token enum          | Defaults to `BNB`.                                |

Example:

```json theme={null}
{
  "platform": "four_meme",
  "type": "buy",
  "transaction_data": {
    "rpcs": [],
    "identifier": "four_buy_1",
    "priority_fee": 0,
    "payer_wallet": "0xYOUR_WALLET"
  },
  "token": "0xTOKEN",
  "to": "0xRECIPIENT",
  "buy_config": {
    "type": "amap",
    "funds": "10000000000000000",
    "min_amount": "0"
  },
  "gwei": 1,
  "fast_mode": false,
  "quote_token": "BNB"
}
```

## Sell

Example:

```json theme={null}
{
  "platform": "four_meme",
  "type": "sell",
  "transaction_data": {
    "rpcs": [],
    "identifier": "four_sell_1",
    "priority_fee": 0,
    "payer_wallet": "0xYOUR_WALLET"
  },
  "token": "0xTOKEN",
  "sell_config": {
    "type": "amount",
    "amount": "1000000000000000000",
    "min_funds": "0"
  },
  "gwei": 1,
  "fast_mode": false,
  "quote_token": "BNB"
}
```

## Notes

* `is_meme_rush` requires additional access.
* The socket may emit `four_meme_token` responses when four.meme access tokens are cached or refreshed for session wallets.