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
}

字段说明：

响应

{
    "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"
        }
    }
}

响应关键字段：

买入/卖出的区别

买入（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 = 卖出多少代币

不同链的主链币

代码示例

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/ 目录，按需查阅：

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

参数占位符: $ARGUMENTS