square-post

# Square Post Skill

## Overview

Post text content to Binance Square.

---

## API: Add Content

### Method: POST

**URL**:
```
https://www.binance.com/bapi/composite/v1/public/pgc/openApi/content/add
```

**Request Headers**:

| Header | Required | Description |
|--------|----------|-------------|
| X-Square-OpenAPI-Key | Yes | Square OpenAPI Key |
| Content-Type | Yes | `application/json` |
| clienttype | Yes | `binanceSkill` |

**Request Body**:

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| bodyTextOnly | string | Yes | Post content text (supports #hashtags) |

### Example Request

```bash
curl -X POST 'https://www.binance.com/bapi/composite/v1/public/pgc/openApi/content/add' \
  -H 'X-Square-OpenAPI-Key: your_api_key' \
  -H 'Content-Type: application/json' \
  -H 'clienttype: binanceSkill' \
  -d '{
    "bodyTextOnly": "BTC looking bullish today!"
  }'
```

### Response Example

```json
{
  "code": "000000",
  "message": null,
  "data": {
    "id": "content_id_here"
  }
}
```

### Response Fields

| Field | Type | Description |
|-------|------|-------------|
| code | string | `"000000"` = success |
| message | string | Error message (null on success) |
| data.id | string | Created content ID |

### Post URL Format

On success, construct the post URL:
```
https://www.binance.com/square/post/{id}
```

Example: If `data.id` is `298177291743282`, the post URL is:
```
https://www.binance.com/square/post/298177291743282
```

---

## Error Handling

| Code | Description |
|------|-------------|
| 000000 | Success |
| 10004 | Network error. Please try again |
| 10005 | Only allowed for users who have completed identity verification |
| 10007 | Feature unavailable |
| 20002 | Detected sensitive words |
| 20013 | Content length is limited |
| 20020 | Publishing empty content is not supported |
| 20022 | Detected sensitive words (with risk segments) |
| 20041 | Potential security risk with the URL |
| 30004 | User not found |
| 30...

# Square Post Skill

Post content to Binance Square.

## Features

- Post pure text content to Binance Square
- Auto-optimize content
- Auto-manage API Key

## Usage

### Examples

```
post to square: BTC is pumping, feeling bullish
```

```
square post: Market looking strong today, BTC breaking out
```

## Posting Flow

1. **Trigger Skill** - Use the trigger phrases above
2. **Content Optimization** - Agent auto-optimizes content
3. **Choose Version** - Select optimized version or post original text
4. **Post Success** - Returns post URL

### Interaction Example

```
User: post to square: btc pumping feels like bull market

Agent: Optimized content:
       BTC surging, bull market signals are strong!

       Choose:
       1. Use optimized version
       2. Use original text

User: 1

Agent: Post successful!
       Post URL: https://www.binance.com/square/post/298177291743282
```

## First Time Setup

On first use, Claude will prompt you for API Key:

1. Get your `X-Square-OpenAPI-Key`
2. Provide it to Claude
3. Key will be stored securely for future use

> ⚠️ **Security Reminder**: When creating a Square-OpenAPI-Key, please minimize its permissions. Avoid granting highly sensitive permissions such as withdrawal or trading privileges.

## Common Errors

| Code | Description |
|------|-------------|
| 000000 | Success |
| 10004 | Network error. Please try again |
| 10005 | Only allowed for users who have completed identity verification |
| 10007 | Feature unavailable |
| 20002 | Detected sensitive words |
| 20013 | Content length is limited |
| 20020 | Publishing empty content is not supported |
| 20022 | Detected sensitive words (with risk segments) |
| 20041 | Potential security risk with the URL |
| 30004 | User not found |
| 30008 | Banned for violating platform guidelines |
| 220003 | API Key not found |
| 220004 | API Key expired |
| 220009 | Daily post limit exceeded for OpenAPI |
| 220010 | Unsupported content type |
| 220011 | Content body must not be empty...