跳到主要内容

创建投研资产赠予

POST/research/gifts在线调试
POST https://api.shengkezhi.com/open/v1/research/gifts
等效 curl
curl "https://api.shengkezhi.com/open/v1/research/gifts" \
  -H "Authorization: Bearer sk_xxx" \
  -H "Content-Type: application/json" \
  --data '{"asset_type":"strategy","asset_codes":["TS_1D_A96ACBB3"],"max_claims":10,"ttl_days":3}'

POST /research/gifts — 创建投研资产赠予。

把本人的研究问题、因子路线或策略打包成短期访问凭证。赠予码是敏感凭证,请仅交给预期领取人。

需在请求头携带 Authorization: Bearer sk_xxx。

请求体​

字段类型必填说明
asset_typeGiftAssetType是—
asset_codesstring[]是—
max_claimsinteger是—
ttl_daysinteger否默认值:3。

响应 data​

字段类型必填说明
asset_codesstring[]是—
asset_namesstring[]是与 asset_codes 等长的展示名;缺失时与 code 相同。
asset_typeGiftAssetType是—
claim_recordsGiftClaimRecord[]是已成功领取该码的明细(发出方视角)。
claimedinteger是—
created_atstring是—
expires_atstring是—
gift_codestring是—
max_claimsinteger是—
statusGiftOutStatus是active / revoked / expired(expired 由 expires_at 读时推导)。
ttl_daysinteger是—
unavailable_asset_codesstring[]是—

GiftAssetType 取值​

取值说明
problem-
factor_route-
strategy-

GiftClaimRecord 字段​

字段类型必填说明
asset_typeGiftAssetType是—
claimed_atstring是—
from_user_idstring是—
gift_codestring是—
itemsGiftClaimItem[]是—
recipient_user_idstring是—

GiftOutStatus 取值​

取值说明
active-
revoked-
expired-

GiftClaimItem 字段​

字段类型必填说明
insertedboolean是—
namestring否领取方落地后的展示名;旧账本缺省时为空,由列表接口回填。
origin_codestring是—
origin_namestring否赠予方资产展示名;旧账本缺省时为空,由列表接口回填。
renamedboolean是—
target_codestring是—

HTTP 状态​

状态码说明
200赠予码已生成
422参数不合法
503赠予功能关闭

调用示例​

curl -X POST "https://api.shengkezhi.com/open/v1/research/gifts" \
-H "Authorization: Bearer sk_xxx" \
-H "Content-Type: application/json" \
-d '{"asset_type":"strategy","asset_codes":["TS_1D_A96ACBB3"],"max_claims":10,"ttl_days":3}'
{
"code": 0,
"msg": "ok",
"data": {
"gift_code": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
"asset_type": "strategy",
"asset_codes": [
"TS_1D_A96ACBB3"
],
"asset_names": [
"动量策略"
],
"max_claims": 10,
"claimed": 0,
"ttl_days": 3,
"created_at": "2026-11-03T08:00:00Z",
"expires_at": "2026-11-06T08:00:00Z",
"status": "active",
"unavailable_asset_codes": [],
"claim_records": []
}
}