square-post

name	square-post
description	Post content to Binance Square (Binance social platform for sharing trading insights). Auto-run on messages like 'post to square', 'square post'. Supports pure text posts.
metadata	{"author":"binance-square","version":"1.2"}

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

Example Request

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

{
  "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
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
2000001	Account permanently blocked from posting
2000002	Device permanently blocked from posting

---

Authentication

Required Header

Header	Required	Description
X-Square-OpenAPI-Key	Yes	API key for Square posting

---

Security

Never Display Full Keys

When showing credentials to users:

• X-Square-OpenAPI-Key: Show first 5 + last 4 characters: abc12...xyz9

Listing Accounts

When listing accounts, show names and description only — never full keys:

Accounts:
* default (Default account for Square posting)

---

Agent Behavior

1. Check key before API calls: Verify that X-Square-OpenAPI-Key is configured and not the placeholder your_api_key
2. Prompt for key if missing: If key is not configured, ask user to provide their API Key first
3. Prompt for content if missing: If user triggers posting but doesn't provide specific content, ask what they want to post
4. Never display full keys: Only show first 5 + last 4 characters (e.g., abc12...xyz9)
5. Store provided keys: When user provides a new key, update the Accounts section in this file
6. Optimize content before posting:
   • Polish user's raw input for better readability
   • Do NOT auto-add hashtags (#xxx) during optimization — keep any hashtags the user wrote, but never add new ones
   • Show optimized content and ask user to choose: use optimized version or post original text
7. Return post URL on success: After successful post, return the URL https://www.binance.com/square/post/{id}
8. Handle missing id: If code is 000000 but data.id is empty or missing, inform user that post may have succeeded but URL is unavailable, suggest checking Square page manually

---

Notes

1. Only pure text posts are supported currently
2. Check daily post limit to avoid 220009 error