The AgrospAI Data Space Portal supports a flexible fee structure for both publishers and consumers. This page explains how marketplace fees work and how to configure them.
Fee Structure Overview
The marketplace supports four types of fees:
- Publisher Market Order Fee - Absolute fee taken when an asset is ordered
- Publisher Market Fixed Swap Fee - Percentage fee when datatokens are bought from fixed rate exchange
- Consume Market Order Fee - Absolute fee taken when consuming an asset
- Consume Market Fixed Swap Fee - Percentage fee when buying datatokens as a consumer
Fee Configuration
Fees are configured through environment variables and the application configuration file.
Fee Recipient Address
NEXT_PUBLIC_MARKET_FEE_ADDRESS
The Ethereum address where all marketplace fees will be sent.Default: 0x9984b2453eC7D99a73A5B3a46Da81f197B753C8dConfiguration in app.config.js:marketFeeAddress:
process.env.NEXT_PUBLIC_MARKET_FEE_ADDRESS ||
'0x9984b2453eC7D99a73A5B3a46Da81f197B753C8d'
NEXT_PUBLIC_MARKET_FEE_ADDRESS="0x9984b2453eC7D99a73A5B3a46Da81f197B753C8d"
Ensure this address is controlled by your organization. All marketplace fees will be sent to this address and cannot be recovered if set incorrectly.
Publisher Fees
Publishers can earn fees from assets published on the marketplace.
Publisher Market Order Fee
NEXT_PUBLIC_PUBLISHER_MARKET_ORDER_FEE
Absolute fee value taken upon ordering an asset. This fee is declared during ERC20 datatoken creation.Default: 0Type: Absolute valueWhen charged: When a consumer orders/purchases an assetConfiguration in app.config.js:publisherMarketOrderFee:
process.env.NEXT_PUBLIC_PUBLISHER_MARKET_ORDER_FEE || '0'
# Set 1 token fee per order
NEXT_PUBLIC_PUBLISHER_MARKET_ORDER_FEE="1"
Publisher Market Fixed Swap Fee
NEXT_PUBLIC_PUBLISHER_MARKET_FIXED_SWAP_FEE
Percentage fee received by the publisher market when a datatoken is bought from a fixed rate exchange.Default: 0Type: PercentageWhen charged: When datatokens are purchased through fixed rate pricingConfiguration in app.config.js:publisherMarketFixedSwapFee:
process.env.NEXT_PUBLIC_PUBLISHER_MARKET_FIXED_SWAP_FEE || '0'
# Set 1% fee on fixed rate swaps
NEXT_PUBLIC_PUBLISHER_MARKET_FIXED_SWAP_FEE="1"
Consumer Fees
Consumers pay fees when purchasing or accessing data assets.
Consume Market Order Fee
NEXT_PUBLIC_CONSUME_MARKET_ORDER_FEE
Absolute fee value taken upon ordering an asset. This fee is specified at the time of order.Default: 0Type: Absolute valueWhen charged: When a consumer places an order for an assetConfiguration in app.config.js:consumeMarketOrderFee:
process.env.NEXT_PUBLIC_CONSUME_MARKET_ORDER_FEE || '0'
# Set 1 token fee for consuming
NEXT_PUBLIC_CONSUME_MARKET_ORDER_FEE="1"
Consume Market Fixed Swap Fee
NEXT_PUBLIC_CONSUME_MARKET_FIXED_SWAP_FEE
Percentage fee received by the consume market when a datatoken is bought from a fixed rate exchange.Default: 0Type: PercentageWhen charged: When consumers buy datatokens through fixed rate pricingConfiguration in app.config.js:consumeMarketFixedSwapFee:
process.env.NEXT_PUBLIC_CONSUME_MARKET_FIXED_SWAP_FEE || '0'
# Set 1% fee on fixed rate swaps
NEXT_PUBLIC_CONSUME_MARKET_FIXED_SWAP_FEE="1"
Fee Examples
Example 1: No Fees (Default)
By default, the marketplace operates with zero fees:
NEXT_PUBLIC_MARKET_FEE_ADDRESS="0x9984b2453eC7D99a73A5B3a46Da81f197B753C8d"
NEXT_PUBLIC_PUBLISHER_MARKET_ORDER_FEE="0"
NEXT_PUBLIC_PUBLISHER_MARKET_FIXED_SWAP_FEE="0"
NEXT_PUBLIC_CONSUME_MARKET_ORDER_FEE="0"
NEXT_PUBLIC_CONSUME_MARKET_FIXED_SWAP_FEE="0"
Example 2: Publisher-Only Fees
Charge publishers 1 token per order and 1% on fixed rate swaps:
NEXT_PUBLIC_MARKET_FEE_ADDRESS="0x9984b2453eC7D99a73A5B3a46Da81f197B753C8d"
NEXT_PUBLIC_PUBLISHER_MARKET_ORDER_FEE="1"
NEXT_PUBLIC_PUBLISHER_MARKET_FIXED_SWAP_FEE="1"
NEXT_PUBLIC_CONSUME_MARKET_ORDER_FEE="0"
NEXT_PUBLIC_CONSUME_MARKET_FIXED_SWAP_FEE="0"
Example 3: Consumer-Only Fees
Charge consumers 1 token per order and 1% on fixed rate swaps:
NEXT_PUBLIC_MARKET_FEE_ADDRESS="0x9984b2453eC7D99a73A5B3a46Da81f197B753C8d"
NEXT_PUBLIC_PUBLISHER_MARKET_ORDER_FEE="0"
NEXT_PUBLIC_PUBLISHER_MARKET_FIXED_SWAP_FEE="0"
NEXT_PUBLIC_CONSUME_MARKET_ORDER_FEE="1"
NEXT_PUBLIC_CONSUME_MARKET_FIXED_SWAP_FEE="1"
Example 4: Balanced Fee Structure
Charge both publishers and consumers:
NEXT_PUBLIC_MARKET_FEE_ADDRESS="0x9984b2453eC7D99a73A5B3a46Da81f197B753C8d"
NEXT_PUBLIC_PUBLISHER_MARKET_ORDER_FEE="1"
NEXT_PUBLIC_PUBLISHER_MARKET_FIXED_SWAP_FEE="1"
NEXT_PUBLIC_CONSUME_MARKET_ORDER_FEE="1"
NEXT_PUBLIC_CONSUME_MARKET_FIXED_SWAP_FEE="1"
How Fees Are Applied
Order Fee Flow
- Consumer initiates an asset purchase/order
- Order fee (if configured) is calculated
- Fee is transferred to the
marketFeeAddress
- Remaining payment goes to the publisher
Fixed Swap Fee Flow
- User buys datatokens from fixed rate exchange
- Swap percentage fee (if configured) is calculated
- Fee is transferred to the
marketFeeAddress
- Remaining tokens are delivered to the buyer
Fee Implementation Details
Fees are implemented at the smart contract level:
- Order fees are declared during ERC20 datatoken creation and enforced on-chain
- Fixed swap fees are applied during the token exchange process
- All fees are automatically sent to the configured
marketFeeAddress
Ocean Protocol Fee Collector
In addition to marketplace fees, Ocean Protocol has its own community fee collector:
Pontus-X DevNet:
opfCommunityFeeCollector: '0x1f84fB438292269219f9396D57431eA9257C23d4'
opfCommunityFeeCollector: '0xACC8d1B2a0007951fb4ed622ACB1C4fcCAbe778D'
Best Practices
Test fee configurations on a testnet before deploying to production to ensure fees are calculated correctly.
Start with low fees to encourage adoption, then adjust based on marketplace activity and operational costs.
Communicate fees clearly to publishers and consumers through your marketplace UI and terms of service.
Changing fee values requires updating environment variables and redeploying the application. Existing assets may retain old fee structures defined at creation time.
