币安广场发帖API教程：square-post技能使用指南与错误代码解析

square-post by binance/binance-skills-hub

1,500 周安装量

572 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/binance/binance-skills-hub --skill square-post

开发区块链营销

🇨🇳中文介绍

Square 发帖技能

概述

将文本内容发布到币安广场。

API: 添加内容

方法: POST

URL :

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

请求头 :

请求头	必填	描述
X-Square-OpenAPI-Key	是	Square OpenAPI 密钥
Content-Type	是	`application/json`
clienttype	是	`binanceSkill`

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

733,500 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

252,100 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

202,600 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

133,200 周安装

字段	类型	必填	描述
bodyTextOnly	string	是	帖子内容文本（支持 #话题标签）

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!"
  }'

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

字段	类型	描述
code	string	`"000000"` = 成功
message	string	错误信息（成功时为 null）
data.id	string	创建的内容 ID

成功后，构建帖子 URL：

https://www.binance.com/square/post/{id}

示例：如果 data.id 是 298177291743282，则帖子 URL 为：

https://www.binance.com/square/post/298177291743282

代码	描述
000000	成功
10004	网络错误。请重试
10005	仅允许已完成身份验证的用户使用
10007	功能不可用
20002	检测到敏感词
20013	内容长度受限
20020	不支持发布空内容
20022	检测到敏感词（包含风险片段）
20041	URL 存在潜在安全风险
30004	用户未找到
30008	因违反平台准则被封禁
220003	API 密钥未找到
220004	API 密钥已过期
220009	OpenAPI 每日发帖次数超限
220010	不支持的内容类型
220011	内容正文不能为空
2000001	账户被永久禁止发帖
2000002	设备被永久禁止发帖

请求头	必填	描述
X-Square-OpenAPI-Key	是	用于 Square 发帖的 API 密钥

切勿显示完整密钥

向用户展示凭据时：

X-Square-OpenAPI-Key : 显示前 5 位 + 后 4 位字符：abc12...xyz9

列出账户时，仅显示名称和描述——切勿显示完整密钥：

Accounts:
* default (Square 发帖的默认账户)

调用 API 前检查密钥 : 验证 X-Square-OpenAPI-Key 已配置且不是占位符 your_api_key
缺失时提示输入密钥 : 如果密钥未配置，请用户先提供其 API 密钥
缺失时提示输入内容 : 如果用户触发发帖但未提供具体内容，询问他们想发布什么
切勿显示完整密钥 : 仅显示前 5 位 + 后 4 位字符（例如 abc12...xyz9）
存储提供的密钥 : 当用户提供新密钥时，更新此文件中的账户部分
发布前优化内容 : * 优化用户的原始输入以提高可读性 * 显示优化后的内容并让用户选择：使用优化版本还是发布原始文本
成功后返回帖子 URL : 成功发布后，返回 URL https://www.binance.com/square/post/{id}
处理缺失的 id : 如果 code 是 000000 但 data.id 为空或缺失，告知用户帖子可能已成功但 URL 不可用，建议手动检查 Square 页面

目前仅支持纯文本帖子
检查每日发帖限制以避免 220009 错误

🇺🇸English

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

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

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

Check key before API calls : Verify that X-Square-OpenAPI-Key is configured and not the placeholder your_api_key
Prompt for key if missing : If key is not configured, ask user to provide their API Key first
Prompt for content if missing : If user triggers posting but doesn't provide specific content, ask what they want to post
Never display full keys : Only show first 5 + last 4 characters (e.g., abc12...xyz9)
Store provided keys : When user provides a new key, update the Accounts section in this file
Optimize content before posting :
- Polish user's raw input for better readability
- Show optimized content and ask user to choose: use optimized version or post original text
Return post URL on success : After successful post, return the URL https://www.binance.com/square/post/{id}
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

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

Weekly Installs

225

Repository

binance/binance…ills-hub

GitHub Stars

386

First Seen

5 days ago

Security Audits

Gen Agent Trust HubPass SocketPass SnykFail

Installed on

codex222

opencode221

gemini-cli217

github-copilot217

amp217

cline216

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

102,200 周安装