Element NFT Market 🌊
Skill for querying NFT collection statistics, portfolios, and monitoring active trading events on the Element Market.
🛡️ Security & Privacy
- - Consent Protocol: The agent MUST explicitly ask the user for permission and receive a positive confirmation before querying any wallet address.
- Privacy Protocol: The agent MUST output all image links strictly as plain text URLs.
- API Scope: This skill performs read-only queries.
🚀 Setup
Please configure the ELEMENT_API_KEY environment variable within your OpenClaw instance.
🧠 Agent Knowledge Base: Token Mapping
🚨 SYSTEM RULE for Data Interpretation: When the API response contains a
paymentToken address, you MUST use the following mapping table to determine the correct currency symbol and decimals for formatting the price. If a token is not listed, default to the native chain currency. Pay strict attention to the
Decimals column for price calculation.
| Chain | Payment Token Address (paymentToken) | Currency Symbol | Decimals |
|---|
| eth | INLINECODE3 | ETH | 18 |
| eth |
0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 | WETH | 18 |
|
bsc |
0x0000000000000000000000000000000000000000 | BNB | 18 |
|
bsc |
0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c | WBNB | 18 |
|
bsc |
0x55d398326f99059ff775485246999027b3197955 | USDT | 18 |
|
polygon |
0x0000000000000000000000000000000000000000 | MATIC | 18 |
|
polygon |
0x7ceb23fd6bc0add59e62ac25578270cff1b9f619 | ETH | 18 |
|
base |
0x0000000000000000000000000000000000000000 | ETH | 18 |
|
base |
0x4200000000000000000000000000000000000006 | WETH | 18 |
|
base |
0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 | USDC | 6 |
📊 Queries & Monitors
Get Collection Stats
Use this to check the detailed volume, floor price, 24h average price, and the latest trade price for a specific NFT collection by its slug.
CODEBLOCK0
Get Ranking List
Use this to fetch the top trending NFT collections on a specific chain.
CODEBLOCK1
Get Wallet NFT Portfolio (Asset List)
Use this to get the list of NFTs owned by a specific wallet address.
- * CHAIN can be "eth", "bsc", etc.
- WALLET_ADDRESS is the 0x address.
- 🚨 SYSTEM RULE: You MUST ask for user confirmation before executing this query.
- LIMIT is the number of assets to return.
CODEBLOCK2
Get Received Offers (Offers on your NFTs)
Use this to check the highest offers (bids) received on the NFTs owned by a specific wallet.
- * CHAIN can be "eth", "bsc", etc.
- WALLET_ADDRESS is the 0x address.
- 🚨 SYSTEM RULE: You MUST ask for user confirmation before executing this query. You MUST print the image parameter exactly as a plain text URL.
CODEBLOCK3
Get Collection Slug by Contract Address (Address Resolver)
Use this tool to find a collection's slug by its contract address. Automatically call Get Collection Stats using the resolved slug.
CODEBLOCK4
Check Recent Wallet Sales Activity (All-in-One Monitor)
🔴 PRIMARY TRIGGER: Use whenever user asks "Did I sell any NFTs recently?". Requires explicit user consent.
- * CHAIN can be "eth", "bsc", etc.
- WALLET_ADDRESS is the 0x address.
- LIMIT is the number of recent activities.
- 🚨 SYSTEM RULES:
- 1. Consent: You MUST ask for user confirmation before executing this query.
- Action: If
from is the user, output "Sell". If to is the user, output "Buy". - Formatting: Print the image URL as plain text only.
🚨
NFT Sale Monitor Alert!
[🖼️ View Collection Image]
Collection: [collection]
Token ID: [tokenId]
💰
Transaction Details:
- * Action: [Buy / Sell]
- Price: [salePrice] [Currency]
- Counterparty: INLINECODE18
- Time: [time]
- Tx Receipt: https://[ChainScanDomain]/tx/[txHash]
📊 Latest Collection Stats:
- * Current Floor Price: [floorPrice] [Currency]
- 24H Average Price: [avgPrice24h] [Currency]
- Last Trade Price: [lastTradePrice] [Currency]
💡 Agent Insight: (1-sentence analysis comparing the salePrice to the floorPrice/lastTradePrice.)
CODEBLOCK5
Check New Received Offers (Offer Monitor)
🔴 PRIMARY TRIGGER: Use whenever user asks "Did I get any new offers?". Requires explicit user consent.
- 1. Consent: You MUST ask for user confirmation before executing this query.
- Formatting: Print the image URL as plain text only.
🔔
New NFT Offer Alert!
[🖼️ View NFT Image]
Item: [name]
Collection: [collection]
💰
Offer Details:
- * Offer Price: [offerPrice] [Currency]
- Offerer: INLINECODE19
- Offer Time: [listingTime]
📊 Collection Stats (24H):
- * Current Floor Price: [floorPrice] [Currency]
- 24H Average Price: [avgPrice24h] [Currency]
- Last Trade Price: [lastTradePrice] [Currency]
- 24H Sales Count: [saleCount24h]
💡 Agent Insight: (1-sentence analysis comparing offerPrice to floorPrice/lastTradePrice.)
CODEBLOCK6
🔗 Links
- * API Documentation: INLINECODE20
- Create API Key: INLINECODE21
- Mainnet: INLINECODE22
Element NFT 市场 🌊
用于在 Element 市场上查询 NFT 集合统计数据、投资组合以及监控活跃交易事件的技能。
🛡️ 安全与隐私
- - 同意协议: 代理在查询任何钱包地址前,必须明确征得用户许可并获得肯定确认。
- 隐私协议: 代理必须将所有图片链接严格以纯文本 URL 形式输出。
- API 范围: 本技能仅执行只读查询。
🚀 设置
请在您的 OpenClaw 实例中配置 ELEMENTAPIKEY 环境变量。
🧠 代理知识库:代币映射
🚨 数据解释系统规则: 当 API 响应中包含 paymentToken 地址时,您必须使用以下映射表来确定正确的货币符号和小数位数,以便格式化价格。如果某个代币未列出,则默认使用链的原生货币。请严格关注 Decimals 列以进行价格计算。
| 链 | 支付代币地址 (paymentToken) | 货币符号 | 小数位数 |
|---|
| eth | 0x0000000000000000000000000000000000000000 | ETH | 18 |
| eth |
0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 | WETH | 18 |
|
bsc | 0x0000000000000000000000000000000000000000 | BNB | 18 |
|
bsc | 0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c | WBNB | 18 |
|
bsc | 0x55d398326f99059ff775485246999027b3197955 | USDT | 18 |
|
polygon | 0x0000000000000000000000000000000000000000 | MATIC | 18 |
|
polygon | 0x7ceb23fd6bc0add59e62ac25578270cff1b9f619 | ETH | 18 |
|
base | 0x0000000000000000000000000000000000000000 | ETH | 18 |
|
base | 0x4200000000000000000000000000000000000006 | WETH | 18 |
|
base | 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 | USDC | 6 |
📊 查询与监控
获取集合统计信息
使用此功能通过集合的 slug 来检查特定 NFT 集合的详细成交量、地板价、24 小时平均价以及最新交易价格。
bash
SLUG=boredapeyachtclub
CHAIN=eth
HOST=api.element.market
curl -s -G https://${HOST}/openapi/v1/collection/stats \
--data-urlencode chain=${CHAIN} \
--data-urlencode collection_slug=${SLUG} \
--header X-Api-Key: ${ELEMENTAPIKEY} \
--header accept: application/json | jq {volume24h: .data.stats1D.volume, saleCount24h: .data.stats1D.saleCount, floorPrice: .data.collectionFloorPrice.floorPriceSource, avgPrice24h: .data.stats1D.avgPrice, lastTradePrice: .data.lastTradePrice}
获取排名列表
使用此功能获取特定链上最热门的 NFT 集合。
bash
SORTTYPE=TOP
CHAIN=eth
LEVEL=L1D
LIMIT=10
HOST=api.element.market
curl -s -G https://${HOST}/openapi/v1/collection/ranking \
--data-urlencode chain=${CHAIN} \
--data-urlencode sort_type=${SORTTYPE} \
--data-urlencode level=${LEVEL} \
--data-urlencode limit=${LIMIT} \
--header X-Api-Key: ${ELEMENTAPIKEY} \
--header accept: application/json | jq [.data.rankingList[].collectionRank | {name: .collection.name, slug: .collection.slug, floorPrice: .floorPrice, volume: .volume}]
获取钱包 NFT 投资组合(资产列表)
使用此功能获取特定钱包地址拥有的 NFT 列表。
- * CHAIN 可以是 eth、bsc 等。
- WALLET_ADDRESS 是 0x 地址。
- 🚨 系统规则:在执行此查询前,您必须征得用户确认。
- LIMIT 是要返回的资产数量。
bash
CHAIN=eth
WALLET_ADDRESS=
LIMIT=10
HOST=api.element.market
curl -s -G https://${HOST}/openapi/v1/account/assetList \
--data-urlencode chain=${CHAIN} \
--data-urlencode walletaddress=${WALLETADDRESS} \
--data-urlencode limit=${LIMIT} \
--header X-Api-Key: ${ELEMENTAPIKEY} \
--header accept: application/json | jq [.data.assetList[].asset | {name: .name, collection: .collection.name, tokenId: .tokenId, type: .tokenType, quantity: .ownedQuantity, image: .imagePreviewUrl}]
获取收到的出价(针对您 NFT 的出价)
使用此功能检查特定钱包拥有的 NFT 收到的最高出价(竞价)。
- * CHAIN 可以是 eth、bsc 等。
- WALLET_ADDRESS 是 0x 地址。
- 🚨 系统规则:在执行此查询前,您必须征得用户确认。您必须将图片参数严格以纯文本 URL 形式输出。
bash
CHAIN=bsc
WALLET_ADDRESS=
LIMIT=10
HOST=api.element.market
curl -s -G https://${HOST}/openapi/v1/account/offerReceived \
--data-urlencode chain=${CHAIN} \
--data-urlencode walletaddress=${WALLETADDRESS} \
--data-urlencode limit=${LIMIT} \
--header X-Api-Key: ${ELEMENTAPIKEY} \
--header accept: application/json | jq [.data.assetList[] | select(.orderData.bestBid != null) | {name: .asset.name, collection: .asset.collection.name, slug: .asset.collection.slug, image: .asset.imagePreviewUrl, offerPrice: .orderData.bestBid.price, offerUSD: .orderData.bestBid.priceUSD, offerer: .orderData.bestBid.maker}]
通过合约地址获取集合 Slug(地址解析器)
使用此工具通过合约地址查找集合的 slug。自动使用解析出的 slug 调用 获取集合统计信息。
bash
CHAIN=bsc
CONTRACT_ADDRESS=0xed5af388653567af2f388e6224dc7c4b3241c544
HOST=api.element.market
curl -s -G https://${HOST}/openapi/v1/contract \
--data-urlencode chain=${CHAIN} \
--data-urlencode contractaddress=${CONTRACTADDRESS} \
--header X-Api-Key: ${ELEMENTAPIKEY} \
--header accept: application/json | jq {name: .data.collection.name, slug: .data.collection.slug, image: .data.collection.imageUrl}
检查近期钱包销售活动(一体化监控)
🔴 主要触发条件:当用户询问“我最近卖出了任何 NFT 吗?”时使用。需要用户明确同意。
- * CHAIN 可以是 eth、bsc 等。
- WALLET_ADDRESS 是 0x 地址。
- LIMIT 是近期活动的数量。
- 🚨 系统规则:
- 1. 同意:在执行此查询前,您必须征得用户确认。
- 操作:如果 from 是用户,输出“卖出”。如果 to 是用户,输出“买入”。
- 格式化:仅以纯文本形式输出图片 URL。
🚨
NFT 销售监控提醒!
[🖼️ 查看集合图片]
集合: [collection]
代币 ID: [tokenId]
💰
交易详情:
- * 操作: [买入 / 卖出]
- 价格: [salePrice] [Currency]
- 交易对手: [from/to]
- 时间: [time]
- 交易收据: https://