alphai-trading

Alph.ai 交易相关 API - 买卖交易（含完整下单参数和响应）、挂单、跟单、订单查询、手续费等。当用户询问下单、买币、卖币、交易、挂单、跟单、订单、止损止盈、滑点设置、防 MEV、交易手续费、copy trade 相关问题时使用。

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "alphai-trading" with this command: npx skills add alph-ai-official/skills/alph-ai-official-skills-alphai-trading

Alph.ai 交易模块 API

本模块包含 54 个交易相关 API，涵盖：

  • 特殊手续费 (8个)
  • 用户买单/卖单设置 (21个)
  • 挂单服务与查询 (7个)
  • 下单服务 (3个)
  • 订单查询 (5个)
  • 跟单服务与查询 (9个)
  • 交易统计数据 (1个)

核心接口：下单（重要）

请求

POST https://b.alph.ai/smart-web-gateway/order/create
Content-Type: application/json;charset=UTF-8
Cookie: dex_cookie=<your_dex_cookie>

请求参数

{
    "chain": "bsc",
    "buyCoin": "黑马",
    "buyContract": "0x360a6f80f92985506e1ba485e2f63ad46cfb4444",
    "sellCoin": "bnb",
    "sellContract": "BNB",
    "slippage": 0.275,
    "clientOrderId": "persistent-1772014659641-xkoyxab",
    "priorityFee": 0.2,
    "antiMev": true,
    "sniper": false,
    "source": "web",
    "side": "BUY",
    "type": "MARKET",
    "volume": "0.001",
    "waitTime": 10
}

字段说明：

字段类型必填说明
chainstring是链名称：sol、bsc、eth 等
sidestring是方向：BUY 买入 / SELL 卖出
typestring是订单类型：MARKET 市价
buyCoinstring是买入币种名称
buyContractstring是买入币种合约地址
sellCoinstring是卖出币种名称（如 bnb、sol、eth）
sellContractstring是卖出币种合约地址（主链币用大写如 BNB、SOL）
volumestring是交易量（卖出币种的数量）
slippagenumber是滑点容忍度（0.275 = 27.5%）
priorityFeenumber否优先费（加速交易，单位为链原生币）
antiMevboolean否是否开启防 MEV 攻击（防夹子）
sniperboolean否是否狙击模式
clientOrderIdstring否客户端自定义订单ID（用于幂等去重）
sourcestring否来源标识（如 web、bot、api）
waitTimenumber否等待时间（秒），超时取消

响应

{
    "code": "200",
    "data": {
        "code": 200,
        "orderId": 781328037879316480,
        "clientOrderId": "persistent-1772014659641-xkoyxab",
        "success": true,
        "orderVo": {
            "id": 48835,
            "clientOrderId": "persistent-1772014659641-xkoyxab",
            "chain": "bsc",
            "uid": 67932,
            "orderId": 781328037879316480,
            "sellCoin": "bnb",
            "sellContract": "BNB",
            "buyCoin": "黑马",
            "buyContract": "0x360a6f80f92985506e1ba485e2f63ad46cfb4444",
            "sellVolume": 0.001,
            "buyVolume": 16710.320347955,
            "price": 0.0000000598432573,
            "slippage": 0.275,
            "priorityFee": 0.2,
            "antiMev": true,
            "platformFeeRate": 0.01,
            "platformFee": 0.00001,
            "platformFeeCoin": "",
            "platformContract": "BNB",
            "gasFee": 0.0000508044,
            "gasFeeCoin": "bnb",
            "antiMevFee": 0,
            "antiMevFeeCoin": "",
            "bribeFee": 0,
            "hash": "0x9165d5449fe250bf2335fb661cc8a5bf54c0807db591bf271c42104c0895d006",
            "source": "web"
        }
    }
}

响应关键字段：

字段说明
data.success下单是否成功
data.orderId订单ID
data.orderVo.hash链上交易哈希（可用于区块浏览器查询）
data.orderVo.price实际成交价格
data.orderVo.buyVolume实际买入数量
data.orderVo.sellVolume实际卖出数量
data.orderVo.platformFee平台手续费
data.orderVo.platformFeeRate平台手续费率（0.01 = 1%）
data.orderVo.gasFeeGas 费
data.orderVo.gasFeeCoinGas 费币种
data.orderVo.antiMevFee防 MEV 费用
data.orderVo.bribeFee贿赂费（矿工小费）

买入/卖出的区别

买入（BUY）：用主链币买入代币

{
    "side": "BUY",
    "sellCoin": "bnb",
    "sellContract": "BNB",
    "buyCoin": "代币名",
    "buyContract": "0x合约地址",
    "volume": "0.001"
}
  • volume = 花多少主链币去买（如 0.001 BNB）

卖出（SELL）：卖出代币换回主链币

{
    "side": "SELL",
    "sellCoin": "代币名",
    "sellContract": "0x合约地址",
    "buyCoin": "bnb",
    "buyContract": "BNB",
    "volume": "1000"
}
  • volume = 卖出多少代币

不同链的主链币

链sellCoin（买入时）sellContract
solsolSOL
bscbnbBNB
ethethETH

代码示例

Python：市价买入

import requests
import time
import uuid

DEX_COOKIE = "你的dex_cookie值"
BASE_URL = "https://b.alph.ai/smart-web-gateway"

headers = {
    "Cookie": f"dex_cookie={DEX_COOKIE}",
    "Content-Type": "application/json;charset=UTF-8"
}

def buy_token(chain, buy_coin, buy_contract, amount, slippage=0.275):
    """市价买入代币"""
    # 根据链确定主链币
    native = {"sol": ("sol", "SOL"), "bsc": ("bnb", "BNB"), "eth": ("eth", "ETH")}
    sell_coin, sell_contract = native.get(chain, ("sol", "SOL"))

    order = {
        "chain": chain,
        "side": "BUY",
        "type": "MARKET",
        "buyCoin": buy_coin,
        "buyContract": buy_contract,
        "sellCoin": sell_coin,
        "sellContract": sell_contract,
        "volume": str(amount),
        "slippage": slippage,
        "priorityFee": 0.2,
        "antiMev": True,
        "sniper": False,
        "source": "api",
        "clientOrderId": f"api-{int(time.time()*1000)}-{uuid.uuid4().hex[:8]}",
        "waitTime": 10
    }

    resp = requests.post(f"{BASE_URL}/order/create", headers=headers, json=order)
    result = resp.json()

    if result.get("code") == "200" and result.get("data", {}).get("success"):
        vo = result["data"]["orderVo"]
        print(f"✅ 买入成功！")
        print(f"   订单ID: {result['data']['orderId']}")
        print(f"   买入: {vo['buyVolume']} {vo['buyCoin']}")
        print(f"   花费: {vo['sellVolume']} {vo['sellCoin']}")
        print(f"   价格: {vo['price']}")
        print(f"   Gas费: {vo['gasFee']} {vo['gasFeeCoin']}")
        print(f"   手续费: {vo['platformFee']} ({vo['platformFeeRate']*100}%)")
        print(f"   交易哈希: {vo['hash']}")
        return result["data"]
    else:
        print(f"❌ 买入失败: {result}")
        return None

def sell_token(chain, sell_coin, sell_contract, amount, slippage=0.275):
    """市价卖出代币"""
    native = {"sol": ("sol", "SOL"), "bsc": ("bnb", "BNB"), "eth": ("eth", "ETH")}
    buy_coin, buy_contract = native.get(chain, ("sol", "SOL"))

    order = {
        "chain": chain,
        "side": "SELL",
        "type": "MARKET",
        "sellCoin": sell_coin,
        "sellContract": sell_contract,
        "buyCoin": buy_coin,
        "buyContract": buy_contract,
        "volume": str(amount),
        "slippage": slippage,
        "priorityFee": 0.2,
        "antiMev": True,
        "sniper": False,
        "source": "api",
        "clientOrderId": f"api-{int(time.time()*1000)}-{uuid.uuid4().hex[:8]}",
        "waitTime": 10
    }

    resp = requests.post(f"{BASE_URL}/order/create", headers=headers, json=order)
    result = resp.json()

    if result.get("code") == "200" and result.get("data", {}).get("success"):
        vo = result["data"]["orderVo"]
        print(f"✅ 卖出成功！")
        print(f"   卖出: {vo['sellVolume']} {vo['sellCoin']}")
        print(f"   获得: {vo['buyVolume']} {vo['buyCoin']}")
        print(f"   交易哈希: {vo['hash']}")
        return result["data"]
    else:
        print(f"❌ 卖出失败: {result}")
        return None


# 使用示例

# 在 BSC 上花 0.001 BNB 买入代币
buy_token(
    chain="bsc",
    buy_coin="黑马",
    buy_contract="0x360a6f80f92985506e1ba485e2f63ad46cfb4444",
    amount=0.001,
    slippage=0.275
)

# 在 SOL 上花 0.1 SOL 买入代币
buy_token(
    chain="sol",
    buy_coin="PEPE",
    buy_contract="合约地址",
    amount=0.1
)

# 卖出代币
sell_token(
    chain="bsc",
    sell_coin="黑马",
    sell_contract="0x360a6f80f92985506e1ba485e2f63ad46cfb4444",
    amount=16710
)

JavaScript：市价买入

const DEX_COOKIE = "你的dex_cookie值";

async function buyToken(chain, buyCoin, buyContract, amount, slippage = 0.275) {
    const native = { sol: ["sol", "SOL"], bsc: ["bnb", "BNB"], eth: ["eth", "ETH"] };
    const [sellCoin, sellContract] = native[chain] || ["sol", "SOL"];

    const resp = await fetch("https://b.alph.ai/smart-web-gateway/order/create", {
        method: "POST",
        headers: {
            "Cookie": `dex_cookie=${DEX_COOKIE}`,
            "Content-Type": "application/json;charset=UTF-8"
        },
        body: JSON.stringify({
            chain, side: "BUY", type: "MARKET",
            buyCoin, buyContract, sellCoin, sellContract,
            volume: String(amount), slippage,
            priorityFee: 0.2, antiMev: true, sniper: false,
            source: "api",
            clientOrderId: `api-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`,
            waitTime: 10
        })
    });

    const result = await resp.json();
    if (result.code === "200" && result.data?.success) {
        const vo = result.data.orderVo;
        console.log(`✅ 买入成功！`);
        console.log(`   买入: ${vo.buyVolume} ${vo.buyCoin}`);
        console.log(`   花费: ${vo.sellVolume} ${vo.sellCoin}`);
        console.log(`   交易哈希: ${vo.hash}`);
        return result.data;
    } else {
        console.log(`❌ 买入失败:`, result);
        return null;
    }
}

// 使用示例
buyToken("bsc", "黑马", "0x360a6f80f92985506e1ba485e2f63ad46cfb4444", 0.001);

使用方式

1. 查询 API

查找下单相关的 API
查询挂单接口
我想找跟单的接口

2. 查看 API 详情

显示 /smart-web-gateway/order/create 的详细信息
这个接口需要什么参数？

3. 生成调用代码

生成调用下单接口的 Python 代码
用 JavaScript 调用挂单接口
帮我写一个在 SOL 链上买入代币的脚本

工作流程

当你询问交易相关问题时，我会：

  1. 从 apis.json 和本文档中搜索相关 API
  2. 展示 API 的路径、方法、参数、响应格式
  3. 根据需要生成调用代码示例（含完整的认证和错误处理）
  4. 区分买入/卖出场景，正确设置 side 和合约地址
  5. 提供交易安全建议（滑点设置、防 MEV 等）

API 数据来源

按功能分类存储在 apis/ 目录，按需查阅：

功能文件包含
下单与订单apis/order.json下单服务、订单查询、交易统计 (9个)
挂单apis/pending.json挂单服务、挂单查询 (7个)
跟单apis/follow.json跟单服务、跟单查询 (9个)
交易设置apis/settings.json买单设置、卖单设置 (21个)
手续费apis/fee.json特殊手续费 (8个)

查找 API 时请直接读取对应的分类文件，不要读取 apis.json 全量文件。

参数占位符: $ARGUMENTS

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open in GitHubOpen in ClawHub

Related Skills

Related by shared tags or category signals.

General

alphai-common

No summary provided by upstream source.

Repository SourceNeeds Review
12-alph-ai-official
General

alphai-market

No summary provided by upstream source.

Repository SourceNeeds Review
12-alph-ai-official
General

alphai

No summary provided by upstream source.

Repository SourceNeeds Review
12-alph-ai-official
General

alphai-twitter

No summary provided by upstream source.

Repository SourceNeeds Review
12-alph-ai-official