交易 API

介绍

交易是交易引擎的法币方面。相同的端点，相同的流程 — 只是一边是法币而不是两种加密资产。使用它让用户用 USD/EUR/AED 购买加密货币或将加密货币兑现到银行账户。

下面的所有端点都需要开发者 api-key 标头。联系我们获取一个。

api-key: YOUR_P3P_API_KEY

法币如何运作

交易就是一种交易所，其中一边是法币资产而不是链上代币。将 asset_from（或 asset_to）设置为法币密钥，如 "usd"、"eur"、"aed" — 并跳过该侧的相应 chain_* / token_* 字段。请求类型会自动切换为 "cash"。

端点

1. 获取法币2. 获取汇率3. 报价交易汇率4. 创建交易

---

1. 获取法币

GET /fiats 需要 api-key

返回当前支持的每种法币货币。

curl https://api.p3p.xyz/fiats \
  -H "api-key: YOUR_P3P_API_KEY"

{
  "usd": { "key": "usd", "name": "US Dollar",         "enabled": true },
  "eur": { "key": "eur", "name": "Euro",              "enabled": true },
  "aed": { "key": "aed", "name": "UAE Dirham",        "enabled": true }
}

---

2. 获取汇率

GET /rates 需要 api-key

与交易所相同的 /rates 端点 — 返回加密和法币资产的参考汇率。

curl https://api.p3p.xyz/rates \
  -H "api-key: YOUR_P3P_API_KEY"

---

3. 报价交易汇率

POST /exchange/rate 需要 api-key

与加密货币交易相同的端点。在 asset_from 或 asset_to 中放置法币密钥以切换到交易模式。

法币 → 加密货币

用户想用现金购买加密货币。

curl -X POST https://api.p3p.xyz/exchange/rate \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_P3P_API_KEY" \
  -d '{
    "asset_from": "usd",
    "amount_from": "100",
    "chain_to": "eth",
    "token_to": "usdt"
  }'

加密货币 → 法币

用户想将加密货币兑现。

curl -X POST https://api.p3p.xyz/exchange/rate \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_P3P_API_KEY" \
  -d '{
    "chain_from": "eth",
    "token_from": "usdt",
    "amount_from": "100",
    "asset_to": "aed"
  }'

---

4. 创建交易

POST /exchange/create 需要 api-key

与加密货币交易相同的端点。锁定交易汇率并接收现金腿的付款说明，或加密货币腿的存款地址。

法币 → 加密货币

curl -X POST https://api.p3p.xyz/exchange/create \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_P3P_API_KEY" \
  -d '{
    "asset_from": "usd",
    "amount_from": "100",
    "chain_to": "eth", "token_to": "usdt",
    "wallet_to": "0xRecipient...address"
  }'

加密货币 → 法币

curl -X POST https://api.p3p.xyz/exchange/create \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_P3P_API_KEY" \
  -d '{
    "chain_from": "eth", "token_from": "usdt", "amount_from": "100",
    "asset_to": "aed",
    "wallet_to": "iban:AE07..."
  }'

使用相同的检查交易所状态端点跟踪交易。