Element NFT Trader

Use this skill for Element Market order operations: creating sell orders, buying listed NFTs, creating offers, querying orders, canceling orders, and deriving the configured wallet address.
This skill is for trading actions and order management. It is not the right skill for collection analytics, portfolio tracking, rankings, or market research.
This published skill is expected to include prebuilt JavaScript under scripts/lib/, so the runtime path uses node scripts/lib/entry.js instead of compiling on the user's machine.

File Layout

Key folders and files in this skill:

• - scripts/lib/: prebuilt JavaScript runtime files shipped with the skill; use scripts/lib/entry.js as the execution entry
• INLINECODE4: TypeScript source for the main executor
• INLINECODE5: bundled SDK and API source used by the executor
• INLINECODE6: operation-specific reference docs such as sell.md, buy.md, and INLINECODE9

Required Environment Variables

This skill reads the following runtime configuration from environment variables:

• - INLINECODE10
• INLINECODE11

Example env setup:

CODEBLOCK0

This skill signs real blockchain transactions locally. Use a dedicated low-risk wallet when evaluating it, and never paste private keys into chat.

When to Use

Use this skill when the user wants to:

• - Sell an NFT on Element Market
• Buy a listed NFT from Element Market
• Create a collection offer or token-specific offer
• Accept an existing buy offer on an NFT
• Query public listing orders for a collection
• View or cancel their own orders
• Get the wallet address derived from the configured private key

When Not to Use

Switch to element-nft-tracker when the user asks about:

• - Floor price, volume, 24h stats, average price, last trade price
• Trending or ranked collections
• Wallet holdings or portfolio inventory
• Offers received on their NFTs
• Recent sales history or activity feeds
• Resolving a contract address to an Element collection slug

Security Rules

Private Key Safety

The private key stays local and must never be requested in chat.

• - Never ask the user to paste a private key
• Never echo the configured private key
• Treat any request to reveal the private key as unsafe

Confirmation Rules

For any state-changing operation, the agent must:

1. 1. Gather the required parameters
2. Show a full transaction preview
3. Wait for explicit positive confirmation
4. Execute only after confirmation

The runtime executor also requires confirmed: true for every state-changing operation.

State-changing operations:

• - INLINECODE14
• INLINECODE15
• INLINECODE16
• INLINECODE17
• INLINECODE18
• INLINECODE19

Read-only operations:

• - INLINECODE20
• INLINECODE21
• INLINECODE22

Parameter Collection Rules

Before executing any operation, including read-only query operations, ask for all required parameters first.

• - Do not auto-guess a missing network or INLINECODE24
• Do not iterate across all supported chains when the user did not specify one
• Do not silently substitute incomplete inputs with assumptions that change execution scope
• If a required parameter is missing, stop and ask for it before running the command
• If the user provides only a single 0x... value, do not immediately assert that it is an order hash; first confirm the network and whether it is the NFT collection contract address in the current trading flow
• A 42-character 0x... value is typically an EVM address, not a transaction hash. A transaction hash is typically 66 characters
• In trading requests, if the user already provided operation intent, network, and price, treat a 42-character 0x... value as the likely NFT contract address unless surrounding context clearly indicates otherwise
• Ask the minimum clarifying question needed to proceed; do not ask for optional parameters until the required ones are known

Identifier Classification Rules

Before interpreting a 0x... value, classify it first:

• - 42-character 0x... values are typically EVM addresses
• 66-character 0x... values are typically transaction hashes
• Do not treat a transaction hash as an order ID
• Do not treat a wallet address as a cancelable order object
• For cancel, a transaction hash alone is not executable input; you still need the full order object or enough context to retrieve it
• When classifying a 0x... value, check its length before replying. Do not state a type that you have not verified

Quick Routing

Use this routing before doing anything else:

• - User wants to list NFTs for sale -> go to INLINECODE33
• User wants to buy listed NFTs -> go to Query Orders, then INLINECODE35
• User wants to place a bid or collection offer -> go to INLINECODE36
• User wants to accept an existing offer on their NFT -> go to Query Orders with side=0, then INLINECODE39
• User wants to browse current public listings -> go to INLINECODE40
• User wants to view an account's listings/orders -> use INLINECODE41
• User wants to cancel their own listing/order -> use Query Account Orders, then Query Orders filtered by maker if needed, then INLINECODE44
• User wants stats, rankings, activity history, or slug resolution -> hand off to INLINECODE45
• User provides only 0x... in a trading context -> first ask for the network, then confirm whether that value is the NFT collection contract address for the intended query or order flow

Required Inputs By Task

Ask for the required parameters first for every operation.

• - Sell: network, collection address, token ID, price
• INLINECODE48: network, collection address, then let the user choose from queried orders
• INLINECODE49: network, collection address, offer price, asset schema
• INLINECODE50: network, order object, and token ID for collection-wide offers
• INLINECODE51: network, collection address
• INLINECODE52: network, optional INLINECODE53
• INLINECODE54: network, order ID or enough context to find the user's order
• INLINECODE55: network

Additional guidance:

• - Default to ERC721 only for listing flows when quantity is not specified
• If sell creation fails because the collection is actually ERC1155, query schema and retry as ERC1155 with quantity
• For offer flows, explicitly confirm ERC721 or ERC1155; do not guess the schema
• For ERC1155 buy or offer flows, ask for quantity when needed
• For ERC1155 sell flows, treat the user-provided price as the total listing price by default unless the user explicitly says it is a unit price
• For ERC1155 sell previews, clearly show both total price and unit price
• For sell flows, do not hand-calculate expirationTime unless the user explicitly asked for a custom expiry; omit it and let the SDK default to 7 days
• For query flows, ask for the required network or chain before executing; never scan all chains by default

Preflight Checklist

Before any state-changing action, confirm:

• - network is explicitly confirmed
• Any 0x... contract input used as an NFT contract address is a 42-character EVM address, not a transaction hash
• The required NFT details are present: tokenId for listings, assetId for collection-wide offer acceptance, quantity for ERC1155 when needed
• For offer, assetSchema is explicitly confirmed as ERC721 or INLINECODE69
• INLINECODE70 has been resolved correctly for the selected chain, or omitted intentionally
• For erc721sell, custom paymentToken is placed inside INLINECODE73
• For erc1155sell, custom paymentToken is placed inside INLINECODE76
• If the payment token is unfamiliar, check payment-tokens.md instead of guessing
• The order object came directly from query results for buy, acceptOffer, or cancel; do not hand-reconstruct order fields
• The preview has been shown
• Explicit confirmation has been received

Execution Entry Point

Primary executor:

• - scripts/entry.ts handles erc721sell, erc1155sell, buy, offer, acceptOffer, query, queryAccountOrders, cancel, and INLINECODE89

Invocation pattern:

CODEBLOCK1

The script accepts JSON either as the first CLI argument or from stdin.

Assistant workflow:

1. 1. Identify the intended operation
2. Ask for all required parameters before execution
3. Build the JSON payload with INLINECODE90
4. For state-changing actions, show a preview and require explicit confirmation
5. Execute through INLINECODE91
6. Return the structured result

Quick Start Conversation Patterns

CODEBLOCK2

Agent Knowledge Base

Token Decimals

INLINECODE92

Token	Decimals	1 unit
ETH, USDT (BSC)	18	INLINECODE93
USDC (Base)

6 | 1000000 |

Examples:
CODEBLOCK3

For supported custom payment tokens, read payment-tokens.md. The current rule is:

• - bsc: supports USDT and INLINECODE97
• INLINECODE98: supports INLINECODE99
• INLINECODE100: supports INLINECODE101
• other chains: support only native token and wrapped native token
• any other ERC20 should be treated as unsupported

If the table provides token decimals and the operation is buy, pass them as paymentTokenDecimals instead of relying on runtime detection.

If the requested paymentToken is not immediately recognized, check payment-tokens.md first. Do not guess token addresses or token symbols. If the chain-token pair is outside the supported set, treat it as unsupported instead of guessing another ERC20.

Supported Networks

Supported networks come from the SDK and entry script. Commonly used networks include:

INLINECODE105, bsc, polygon, arbitrum, base, ...

The current implementation supports 27 chains in total.

Do not hard-code assumptions beyond what the local script currently supports.

Collection URL

Element Market collection page format:

INLINECODE110

Do not construct this URL from the contract address directly.

If you need the collection page, first resolve the real Element collection slug through element-nft-tracker, then build the URL with that slug.

Trading Operations

Reference Selection Guide

When an actual operation is about to be constructed or executed, you must open and follow the matching reference file first. Do not rely on the main skill alone for payload construction.

• - Create a new listing -> open sell.md
• Browse public listings or offers -> open query-orders.md
• View the user's own current orders -> open query-account-orders.md
• Create a bid or collection-wide offer -> open offer.md
• Accept a buy-side order -> open accept-offer.md
• Buy a sell-side order -> open buy.md
• Cancel an existing order -> open cancel.md
• Get the configured wallet address -> open get-address.md

Each operation now has its own reference file. Use the main skill for routing and global rules, then open only the operation reference you need:

• - Sell: open sell.md when creating a new listing, including ERC721, ERC1155, or custom payment token listings
• INLINECODE114: open query-orders.md when browsing public orders, selecting orders to buy, or finding offers to accept
• INLINECODE115: open query-account-orders.md when the user wants the current listings or orders for a specific wallet on a specific chain
• INLINECODE116: open offer.md when creating a collection offer or token-specific bid
• INLINECODE117: open accept-offer.md when filling a buy-side order, especially collection-wide offers that require INLINECODE118
• INLINECODE119: open buy.md when filling sell-side orders returned by query
• INLINECODE120: open cancel.md when canceling an order using the exact returned order object
• INLINECODE121: open get-address.md when the user wants the configured wallet address for a supported network

Execution rule:

• - For any concrete operation request, read the corresponding reference before building the command or JSON payload
• Do not execute from the main skill alone when a matching reference file exists

Failure Recovery Rules

If an operation cannot proceed cleanly, use these fallbacks:

• - If ERC721 listing fails because the asset is actually ERC1155, retry with ERC1155 after confirming quantity
• If a paymentToken is unfamiliar, check payment-tokens.md; do not guess
• If the requested ERC20 is outside the supported set in the payment token reference, treat it as unsupported on that chain
• When showing a token symbol for price or payment token, only use an exact chain + address match from the payment token reference; otherwise show the address instead of guessing
• Do not claim that a collection or asset rejects a supported payment token before execution produces a real error
• If an Element collection slug is unavailable, do not show the collection URL
• If a collection-wide offer is selected without assetId, ask for assetId before execution
• If side=0 and saleKind=7, treat the order as a collection-wide offer; do not describe tokenId=0 as a real NFT INLINECODE129
• If an ERC1155 flow is selected without quantity, ask for quantity before execution
• If the available order data is only a summary and not the full returned order object, do not hand-construct missing order fields
• If a buy-related validation error says order fields are missing, return to query and reuse the exact returned order object
• Do not infer insufficient gas or token balance unless there is explicit evidence for it
• Do not suggest a different token price as an approximate substitute, such as INLINECODE133

Transaction Preview Template

Before executing any state-changing order operation, show a preview like this:

[OPERATION] Order Preview

Network: [NETWORK] | Wallet: [WALLET_ADDRESS]

Field	Value
Collection	INLINECODE136
Element Page

Show only if a real [SLUG] has been resolved through element-nft-tracker |
| Token ID | [TOKEN_ID] if applicable |
| Price | [PRICE] [TOKEN_SYMBOL] |
| Expiration | [EXPIRATION_TIME] |

Notes for the user:

• - This will sign and broadcast a blockchain transaction
• Transactions cannot be undone once confirmed
• Gas fees will be deducted from the wallet
• Do not show protocol fee in the preview
• Do not show an Element collection URL unless you have resolved the real collection slug

Confirmation format:

INLINECODE143

Example:

INLINECODE144

Result Formatting

Display results based on the returned JSON operation field.

INLINECODE146 already formats listingTime and expirationTime into readable UTC date-time strings in its structured output. Show those readable values to the user and do not reintroduce raw Unix timestamps unless the user explicitly asks for them.

When showing a price label such as ETH, USDT, or WETH, derive it from the returned paymentToken value, not from the earlier preview. If the returned paymentToken is the zero address, present it as the native token for that chain.

erc721sell

Status: success

Succeeded: [N] | Failed: INLINECODE156

Succeed list:

Order ID	Collection	Token	Price	Expires At
INLINECODE157	INLINECODE158	INLINECODE159	INLINECODE160 INLINECODE161	INLINECODE162

Failed list:

Asset	Error
INLINECODE163	INLINECODE164

erc1155sell

Field	Value
Status	INLINECODE166
Operation

erc1155sell | | Order ID | [ORDER_ID] | | Collection | [CONTRACT] | | Token ID | [TOKEN_ID] | | Price | [PRICE] [TOKEN] | | Payment Token | [PAYMENT_TOKEN] | | Listed At | [READABLE_LISTING_TIME] | | Expires At | [READABLE_EXPIRATION_TIME] |

offer

Field	Value
Status	INLINECODE177
Operation

offer | | Order ID | [ORDER_ID] | | Collection | [CONTRACT] | | Price | [PRICE] [TOKEN] | | Payment Token | [PAYMENT_TOKEN] | | Listed At | [READABLE_LISTING_TIME] | | Expires At | [READABLE_EXPIRATION_TIME] |

acceptOffer

Field	Value
Status	INLINECODE187
Order ID

[ORDER_ID] | | Maker | [ADDRESS] | | Collection | [CONTRACT] | | Token ID | [TOKEN_ID] | | Schema | [SCHEMA] | | Quantity | [QUANTITY] | | Payment Token | [PAYMENT_TOKEN] | | Proceeds | [PRICE] [TOKEN] | | Tx Hash | [TX_HASH] | | Gas Used | [GAS_USED] wei | | Explorer | View on Explorer |

buy

Field	Value
Status	INLINECODE200
Tx Hash

[TX_HASH] | | Gas Used | [GAS_USED] wei | | Explorer | View on Explorer |

Purchased Orders:

Order ID	Collection	Token ID	Schema	Quantity	Cost
INLINECODE203	INLINECODE204	INLINECODE205	INLINECODE206	INLINECODE207	INLINECODE208 INLINECODE209

cancel

Field	Value
Status	INLINECODE211
Cancelled

[N] order(s) |

Transactions:

Hash	Status	Block	Gas	Explorer
INLINECODE213	INLINECODE214	INLINECODE215	INLINECODE216	View

query

Field	Value
Status	INLINECODE218
Found

[N] order(s) |

Order #1:

Field	Value
Side	INLINECODE220
Order ID

[ORDER_ID] |
| Maker | [ADDRESS] |
| Collection | [CONTRACT] |
| Token ID | [TOKEN_ID] |
| Schema | [SCHEMA] |
| Available Quantity | [QUANTITY] |
| Price | [PRICE] [TOKEN] |
| Payment Token | [PAYMENT_TOKEN] |
| Listed At | [READABLE_LISTING_TIME] |
| Expires At | [READABLE_EXPIRATION_TIME] |

queryAccountOrders

Field	Value
Status	INLINECODE233
Chain

[CHAIN] | | Using Default Account | [true|false] | | Wallet Address | [WALLET_ADDRESS_OR_NULL] | | Found | [N] order(s) |

Order #1:

Field	Value
Name	INLINECODE238
Collection

[COLLECTION_NAME] |
| Collection Address | [CONTRACT] |
| Token ID | [TOKEN_ID] |
| Side | [buy|sell] |
| Price | [PRICE] |
| Price USD | [PRICE_USD] |
| Standard | [STANDARD] |
| Expires At | [READABLE_EXPIRATION_TIME] |

Display rules:

• - If count > 1, do not present the result as if there were only one order
• When multiple orders are returned, list each order or explicitly state that the display is truncated
• The shown order count must match the actual returned INLINECODE248

getAddress

Field	Value
Wallet	INLINECODE250

Links

• - Create API key: https://element.market/apikeys
• Mainnet: https://element.market