omni_nft_royalty_split
Calculate creator royalty splits, marketplace fees, and net seller payout for secondary NFT sales to determine exact proceeds and total deductions.
Instructions
NFT Marketplace Creator Royalty Split & Net Secondary Proceeds. Calculate creator royalty splits, marketplace fees (OpenSea, Blur, Magic Eden), and net seller payout on secondary NFT market sales. Discipline: CRYPTO. Governing mathematical model / formula: Net Seller Payout = Sale Price - Marketplace Fee - Creator Royalty Fee.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of net_seller_payout_eth (Net Seller Payout), creator_royalty_earned (Creator Royalty Received), marketplace_cut_usd (Marketplace Fee Deducted), total_deduction_pct (Total Overhead Cut) using nft_sale_price_eth (NFT Gross Sale Price (ETH or SOL) in ETH), marketplace_fee_pct (Marketplace Platform Fee (%) in %), creator_royalty_pct (Enforced Creator Royalty (%) in %), eth_market_price_usd (Native Token Price ($ USD)). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
SIBLING ROUTING: Use this dedicated specialist tool for 'NFT Marketplace Creator Royalty Split & Net Secondary Proceeds' rather than generic dispatchers like omni_universal_query. For cross-discipline dynamic dispatch, see omni_universal_query.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "nft-royalty-split"
category (string): "crypto"
name (string): "NFT Marketplace Creator Royalty Split & Net Secondary Proceeds"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.net_seller_payout_eth (Net Seller Payout): Formatted display string (e.g. '2.36 ETH ($7,560.00)')
metrics.creator_royalty_earned (Creator Royalty Received): Formatted display string (e.g. '0.125 ETH ($400.00)')
metrics.marketplace_cut_usd (Marketplace Fee Deducted): Formatted display string (e.g. '0.0125 ETH ($40.00)')
metrics.total_deduction_pct (Total Overhead Cut): Formatted display string (e.g. '5.5% Total Deductions')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_nft_royalty_split"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nft_sale_price_eth | No | NFT Gross Sale Price (ETH or SOL) (ETH). Agreed secondary market transaction price. Default: 2.5. Min: 0.05. Max: 250. | |
| creator_royalty_pct | No | Enforced Creator Royalty (%) (%). Original artist / collection royalty share. Default: 5. Min: 0. Max: 15. | |
| marketplace_fee_pct | No | Marketplace Platform Fee (%) (%). Blur = 0.5%, OpenSea = 2.5%, Magic Eden = 2.0%. Default: 0.5. Min: 0. Max: 5. | |
| eth_market_price_usd | No | Native Token Price ($ USD). Current ETH or SOL spot price. Default: 3200. Min: 10. Max: 10000. |