准备接受买单

curl --request POST \
  --url https://dev-api.renaiss.xyz/v2/marketplace/sell/prepare \
  --header 'Content-Type: application/json' \
  --header 'x-builder-api-key: <api-key>' \
  --data '
{
  "tokenId": "9007199254740993",
  "walletAddress": "0x1111111111111111111111111111111111111111",
  "expiresAt": null,
  "bidOrderId": "12345678-1234-4123-8123-123456789abc"
}
'

const options = {
  method: 'POST',
  headers: {'x-builder-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    tokenId: '9007199254740993',
    walletAddress: '0x1111111111111111111111111111111111111111',
    expiresAt: null,
    bidOrderId: '12345678-1234-4123-8123-123456789abc'
  })
};

fetch('https://dev-api.renaiss.xyz/v2/marketplace/sell/prepare', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://dev-api.renaiss.xyz/v2/marketplace/sell/prepare"

payload = {
    "tokenId": "9007199254740993",
    "walletAddress": "0x1111111111111111111111111111111111111111",
    "expiresAt": None,
    "bidOrderId": "12345678-1234-4123-8123-123456789abc"
}
headers = {
    "x-builder-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "operation": "sell",
  "tokenId": "<string>",
  "sellerWalletAddress": "<string>",
  "quote": {
    "sellerReceivesInUsdt": "<string>",
    "platformFeeInUsdt": "<string>",
    "totalPriceInUsdt": "<string>",
    "expiresAt": "2023-11-07T05:31:56Z",
    "bidOrderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "bidderWalletAddress": "<string>",
    "amountInUsdt": "<string>"
  },
  "typedData": {
    "domain": {},
    "types": {},
    "primaryType": "<string>",
    "message": {}
  },
  "payload": {
    "bidOrderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "collectibleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "askData": {
      "salt": "<string>",
      "deadline": "<string>",
      "usdcAmount": "<string>",
      "owner": "<string>",
      "tokenId": "<string>"
    }
  }
}

Malformed JSON in request body

{
  "error": "Required authentication credential is missing",
  "code": "API_AUTH_MISSING_CREDENTIAL"
}

{
  "error": "Only the collectible owner can accept a bid",
  "code": "UNAUTHORIZED"
}

{
  "error": "Collectible not found",
  "code": "COLLECTIBLE_NOT_FOUND"
}

Payload Too Large

{
  "error": "Authentication rate limit exceeded",
  "code": "API_AUTH_RATE_LIMITED"
}

Internal Server Error

POST

marketplace

sell

prepare

准备接受买单

curl --request POST \
  --url https://dev-api.renaiss.xyz/v2/marketplace/sell/prepare \
  --header 'Content-Type: application/json' \
  --header 'x-builder-api-key: <api-key>' \
  --data '
{
  "tokenId": "9007199254740993",
  "walletAddress": "0x1111111111111111111111111111111111111111",
  "expiresAt": null,
  "bidOrderId": "12345678-1234-4123-8123-123456789abc"
}
'

const options = {
  method: 'POST',
  headers: {'x-builder-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    tokenId: '9007199254740993',
    walletAddress: '0x1111111111111111111111111111111111111111',
    expiresAt: null,
    bidOrderId: '12345678-1234-4123-8123-123456789abc'
  })
};

fetch('https://dev-api.renaiss.xyz/v2/marketplace/sell/prepare', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://dev-api.renaiss.xyz/v2/marketplace/sell/prepare"

payload = {
    "tokenId": "9007199254740993",
    "walletAddress": "0x1111111111111111111111111111111111111111",
    "expiresAt": None,
    "bidOrderId": "12345678-1234-4123-8123-123456789abc"
}
headers = {
    "x-builder-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "operation": "sell",
  "tokenId": "<string>",
  "sellerWalletAddress": "<string>",
  "quote": {
    "sellerReceivesInUsdt": "<string>",
    "platformFeeInUsdt": "<string>",
    "totalPriceInUsdt": "<string>",
    "expiresAt": "2023-11-07T05:31:56Z",
    "bidOrderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "bidderWalletAddress": "<string>",
    "amountInUsdt": "<string>"
  },
  "typedData": {
    "domain": {},
    "types": {},
    "primaryType": "<string>",
    "message": {}
  },
  "payload": {
    "bidOrderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "collectibleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "askData": {
      "salt": "<string>",
      "deadline": "<string>",
      "usdcAmount": "<string>",
      "owner": "<string>",
      "tokenId": "<string>"
    }
  }
}

Malformed JSON in request body

{
  "error": "Required authentication credential is missing",
  "code": "API_AUTH_MISSING_CREDENTIAL"
}

{
  "error": "Only the collectible owner can accept a bid",
  "code": "UNAUTHORIZED"
}

{
  "error": "Collectible not found",
  "code": "COLLECTIBLE_NOT_FOUND"
}

Payload Too Large

{
  "error": "Authentication rate limit exceeded",
  "code": "API_AUTH_RATE_LIMITED"
}

Internal Server Error

从订单簿中选择资金充足的买单。请卖家核对报价并签名，再接受这笔出价。在测试网上，发送 expiresAt: null 可使用默认到期时间。主网更新前，请同时省略 expiresAt 和 expiresInSeconds 以使用主网默认值。

请求

需要开发者密钥

响应

错误码

在下表中查找接口返回的 HTTP 状态码和响应原文。有关各接口通用的处理建议，请参阅错误码含义与处理方式。

HTTP	错误码	文本字段	响应文本与处理方式
`400`	`MATCHING_BID_PERMIT_NOT_FOUND`	`error`	`Stored bid payload is invalid` 无法接受该买单。请刷新买单列表，不要重发原请求。
`400`	`WRONG_REQUEST_PARAMS`	`error`	`Invalid marketplace request: tokenId: Required` `Invalid marketplace request: expiresAt: Required` `expiresAt must be null or a future UTC timestamp within 180 days` 检查报错中提到的字段。要使用默认有效期，请传入 `"expiresAt": null`。
`400`	无错误码	`text/plain`	`Malformed JSON in request body`
`401`	`API_AUTH_INVALID_CREDENTIAL`	`error`	`Invalid authentication credential` 开发者密钥格式错误、未知、已过期或已撤销。请核对并更换密钥。
`401`	`API_AUTH_MISSING_CREDENTIAL`	`error`	`Required authentication credential is missing` 请在 `x-builder-api-key` 请求头中提供开发者密钥。
`403`	`API_AUTH_CREDENTIAL_NOT_ALLOWED`	`error`	`Credential is not allowed by this policy` 此路由只接受开发者密钥。移除 `Authorization` 请求头及其他凭据，再重新发送。
`403`	`GACHA_V3_BUILDER_NOT_ACCEPTED_ON_PUBLIC_API`	`error`	`This builder checks out on its own surface, not on the public API` 此密钥无法用于当前 API。请联系 Renaiss，无需重试。
`403`	`UNAUTHORIZED`	`error`	`Only the collectible owner can accept a bid` 只有藏品所有者可以接受买单。请使用持有藏品的钱包。
`404`	`COLLECTIBLE_NOT_FOUND`	`error`	`Collectible not found` 代币 ID 未知或藏品在该 API 中不可用。请核对 ID，不要用同一 ID 重试。
`404`	`ORDER_NOT_FOUND`	`error`	`Bid not found` 该买单对当前藏品无效、已过期或不存在。请刷新买单列表。
`413`	无错误码	`text/plain`	`Payload Too Large`
`429`	`API_AUTH_RATE_LIMITED`	`error`	`Authentication rate limit exceeded` 已达到密钥的请求频率上限。稍候再以较低频率重试。
`500`	`API_AUTH_ERROR`	`error`	`Internal server error`
`500`	`FUNCTION_ERROR`	`error`	`Internal server error`
`500`	无错误码	`text/plain`	`Internal Server Error`
`500`	`COLLECTIBLE_GET_FAILED`	`error`	`Internal server error` 若问题持续出现，请将 `x-request-id` 提供给 Renaiss。

授权

x-builder-api-key

string

header

必填

已获准使用的开发者 API 密钥，仅在后端保存。抽卡和市场的写入操作还需钱包签名，实物兑换还需钱包签署登录消息后由 API 签发的 Bearer 令牌。

请求体

application/json

tokenId

string

必填

卡牌的链上 ID，以十进制 uint256 字符串传入。

Pattern: ^\d+$

示例:

"9007199254740993"

walletAddress

string

必填

expiresAt

string<date-time> | null

必填

传入 JSON null 表示从准备交易时起 30 天后到期，也可指定未来 180 天内、以 Z 结尾的 UTC 时间戳。每次准备交易都必须传入此字段。

Pattern: Z$

示例:

null

bidOrderId

string<uuid>

必填

卖家从该卡牌订单簿中选定的有效买单 ID。

响应

成功

operation

enum<string>

必填

可用选项:

sell

tokenId

string

必填

Pattern: ^\d+$

sellerWalletAddress

string

必填

带 0x 前缀的 20 字节钱包或合约地址。请使用全小写或有效的校验和格式。

quote

object

必填

Show child attributes

typedData

object

必填

Show child attributes

payload

object

必填

Show child attributes

入门

抽卡

交易市场

钱包收藏

实物兑换与配送

开发资源

合作伙伴接入

准备接受买单

请求

响应

错误码

授权

请求体

响应