This guide will walk you through the process of listing Bitcoin Ordinal inscriptions on Magic Eden, including the different JSON formats accepted by the platform.
Inscription IDs only
The simplest way to list Bitcoin Ordinal inscriptions on Magic Eden is by providing the inscription IDs. Here is an example JSON format:
[
{
"id": "0f626bcfc3a33e8afd69a570f1dd65bf4201d3454cc07bb2d2f972db28b03a9bi0"
},
{
"id": "e66cc4d665a535ce3c9bc351365d7d179a87c6f430f51b2409b84c557bf89fc7i0"
},
{
"id": "643e419b0f09fe0fa9b27df6a2ee19417c68e2656e8777515f2728ce2a182087i0"
},
{
"id": "211df992eb3019f4a2e9e777fbd257018e80ab0eaf27bea60e63d9f0aeadee5bi0"
}
]
Make sure to replace the id
values with the actual Bitcoin Ordinal inscription IDs you want to list.
Metadata with name only
To provide more information about the Bitcoin Ordinal inscriptions, you can include the inscription names along with the IDs. Here is an example JSON format:
[
{
"id": "0f626bcfc3a33e8afd69a570f1dd65bf4201d3454cc07bb2d2f972db28b03a9bi0",
"meta": {
"name": "Bitcoin Bandit #1"
}
},
{
"id": "e66cc4d665a535ce3c9bc351365d7d179a87c6f430f51b2409b84c557bf89fc7i0",
"meta": {
"name": "Bitcoin Bandit #2"
}
},
{
"id": "643e419b0f09fe0fa9b27df6a2ee19417c68e2656e8777515f2728ce2a182087i0",
"meta": {
"name": "Bitcoin Bandit #3"
}
},
{
"id": "211df992eb3019f4a2e9e777fbd257018e80ab0eaf27bea60e63d9f0aeadee5bi0",
"meta": {
"name": "Bitcoin Bandit #4"
}
}
]
In this format, each inscription object includes an id
and a meta
object containing the name
of the inscription.
Metadata with inscription IDs, name, attributes but no high-resolution image link
This will be useful for creators who do not want to include a high-resolution image link.
[
{
"id": "0f626bcfc3a33e8afd69a570f1dd65bf4201d3454cc07bb2d2f972db28b03a9bi0",
"meta": {
"name": "Bitcoin Bandit #1",
"attributes": [
{
"trait_type": "Clan",
"value": "Aoi"
},
{
"trait_type": "Class",
"value": "Warrior"
}
]
}
},
// Additional entries...
]
Metadata with inscription IDs, name, attributes, and high-resolution image link
This format is useful for projects that want to provide larger, more detailed art than what is stored on the Bitcoin blockchain. You can leave out attribute information if you only want to include the high-resolution image. Here is an example JSON:
[
{
"id": "0f626bcfc3a33e8afd69a570f1dd65bf4201d3454cc07bb2d2f972db28b03a9bi0",
"meta": {
"name": "Bitcoin Bandit #1",
"high_res_img_url": "https://hi_res_img.png",
"attributes": [
{
"trait_type": "Clan",
"value": "Aoi"
},
{
"trait_type": "Class",
"value": "Warrior"
}
]
}
},
{
"id": "e66cc4d665a535ce3c9bc351365d7d179a87c6f430f51b2409b84c557bf89fc7i0",
"meta": {
"name": "Bitcoin Bandit #2",
"high_res_img_url": "https://hi_res_img.png",
"attributes": [
{
"trait_type": "Clan",
"value": "Aoi"
},
{
"trait_type": "Class",
"value": "Warrior"
}
]
}
},
{
"id": "643e419b0f09fe0fa9b27df6a2ee19417c68e2656e8777515f2728ce2a182087i0",
"meta": {
"name": "Bitcoin Bandit #3",
"high_res_img_url": "https://hi_res_img.png",
"attributes": [
{
"trait_type": "Clan",
"value": "Aoi"
},
{
"trait_type": "Class",
"value": "Warrior"
}
]
}
},
{
"id": "211df992eb3019f4a2e9e777fbd257018e80ab0eaf27bea60e63d9f0aeadee5bi0",
"meta": {
"name": "Bitcoin Bandit #4",
"high_res_img_url": "https://hi_res_img.png",
"attributes": [
{
"trait_type": "Clan",
"value": "Aoi"
},
{
"trait_type": "Class",
"value": "Warrior"
}
]
}
}
]
In this format, each inscription object includes an id
and a meta
object containing the name
, high_res_img_url
, and attributes
of the inscription. The attributes
can provide additional information about the inscription, these can be determined by the creator of the project.
Make sure to replace the placeholder values with the actual information for your Bitcoin Ordinal inscriptions.
We recommend that you host your high-resolution image on a decentralised storage platform such as IPFS.
If you need assistance with formatting your JSON data, you can use the website jsonformatter.org. It can be a helpful resource when working with complex JSON structures or when you want to ensure your code follows the correct syntax.
By following this guide and providing the necessary information in the appropriate JSON format, you will be able to list Bitcoin Ordinal inscriptions on Magic Eden and make them available for trading and sale on the platform.