如何从CoinMarketCap Pro API获取SpaceX现实世界资产数据_新闻

免责声明：内容不构成买卖依据，投资有风险，入市需谨慎！

如何从CoinMarketCap Pro API获取SpaceX现实世界资产数据

2026-07-16 19:00:00

概述

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 步：加密货币报价——通过标准加密货币端点实时获取代币价格。
以上所有步骤均在基础版计划下可用。

免责声明：

本网站、超链接、相关应用程序、论坛、博客等媒体账户以及其他平台和用户发布的所有内容均来源于第三方平台及平台用户。百亿财经对于网站及其内容不作任何类型的保证，网站所有区块链相关数据以及其他内容资料仅供用户学习及研究之用，不构成任何投资、法律等其他领域的建议和依据。百亿财经用户以及其他第三方平台在本网站发布的任何内容均由其个人负责，与百亿财经无关。百亿财经不对任何因使用本网站信息而导致的任何损失负责。您需谨慎使用相关数据及内容，并自行承担所带来的一切风险。强烈建议您独自对内容进行研究、审查、分析和验证。

展开阅读全文