# Meme Token Generator API

This documentation describes the API endpoint for generating unique meme token specifications based on user descriptions.

### API Endpoint

```
POST https://ai.justpump.pro
```

### Request Format

#### Headers

| Header       | Value            |
| ------------ | ---------------- |
| Content-Type | application/json |

#### Body Parameters

```json
{
  "userDescription": "string"
}
```

| Parameter       | Type   | Required | Description                                          |
| --------------- | ------ | -------- | ---------------------------------------------------- |
| userDescription | string | Yes      | A text description of the desired meme token concept |

### Response Format

#### Success Response

```json
{
  "success": true,
  "generated": "string",
  "timestamp": "string (ISO 8601)"
}
```

| Field     | Type    | Description                                                     |
| --------- | ------- | --------------------------------------------------------------- |
| success   | boolean | Indicates if the request was successful                         |
| generated | string  | The generated token specifications                              |
| timestamp | string  | ISO 8601 formatted timestamp of when the response was generated |

#### Error Response

```json
{
  "error": "string",
  "message": "string"
}
```

| Field   | Type   | Description               |
| ------- | ------ | ------------------------- |
| error   | string | A brief error description |
| message | string | Detailed error message    |

### Generated Content Format

The `generated` field in the success response will contain text in the following format:

```
1. Name: [Creative token name]
2. Symbol: [2-6 characters]
3. Total Supply: [10M-10B number]
4. Brief description: [Up to 60 words]
5. Logo prompt: [Up to 60 words]
```

### Status Codes

| Status Code | Description                                        |
| ----------- | -------------------------------------------------- |
| 200         | Success                                            |
| 400         | Bad Request - Missing or invalid parameters        |
| 405         | Method Not Allowed - Only POST method is supported |
| 500         | Server Error                                       |

### CORS Support

The API supports Cross-Origin Resource Sharing (CORS) with the following configurations:

* Allowed Origins: `*` (all origins)
* Allowed Methods: `POST, OPTIONS`
* Max Age: 86400 seconds (24 hours)

### Example Usage

#### Request

```bash
curl -X POST \
  https://ai.justpump.pro \
  -H 'Content-Type: application/json' \
  -d '{
    "userDescription": "A fun token based on space cats exploring the galaxy"
  }'
```

#### Success Response

```json
{
  "success": true,
  "generated": "1. Name: GalactoCat\n2. Symbol: GCAT\n3. Total Supply: 1000000000\n4. Brief description: First feline-powered intergalactic cryptocurrency, enabling cosmic adventures for cats across the universe.\n5. Logo prompt: A cartoon cat in an astronaut helmet, floating in space with stars twinkling in background, wearing cool space goggles.",
  "timestamp": "2024-01-01T12:00:00Z"
}
```

#### Error Response

```json
{
  "error": "Missing userDescription field",
  "message": "The userDescription field is required in the request body"
}
```

### Rate Limiting

Please note that this API may be subject to rate limiting. Implementation details of rate limiting are not publicly disclosed.

### Support

For API support or questions, please contact the development team or raise an issue in the repository.
