概述
SpaceX 于 2026 年 6 月 12 日上市,在纳斯达克以股票代码 SPCX 挂牌,成为史上规模最大的首次公开募股。其股票也在链上以代币化资产的形式流通,实现全天候交易并完成链上结算。
在 CoinMarketCap Pro API 中,SpaceX 被归类为真实世界资产,其代币化股票可通过编程方式获取。本文将引导您完成资产解析、元数据读取、底层代币追踪以及实时代币价格获取,全程使用当前已开放的端点。
准备工作
您需要持有 CoinMarketCap Pro API 密钥。本文所使用的 RWA 映射、信息和发行方端点均可从免费基础版计划获取。每次请求时,请在请求头中传入您的密钥:X-CMC_PRO_API_KEY。
两个需要区分的标识符
RWA 系列引入了一个新标识符,并复用了另一个现有标识符。正确使用这两个标识符对整个流程至关重要。
rwa_id 是 RWA 资产 ID,真实世界资产(即 SpaceX 公司)的稳定标识符。它位于独立的命名空间内,与加密货币 ID 分离。请将其作为主要标识符使用,而非股票代码。
crypto_id 是现有的 CoinMarketCap 加密货币 ID,用于代表该资产的链上代币(即 SPCX 代币)。通过标准加密货币端点读取实时市场数据时使用此标识符。
所有响应均采用标准 CoinMarketCap 封装格式:包含 data 对象和 status 对象,时间字段为 ISO 8601 字符串。出错时,data 为 null,status.error_code 为非零值。
1. 通过 ID 映射解析 SpaceX 的 rwa_id
首先使用轻量级 RWA ID 映射。它可将资产解析为其 rwa_id,且不消耗积分。按符号筛选以查找 SpaceX。由于 SPCX 符号现在既指代纳斯达克上市股票也指代代币化资产,通过映射解析并使用 rwa_id 可确保您始终指向链上资产而非上市股票。
请求:
curl -G 'https://pro-api.coinmarketcap.com/v5/real-world-assets/map' \ --data-urlencode 'symbol=SPCX' \ -H 'X-CMC_PRO_API_KEY: YOUR_API_KEY' \ -H 'Accept: application/json'
示例响应(数值仅供示意):
{"data": {"rwa_assets": [{"rwa_id": 9,"name": "SpaceX","symbol": "SPCX","slug": "spacex","asset_type": "stock","rwa_rank": 7,"has_tokens": true}],"total_size": 1,"has_more": false},"status": { "error_code": "0", "credit_count": 0 }}
从响应中读取 rwa_id。在本例中为 9。该值是后续所有步骤中需要携带的标识符。
端点:GET /v5/real-world-assets/map。免费,基础版可用。也可通过 rwa_id 或 rwa_slug 进行查询,而不限于符号。
2. 获取 SpaceX 的静态元数据
拿到 rwa_id 后,调用 RWA 信息端点获取描述性元数据。包括名义字段和公司字段,以及关于区块(描述、徽标、网站)。
请求:
curl -G 'https://pro-api.coinmarketcap.com/v5/real-world-assets/info' \ --data-urlencode 'rwa_id=9' \ -H 'X-CMC_PRO_API_KEY: YOUR_API_KEY' \ -H 'Accept: application/json'
您将获得的 key 字段:
端点:GET /v5/real-world-assets/info,每返回 250 个资产消耗 1 积分,基础版可用。对于没有公开股权上市的资产类型(如大宗商品),股权专属字段(如 primary_exchange 和 cik)将返回 null 而非零值。
3. 通过发行方追踪底层 SPCX 代币
SpaceX 通过发行方铸造的链上代币进行交易。要查找该代币及其 crypto_id,请使用发行方端点。首先列出发行方以找到 Backpack,然后获取该发行方的信息,查看其关联的代币。
查找发行方:
curl -G 'https://pro-api.coinmarketcap.com/v5/real-world-assets/issuers/list' \ -H 'X-CMC_PRO_API_KEY: YOUR_API_KEY'
然后获取该发行方及其关联代币(使用列表中的 issuer_id):
curl -G 'https://pro-api.coinmarketcap.com/v5/real-world-assets/issuers' \ --data-urlencode 'issuer_id=6a2d54b697c45356b1a634f4' \ -H 'X-CMC_PRO_API_KEY: YOUR_API_KEY'
示例响应(数值仅供示意):
{"data": {"issuer_id": "6a2d54b697c45356b1a634f4","name": "Backpack","num_tokens": 1,"tokens": [{"crypto_id": 40238,"name": "SpaceX tokenized stock (Backpack)","symbol": "SPCX","rwa_id": 9}]},"status": { "error_code": "0", "credit_count": 1 }}
从 tokens 数组中读取代币的 crypto_id。在本例中为 40238。该数字是从 RWA 世界进入标准加密货币端口的桥梁。
端点:GET /v5/real-world-assets/issuers/list 和 GET /v5/real-world-assets/issuers,每次请求消耗 1 积分,基础版可用。
4. 获取 SPCX 代币的实时价格
SPCX 代币是普通的链上资产,拥有 crypto_id,因此其实时价格来自标准加密货币报价端点。传入第 3 步中获得的 crypto_id。
请求:
curl -G 'https://pro-api.coinmarketcap.com/v2/cryptocurrency/quotes/latest' \ --data-urlencode 'id=40238' \ --data-urlencode 'convert=USD' \ -H 'X-CMC_PRO_API_KEY: YOUR_API_KEY' \ -H 'Accept: application/json'
响应中会以转换后的货币提供代币价格、市值、24 小时交易量和变化字段。这些字段每分钟刷新一次。
即将推出:聚合代币化市场数据。后续版本将增加 RWA 资产列表和市场对端点,可返回所有代表某资产的代币的聚合代币化价格、代币化市值和 24 小时交易量,以及它们所交易的市场,一次调用即可完成。在此之前,第 4 步使用令牌 crypto_id 的标准加密货币报价端点是获取 SPCX 实时价格的途径。
Python 综合示例
以下是上述四个步骤的简短脚本:解析资产、读取元数据、追踪代币、获取价格。
import requests
BASE = 'https://pro-api.coinmarketcap.com'
HEADERS = {'X-CMC_PRO_API_KEY': 'YOUR_API_KEY', 'Accept': 'application/json'}
# Step 1: resolve the SpaceX rwa_id
m = requests.get(f'{BASE}/v5/real-world-assets/map', params={'symbol': 'SPCX'}, headers=HEADERS).json()
rwa_id = m['data']['rwa_assets'][0]['rwa_id']
# Step 2: static metadata
info = requests.get(f'{BASE}/v5/real-world-assets/info', params={'rwa_id': rwa_id}, headers=HEADERS).json()
asset = info['data']['rwa_assets'][0]
print(asset['name'], asset['asset_type'])
# Step 3: find the underlying token via its issuer
ISSUER_ID = '6a2d54b697c45356b1a634f4' # Backpack
issuer = requests.get(f'{BASE}/v5/real-world-assets/issuers', params={'issuer_id': ISSUER_ID}, headers=HEADERS).json()
token = next(t for t in issuer['data']['tokens'] if t['rwa_id'] == rwa_id)
crypto_id = token['crypto_id']
# Step 4: live token price
q = requests.get(f'{BASE}/v2/cryptocurrency/quotes/latest', params={'id': crypto_id, 'convert': 'USD'}, headers=HEADERS).json()
price = q['data'][str(crypto_id)]['quote']['USD']['price']
print(f'SPCX price: ${price}')
总结
第 1 步:映射——将 SpaceX 解析为 rwa_id(免费,无积分消耗)。
第 2 步:信息——返回公司和关于元数据。
第 3 步:发行方——获取 SPCX 代币及其 crypto_id。
第 4 步:加密货币报价——通过标准加密货币端点实时获取代币价格。
以上所有步骤均在基础版计划下可用。

资金费率
资金费率热力图
多空比
大户多空比
币安/欧易/火币大户多空比
Bitfinex杠杆多空比
账号安全
资讯收藏
自选币种