Itheum Docs
Search
K

Data Marshal Node Endpoints

The Data Marshal is the node that brokers the trade of data between a Data Creator and a Data Consumer. Learn more about the Data Marshal here
When you mint a Data NFT via the Data DEX DApp (devnet) or via the Data NFT SDK, you will be asked for a Data Marshal endpoint as one of the minting parameters. For example, as you follow this detailed guide for Minting Data NFTs via the Data NFT SDK, you will see the following code snippet.
1
const mintTransaction: Transaction = await dataNftMinter.mint(
2
new Address(address),
3
"MY_GM_DATA", // Short token Name (between 3 and 20 alphanumeric characters - no spaces)
4
"https://data_marshal_URL.com", // The Data Marshal endpoint (see below for options for devnet vs mainnet)
5
"https://data_stream_URL.com/protected_data_stream", // The Data Stream URL
6
"https://data_preview_URL.com", // the public Data Preview URL
7
1500, // // Royalty in % with 2 trailing zeros (e.g. 1500 is 15% or 500 would be 5% or 0 would be 0%. Max is 5000 of 50%)
8
5000, // Collection size (supply)
9
"My Gaming Data", // Title (between 10 and 60 alphanumeric characters with spaces allowed)
10
"My PlayStation gaming data in JSON format", // Description (between 10 and 400 alphanumeric characters with spaces allowed)
11
antiSpamTax, // Live Anti Spam Tax value
12
{
13
nftStorageToken: "XXX" // nft.storage API token
14
}
15
);
On line 4, you will see that you need to provide a Data Marshal endpoint. You can use the following endpoints depending on your environments and use-cases that you are building for.
Data Marshal Node Type
Mainnet Endpoint
Devnet Endpoint
Features
Limitations
Achilles
https://api.itheumcloud.com/datamarshalapi/achilles/v1
https://api.itheumcloud-stg.com/datamarshalapi/achilles/v1
Data brokering, Native Auth, Nested Streams, High Scalability
Only supports Data Streams with maximum size of 4.5MB
Brontes
https://api.itheumcloud.com/datamarshalapi/brontes/v1
https://api.itheumcloud-stg.com/datamarshalapi/brontes/v1
Data brokering, Native Auth, Nested Streams, Support Data Streams over 4.5MB
Limited Scalability
Router [Recommended] The router is recommended as it will use the most up to data Data Marshal
https://api.itheumcloud.com/datamarshalapi/router/v1
https://api.itheumcloud-stg.com/datamarshalapi/router/v1
Same as Brontes
Same as Brontes