Square Post

Square Post Skill

Overview

Post text content to Binance Square.

---

API: Add Content via Skill Router

Method: POST

URL:

${SHIFT_LOCAL_GATEWAY}/skill-router/invoke

Request Headers:

Request Body:

{
  "skillProvider": "binance",
  "skill": "square_post",
  "action": "create",
  "input": {
    "text": "<post content here>"
  }
}

Example Request

curl -X POST "${SHIFT_LOCAL_GATEWAY}/skill-router/invoke" \
  -H 'Content-Type: application/json' \
  -d '{
    "skillProvider": "binance",
    "skill": "square_post",
    "action": "create",
    "input": {
      "text": "BTC looking bullish today! #Bitcoin"
    }
  }'

Response Format

The response is a JSON envelope:

{
  "ok": true,
  "status": 200,
  "data": {
    "code": "000000",
    "message": null,
    "data": {
      "id": "content_id_here"
    }
  }
}

Post URL Format

On success, construct the post URL:

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

Example: If data.data.id is 298177291743282, the post URL is:

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

---

Error Handling

When ok is false, check data.code for Binance-specific errors:

Skill Router errors (returned in error field):

---

Authentication

This skill requires Binance Square to be connected in Shift.

Use SHIFT_LOCAL_GATEWAY as the base URL. Do not ask the user to paste or reveal raw Binance Square credentials inside the conversation. Shift handles authentication automatically via the skill router.

---

Agent Behavior

1. Do not request raw credentials in chat: Never ask the user to paste Binance API keys or other secret values into the conversation 2. Prompt for content if missing: If user triggers posting but doesn't provide specific content, ask what they want to post 3. 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

4. Return post URL on success: After successful post, return the URL https://www.binance.com/square/post/{id} 5. Handle missing id: If code is 000000 but data.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

Square Post Skill

发布内容到 Binance Square（广场发帖）。

核心功能

• 发布纯文本帖子到 Binance Square
• 自动优化内容
• 自动管理 API Key

使用方法

示例

post to square: btc涨了 感觉牛市来了

帮我发一条 BTC 的广场动态～btc涨了 感觉牛市来了

发帖流程

1. 触发 Skill - 使用上述方式触发 2. 内容优化 - Agent 自动优化内容 3. 选择版本 - 选择使用优化版或原文发布 4. 发布成功 - 返回帖子链接

交互示例

用户: post to square: btc涨了 牛市来了吧

Agent: 优化后的内容：
       BTC 涨势强劲，牛市信号明显！

       请选择：
       1. 使用优化版本
       2. 使用原文发布

用户: 1

Agent: 发帖成功！
       帖子链接：https://www.binance.com/square/post/298177291743282

首次使用

首次使用时，Claude 会提示你提供 API Key：

1. 获取你的 X-Square-OpenAPI-Key 2. 提供给 Claude 3. Key 会被安全存储，后续无需重复提供

⚠️ 安全提醒：创建 Square-OpenAPI-Key 时，请最小化其权限范围，避免授予提现、交易等高敏感权限。

常见错误

注意事项

• 当前仅支持纯文本发帖
• 每日发帖有数量限制

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

Notes

• Only pure text posts are supported currently
• Daily post limit applies