Marketplace Information

By providing an appName in the GET URL (i.e. https://agent1.xyz/nft/getStats/opensea_collection?appName=yourAppID), you credit the API call to your developer account or app. This will allow the system to give rewards and bonuses accordingly.

Read collection information

Get AGENT1 collection info

GET https://agent1.xyz/nft/getStats/opensea_collection

Gets the full collection info of AGENT1 on the OpenSea marketplace. Includes floor price, max and minimum traits data and more.

Query Parameters

Name	Type	Description
appName	String	Specify your developer account or AppID here

200: OK Successfully read AGENT1 collection info

{
   "collection":{
      "editors":[
         "0x02f17d0b478a295355c15beeadaad0d227b5d710"
      ],
      "payment_tokens":[
         {
            "id":13689077,
            "symbol":"ETH",
            "address":"0x0000000000000000000000000000000000000000",
            "image_url":"https://openseauserdata.com/files/6f8e2979d428180222796ff4a33ab929.svg",
            "name":"Ether",
            "decimals":18,
            "eth_price":1,
            "usd_price":1635.329999999999927240423858165740966796875
         },
         {
            "id":4645681,
            "symbol":"WETH",
            "address":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "image_url":"https://openseauserdata.com/files/accae6b6fb3888cbff27a013729c22dc.svg",
            "name":"Wrapped Ether",
            "decimals":18,
            "eth_price":1,
            "usd_price":1635.329999999999927240423858165740966796875
         }
      ],
      "primary_asset_contracts":[
         {
            "address":"0xc679f22996efcc120626b18f9d01af1603b98952",
            "asset_contract_type":"non-fungible",
            "created_date":"2021-09-21T10:39:31.741938",
            "name":"Agent1",
            "nft_version":"3.0",
            "opensea_version":null,
            "owner":81560205,
            "schema_name":"ERC721",
            "symbol":"A10001",
            "total_supply":"0",
            "description":"**[SOLD OUT! Play now!](https://agent1.xyz/story)**\n\n**\ud83d\udc9f Make sure to \ud83d\udd04 Refresh metadata when buying from secondary!**\nOwners can reveal at [The Backdoor](https://moonlanders.game/backdoor)\n\nAGENT1 is the first \"software consumable/utility\" NFT, that renders its visuals based on the holders' actions and wallet contents. [Read the story](https://agent1.xyz/story) and find [easter eggs and codes](https://agent1.xyz/codes) as it \"polymorphs and grows\" with each trade and transaction.\n\nHolders' can merge them to form Super Agent1s. \n\nEach holder also gains access to the original MetaVerse: Moonlanders now available to play. New experiences in Q2 2023.\n\nPlay/Story: https://agent1.xyz/story\n\nTwitter: https://twitter.com/Agent1XYZ\n\nPlay Moonlanders: https://moonlanders.game\n\nDiscord: https://discord.gg/agent1\n",
            "external_link":"https://agent1.xyz",
            "image_url":"https://i.seadn.io/gae/355OQ0s-MuWz6Hte080ED-JMJXp8zfDkL9Sj6HwiR9poeQsMUTWOA-H0eAEU_05wqf8GXcbOXB91ZDeIcWmQj6VYqhjRpVhGxOKfo_0?w=500&auto=format",
            "default_to_fiat":false,
            "dev_buyer_fee_basis_points":0,
            "dev_seller_fee_basis_points":1000,
            "only_proxied_transfers":false,
            "opensea_buyer_fee_basis_points":0,
            "opensea_seller_fee_basis_points":250,
            "buyer_fee_basis_points":0,
            "seller_fee_basis_points":1250,
            "payout_address":"0x02f17d0b478a295355c15beeadaad0d227b5d710"
         }
      ],
      "traits":{
         "AGENT1":{
            "min":6,
            "max":9998
         },
         "Agility":{
            "???":2591
         },
         "Characters":{
            "min":1,
            "max":11
         },
         "Intelligence":{
            "???":2583
         },
         "Strength":{
            "???":2537
         },
         "upgrade":{
            "min":1672894800,
            "max":1706331600
         },
         "Background":{
            "???":7786,
            "blue":456,
            "yellow":397,
            "red":879,
            "purple":427,
            "dual color":25,
            "gold":27,
            "green":3,
            "white":1
         },
         "AI Program":{
            "???":7786,
            "anomaly":2088,
            "polymorphic":127
         },
         "Foreground":{
            "???":7786,
            "red":20,
            "metal gray":563,
            "gold":486,
            "blue":543,
            "green":2,
            "multi-color":17,
            "dual color":47,
            "chrome":535,
            "purple":1,
            "portrait":1
         },
         "Eye Color":{
            "yellow":16,
            "none":2023,
            "purple":21,
            "red":34,
            "white":28,
            "gold":5,
            "blue":53,
            "dual color":11,
            "black":17,
            "green":6,
            "silver":1
         },
         "Foreground Type":{
            "profile":803,
            "portrait":1321,
            "id":35,
            "poster":19,
            "too close":14,
            "statue":16,
            "split":2,
            "head-only":4,
            "dual color":1
         },
         "Active?":{
            "yes":2215
         }
      },
      "stats":{
         "one_hour_volume":0,
         "one_hour_change":0,
         "one_hour_sales":0,
         "one_hour_sales_change":0,
         "one_hour_average_price":0,
         "one_hour_difference":0,
         "six_hour_volume":0,
         "six_hour_change":0,
         "six_hour_sales":0,
         "six_hour_sales_change":0,
         "six_hour_average_price":0,
         "six_hour_difference":0,
         "one_day_volume":0.05159999999999999309441278683152631856501102447509765625,
         "one_day_change":-0.693768560886383056640625,
         "one_day_sales":4,
         "one_day_sales_change":-0.71428573131561279296875,
         "one_day_average_price":0.0128999999999999982736031967078815796412527561187744140625,
         "one_day_difference":-0.11689999999999999003019723886609426699578762054443359375,
         "seven_day_volume":0.97510999999999981024956241526524536311626434326171875,
         "seven_day_change":3.152938671209538856743392898351885378360748291015625,
         "seven_day_sales":74,
         "seven_day_average_price":0.01317716216216215964485147793538999394513666629791259765625,
         "seven_day_difference":0.7403099999999998015454139022040180861949920654296875,
         "thirty_day_volume":3.069829999999996061887941323220729827880859375,
         "thirty_day_change":0.7109074999860649501925990989548154175281524658203125,
         "thirty_day_sales":193,
         "thirty_day_average_price":0.015905854922279770435888934798640548251569271087646484375,
         "thirty_day_difference":1.275559999999996474429053705534897744655609130859375,
         "total_volume":16.24459966666659482825707527808845043182373046875,
         "total_sales":1102,
         "total_supply":10001,
         "count":10001,
         "num_owners":1701,
         "average_price":0.01474101603145788925985915085448141326196491718292236328125,
         "num_reports":1,
         "market_cap":131.784798783783770659283618442714214324951171875,
         "floor_price":0.0149000000000000000499600361081320443190634250640869140625
      },
      "banner_image_url":"https://i.seadn.io/gae/KCnc1S3KVtAFfa5i8Q1NygReBm8UxUgVuizelCJZMK1uslHniqI9ZUEWQbdP8xP6f-dD1KQ9FpeliIdFP1sggTJKQOGjgTY6uz4fBlE?w=500&auto=format",
      "chat_url":null,
      "created_date":"2021-10-16T09:05:52.795271+00:00",
      "default_to_fiat":false,
      "description":"**[SOLD OUT! Play now!](https://agent1.xyz/story)**\n\n**\ud83d\udc9f Make sure to \ud83d\udd04 Refresh metadata when buying from secondary!**\nOwners can reveal at [The Backdoor](https://moonlanders.game/backdoor)\n\nAGENT1 is the first \"software consumable/utility\" NFT, that renders its visuals based on the holders' actions and wallet contents. [Read the story](https://agent1.xyz/story) and find [easter eggs and codes](https://agent1.xyz/codes) as it \"polymorphs and grows\" with each trade and transaction.\n\nHolders' can merge them to form Super Agent1s. \n\nEach holder also gains access to the original MetaVerse: Moonlanders now available to play. New experiences in Q2 2023.\n\nPlay/Story: https://agent1.xyz/story\n\nTwitter: https://twitter.com/Agent1XYZ\n\nPlay Moonlanders: https://moonlanders.game\n\nDiscord: https://discord.gg/agent1\n",
      "dev_buyer_fee_basis_points":"0",
      "dev_seller_fee_basis_points":"1000",
      "discord_url":"https://discord.gg/agent1",
      "display_data":{
         "card_display_style":"contain",
         "images":null
      },
      "external_url":"https://agent1.xyz",
      "featured":false,
      "featured_image_url":"https://i.seadn.io/gae/j_88SdWm2q2DYOgaSgyL8UBtAf_scow8EhCWEBp6RpS5Kv3laYSDPNY2iKGqy4DCSkDpmT4Mv9K2pGHBePVdrZ444eawbt-03WxQ1w?w=500&auto=format",
      "hidden":false,
      "safelist_request_status":"not_requested",
      "image_url":"https://i.seadn.io/gae/355OQ0s-MuWz6Hte080ED-JMJXp8zfDkL9Sj6HwiR9poeQsMUTWOA-H0eAEU_05wqf8GXcbOXB91ZDeIcWmQj6VYqhjRpVhGxOKfo_0?w=500&auto=format",
      "is_subject_to_whitelist":false,
      "large_image_url":"https://i.seadn.io/gae/j_88SdWm2q2DYOgaSgyL8UBtAf_scow8EhCWEBp6RpS5Kv3laYSDPNY2iKGqy4DCSkDpmT4Mv9K2pGHBePVdrZ444eawbt-03WxQ1w?w=500&auto=format",
      "medium_username":"sprion",
      "name":"Agent1",
      "only_proxied_transfers":false,
      "opensea_buyer_fee_basis_points":"0",
      "opensea_seller_fee_basis_points":"250",
      "payout_address":"0x02f17d0b478a295355c15beeadaad0d227b5d710",
      "require_email":false,
      "short_description":null,
      "slug":"agent1",
      "telegram_url":null,
      "twitter_username":"Agent1XYZ",
      "instagram_username":null,
      "wiki_url":null,
      "is_nsfw":false,
      "fees":{
         "seller_fees":{
            "0x02f17d0b478a295355c15beeadaad0d227b5d710":1000
         },
         "opensea_fees":{
            "0x0000a26b00c1f0df003000390027140000faa719":250
         }
      },
      "is_rarity_enabled":false,
      "is_creator_fees_enforced":true
   }
}

204: No Content Failed to get data from marketplace

Get MOONROVER collection info

GET https://agent1.xyz/nft/getStats/moonrover_collection

Gets the full collection info of MOONROVER on the OpenSea marketplace. Includes floor price, max and minimum traits data and more.

Query Parameters

Name	Type	Description
appName	String	Specify your developer account or AppID here

200: OK Successfully read MOONROVER collection info

{
   "collection":{
      "editors":[
         "0x02f17d0b478a295355c15beeadaad0d227b5d710"
      ],
      "payment_tokens":[
         {
            "id":13689077,
            "symbol":"ETH",
            "address":"0x0000000000000000000000000000000000000000",
            "image_url":"https://openseauserdata.com/files/6f8e2979d428180222796ff4a33ab929.svg",
            "name":"Ether",
            "decimals":18,
            "eth_price":1,
            "usd_price":1644.48
         },
         {
            "id":4645681,
            "symbol":"WETH",
            "address":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "image_url":"https://openseauserdata.com/files/accae6b6fb3888cbff27a013729c22dc.svg",
            "name":"Wrapped Ether",
            "decimals":18,
            "eth_price":1,
            "usd_price":1644.48
         }
      ],
      "primary_asset_contracts":[
         {
            "address":"0xb49c41e276aa65312582d06fb36b376e2dfbc262",
            "asset_contract_type":"non-fungible",
            "created_date":"2022-09-06T08:46:40.770690",
            "name":"MoonRover",
            "nft_version":"3.0",
            "opensea_version":null,
            "owner":81560205,
            "schema_name":"ERC721",
            "symbol":"MROVER",
            "total_supply":"0",
            "description":"The collection is SOLD OUT. Combine with AGENT1 to unlock its full potential. https://agent1.xyz/story | [OS Collection](https://opensea.io/collection/agent1)\n\nMoonRover is the key to exploring and maintaining your Moonland in Moonlanders.game. Each MoonRover has its unique behavior, traits and is a Living NFT. Collect resources, explore new lands, and grow your Moonland.\n\nPowerful, rare and Anomalies lay out there to be found. [101 MoonRovers locked for giveaway & sale switch](https://moonlanders.game/mint)\n\nDo not list for sale under the Desertion Price:\n[MoonRover Whitepaper](https://docs.moonlanders.wiki/jericverse-cyborg/moonrovers) | [Play Now](https://moonlanders.game/moonrover)",
            "external_link":"https://moonlanders.game/mint",
            "image_url":"https://i.seadn.io/gcs/files/13b523a0d2d58fbbb670cf1199ec4c93.gif?w=500&auto=format",
            "default_to_fiat":false,
            "dev_buyer_fee_basis_points":0,
            "dev_seller_fee_basis_points":1000,
            "only_proxied_transfers":false,
            "opensea_buyer_fee_basis_points":0,
            "opensea_seller_fee_basis_points":250,
            "buyer_fee_basis_points":0,
            "seller_fee_basis_points":1250,
            "payout_address":"0xc0434058f4fdb9d2d9d8f7a3016a4a6780b0b1ec"
         }
      ],
      "traits":{
         "Shell":{
            "???":1022
         },
         "Frame":{
            "???":1022
         },
         "System":{
            "???":1022
         },
         "Discovery":{
            "???":1022
         },
         "System Tier":{
            "???":1022
         },
         "Machine":{
            "???":1022
         },
         "ARTIFACT?":{
            "???":1022
         },
         "GEM?":{
            "???":1022
         },
         "Type":{
            "???":1022
         },
         "Status":{
            "impounded":94,
            "developing":231
         }
      },
      "stats":{
         "one_hour_volume":0,
         "one_hour_change":0,
         "one_hour_sales":0,
         "one_hour_sales_change":0,
         "one_hour_average_price":0,
         "one_hour_difference":0,
         "six_hour_volume":0,
         "six_hour_change":0,
         "six_hour_sales":0,
         "six_hour_sales_change":0,
         "six_hour_average_price":0,
         "six_hour_difference":0,
         "one_day_volume":0,
         "one_day_change":0,
         "one_day_sales":0,
         "one_day_sales_change":0,
         "one_day_average_price":0,
         "one_day_difference":0,
         "seven_day_volume":0,
         "seven_day_change":0,
         "seven_day_sales":0,
         "seven_day_average_price":0,
         "seven_day_difference":0,
         "thirty_day_volume":0.1,
         "thirty_day_change":0,
         "thirty_day_sales":2,
         "thirty_day_average_price":0.05,
         "thirty_day_difference":0,
         "total_volume":1.05719999,
         "total_sales":60,
         "total_supply":1020,
         "count":1020,
         "num_owners":655,
         "average_price":0.017619999833333334,
         "num_reports":0,
         "market_cap":0,
         "floor_price":0.1
      },
      "banner_image_url":"https://i.seadn.io/gcs/files/189bca735529116e86219b83e8e66d5b.png?w=500&auto=format",
      "chat_url":null,
      "created_date":"2022-09-06T08:46:48.676321+00:00",
      "default_to_fiat":false,
      "description":"The collection is SOLD OUT. Combine with AGENT1 to unlock its full potential. https://agent1.xyz/story | [OS Collection](https://opensea.io/collection/agent1)\n\nMoonRover is the key to exploring and maintaining your Moonland in Moonlanders.game. Each MoonRover has its unique behavior, traits and is a Living NFT. Collect resources, explore new lands, and grow your Moonland.\n\nPowerful, rare and Anomalies lay out there to be found. [101 MoonRovers locked for giveaway & sale switch](https://moonlanders.game/mint)\n\nDo not list for sale under the Desertion Price:\n[MoonRover Whitepaper](https://docs.moonlanders.wiki/jericverse-cyborg/moonrovers) | [Play Now](https://moonlanders.game/moonrover)",
      "dev_buyer_fee_basis_points":"0",
      "dev_seller_fee_basis_points":"1000",
      "discord_url":"https://discord.gg/agent1",
      "display_data":{
         "card_display_style":"contain",
         "images":null
      },
      "external_url":"https://moonlanders.game/mint",
      "featured":false,
      "featured_image_url":"https://i.seadn.io/gcs/files/96714b8fdd6f6abb90263242ea0969b6.png?w=500&auto=format",
      "hidden":false,
      "safelist_request_status":"not_requested",
      "image_url":"https://i.seadn.io/gcs/files/13b523a0d2d58fbbb670cf1199ec4c93.gif?w=500&auto=format",
      "is_subject_to_whitelist":false,
      "large_image_url":"https://i.seadn.io/gcs/files/96714b8fdd6f6abb90263242ea0969b6.png?w=500&auto=format",
      "medium_username":null,
      "name":"MoonRover",
      "only_proxied_transfers":false,
      "opensea_buyer_fee_basis_points":"0",
      "opensea_seller_fee_basis_points":"250",
      "payout_address":"0xc0434058f4fdb9d2d9d8f7a3016a4a6780b0b1ec",
      "require_email":false,
      "short_description":null,
      "slug":"moonrover",
      "telegram_url":null,
      "twitter_username":"Agent1XYZ",
      "instagram_username":null,
      "wiki_url":null,
      "is_nsfw":false,
      "fees":{
         "seller_fees":{
            "0xc0434058f4fdb9d2d9d8f7a3016a4a6780b0b1ec":1000
         },
         "opensea_fees":{
            "0x0000a26b00c1f0df003000390027140000faa719":250
         }
      },
      "is_rarity_enabled":true,
      "is_creator_fees_enforced":true
   }
}

204: No Content Failed to get data from marketplace