Skip to content
yjjjwww edited this page Aug 16, 2022 · 9 revisions

Welcome to the BEB-05-Yoons-Family wiki!

<API ๋ช…์„ธ์„œ>

- NFT ๋ฌด์ž‘์œ„๋กœ ์›ํ•˜๋Š” ๊ฐœ์ˆ˜๋กœ ์กฐํšŒ

Request

GET /opensea

Parameter

Parameter Type Description Necessary
limit ์ˆซ์ž ์กฐํšŒํ•˜๊ณ  ์‹ถ์€ NFT์˜ ์ˆ˜ ํ•„์ˆ˜

ex)/opensea?limit=8

Response

์‘๋‹ต์€ ๋‹ค์Œ๊ณผ ๊ฐ™์€ JSON ํ˜•์‹์ž…๋‹ˆ๋‹ค.

[
    {
        "id": 583254620,
        "num_sales": 0,
        "background_color": null,
        "image_url": "https://lh3.googleusercontent.com/ixvxtnJO76dwvSlBU3g2ho5gcbK01bBzNSuZMv-iQ23-lmUsBp3HFJ82LhDDf8Wegrs1u236zNnseQRYKH6YwyA-0ZL0b5M_tQsj",
        "image_preview_url": "https://lh3.googleusercontent.com/ixvxtnJO76dwvSlBU3g2ho5gcbK01bBzNSuZMv-iQ23-lmUsBp3HFJ82LhDDf8Wegrs1u236zNnseQRYKH6YwyA-0ZL0b5M_tQsj=s250",
        "image_thumbnail_url": "https://lh3.googleusercontent.com/ixvxtnJO76dwvSlBU3g2ho5gcbK01bBzNSuZMv-iQ23-lmUsBp3HFJ82LhDDf8Wegrs1u236zNnseQRYKH6YwyA-0ZL0b5M_tQsj=s128",
        "image_original_url": null,
        "animation_url": null,
        "animation_original_url": null,
        "name": "Proud Lions Club #1378",
        "description": null,
        "external_link": null,
        "asset_contract": {
            "address": "0x495f947276749ce646f68ac8c248420045cb7b5e",
            "asset_contract_type": "semi-fungible",
            "created_date": "2020-12-02T17:40:53.232025",
            "name": "OpenSea Collection",
            "nft_version": null,
            "opensea_version": "2.0.0",
            "owner": 458910490,
            "schema_name": "ERC1155",
            "symbol": "OPENSTORE",
            "total_supply": null,
            "description": "",
            "external_link": null,
            "image_url": "https://openseauserdata.com/files/860b94bee079e3864d04849383d2b4d1.bin",
            "default_to_fiat": false,
            "dev_buyer_fee_basis_points": 0,
            "dev_seller_fee_basis_points": 0,
            "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": 250,
            "payout_address": null
        },
        "permalink": "https://opensea.io/assets/ethereum/0x495f947276749ce646f68ac8c248420045cb7b5e/23739362589833214218042992734890100206674559438404508682768786642835142082561",
        "collection": {
            "banner_image_url": "https://openseauserdata.com/files/873b29124522c65ba58454c5fd038c3a.jpg",
            "chat_url": null,
            "created_date": "2022-08-11T14:52:24.093013",
            "default_to_fiat": false,
            "description": "A collection of warrior Lions and Lionesses. The NFTs will be your pass into the Lionverse Metaverse and also enjoy Travel discounts. Holders can earn daily staking rewards, morph and breed their Lions to upgrade stats.\nWe are building our metaverse (Lionverse), which will support our native 'Steak' tokens, holders can play our P2E games and earn big rewards. The Lionverse will, have a number of mini play to earn games as well as lands for other projects, which they can customized and integrated with their own NFTs. Our lion holders will benefit from the land sales and upgrades revenue via the 'Steak' tokens.The Lionverse Alpha is already deployed and holders can enjoy AMAs and game events weekly!",
            "dev_buyer_fee_basis_points": "0",
            "dev_seller_fee_basis_points": "0",
            "discord_url": null,
            "display_data": {
                "card_display_style": "contain"
            },
            "external_url": null,
            "featured": false,
            "featured_image_url": "https://openseauserdata.com/files/873b29124522c65ba58454c5fd038c3a.jpg",
            "hidden": false,
            "safelist_request_status": "not_requested",
            "image_url": "https://openseauserdata.com/files/e8b9fdbc00c46cd5024929379f6fcca5.png",
            "is_subject_to_whitelist": false,
            "large_image_url": "https://openseauserdata.com/files/873b29124522c65ba58454c5fd038c3a.jpg",
            "medium_username": null,
            "name": "Lions Official Proud Club",
            "only_proxied_transfers": false,
            "opensea_buyer_fee_basis_points": "0",
            "opensea_seller_fee_basis_points": "250",
            "payout_address": null,
            "require_email": false,
            "short_description": null,
            "slug": "lions-official-proud-club",
            "telegram_url": null,
            "twitter_username": null,
            "instagram_username": null,
            "wiki_url": null,
            "is_nsfw": false
        },
        "decimals": null,
        "token_metadata": null,
        "is_nsfw": false,
        "owner": {
            "user": {
                "username": "NullAddress"
            },
            "profile_img_url": "https://storage.googleapis.com/opensea-static/opensea-profile/1.png",
            "address": "0x0000000000000000000000000000000000000000",
            "config": ""
        },
        "seaport_sell_orders": null,
        "creator": {
            "user": {
                "username": null
            },
            "profile_img_url": "https://storage.googleapis.com/opensea-static/opensea-profile/12.png",
            "address": "0x347c00c950eac5380361cc9ccc529e5ffef291df",
            "config": ""
        },
        "traits": [],
        "last_sale": null,
        "top_bid": null,
        "listing_date": null,
        "is_presale": true,
        "transfer_fee_payment_token": null,
        "transfer_fee": null,
        "token_id": "23739362589833214218042992734890100206674559438404508682768786642835142082561"
    }
]

- ํ•˜๋‚˜์˜ NFT ์ •๋ณด ์กฐํšŒ

Request

GET /opensea

Parameter

Parameter Type Description Necessary
contractaddress ๋ฌธ์ž์—ด ํ•ด๋‹น NFT์˜ ์ปจํŠธ๋ž™ํŠธ ์ฃผ์†Œ ํ•„์ˆ˜
tokenId ๋ฌธ์ž์—ด ํ•ด๋‹น NFT์˜ tokenId ํ•„์ˆ˜

ex)/opensea?contractaddress=0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb&tokenId=1

Response

์‘๋‹ต์€ ๋‹ค์Œ๊ณผ ๊ฐ™์€ JSON ํ˜•์‹์ž…๋‹ˆ๋‹ค.

{
    "id": 158831,
    "num_sales": 3,
    "background_color": null,
    "image_url": "https://lh3.googleusercontent.com/7bRocEaoBrWYBX3vThkHj4kAV3b3mKG-Kem85xeT-D8oHpvQ19kcoiBd9mIFeNU0GrwZGvj6Oc5NAEGBSsGlrww",
    "image_preview_url": "https://lh3.googleusercontent.com/7bRocEaoBrWYBX3vThkHj4kAV3b3mKG-Kem85xeT-D8oHpvQ19kcoiBd9mIFeNU0GrwZGvj6Oc5NAEGBSsGlrww=s250",
    "image_thumbnail_url": "https://lh3.googleusercontent.com/7bRocEaoBrWYBX3vThkHj4kAV3b3mKG-Kem85xeT-D8oHpvQ19kcoiBd9mIFeNU0GrwZGvj6Oc5NAEGBSsGlrww=s128",
    "image_original_url": "https://www.larvalabs.com/cryptopunks/cryptopunk1.png",
    "animation_url": null,
    "animation_original_url": null,
    "name": "CryptoPunk #1",
    "description": null,
    "external_link": "https://www.larvalabs.com/cryptopunks/details/1",
    "asset_contract": {
        "address": "0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb",
        "asset_contract_type": "non-fungible",
        "created_date": "2018-01-23T04:51:38.832339",
        "name": "CryptoPunks",
        "nft_version": "unsupported",
        "opensea_version": null,
        "owner": null,
        "schema_name": "CRYPTOPUNKS",
        "symbol": "PUNK",
        "total_supply": null,
        "description": "CryptoPunks launched as a fixed set of 10,000 items in mid-2017 and became one of the inspirations for the ERC-721 standard. They have been featured in places like The New York Times, Christieโ€™s of London, Art|Basel Miami, and The PBS NewsHour.",
        "external_link": "https://www.larvalabs.com/cryptopunks",
        "image_url": "https://lh3.googleusercontent.com/BdxvLseXcfl57BiuQcQYdJ64v-aI8din7WPk0Pgo3qQFhAUH-B6i-dCqqc_mCkRIzULmwzwecnohLhrcH8A9mpWIZqA7ygc52Sr81hE=s120",
        "default_to_fiat": false,
        "dev_buyer_fee_basis_points": 0,
        "dev_seller_fee_basis_points": 0,
        "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": 250,
        "payout_address": null
    },
    "permalink": "https://opensea.io/assets/ethereum/0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb/1",
    "collection": {
        "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": 1905.51
            },
            {
                "id": 12182941,
                "symbol": "DAI",
                "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
                "image_url": "https://openseauserdata.com/files/dai-ethereum.svg",
                "name": "Dai Stablecoin",
                "decimals": 18,
                "eth_price": 0.00052485,
                "usd_price": 0.999542
            },
            {
                "id": 4645681,
                "symbol": "WETH",
                "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                "image_url": "https://openseauserdata.com/files/accae6b6fb3888cbff27a013729c22dc.svg",
                "name": "Wrapped Ether",
                "decimals": 18,
                "eth_price": 1,
                "usd_price": 1905.51
            },
            {
                "id": 4403908,
                "symbol": "USDC",
                "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
                "image_url": "https://openseauserdata.com/files/749015f009a66abcb3bbb3502ae2f1ce.svg",
                "name": "USD Coin",
                "decimals": 6,
                "eth_price": 0.00052475,
                "usd_price": 0.999466
            }
        ],
        "primary_asset_contracts": [
            {
                "address": "0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb",
                "asset_contract_type": "non-fungible",
                "created_date": "2018-01-23T04:51:38.832339",
                "name": "CryptoPunks",
                "nft_version": "unsupported",
                "opensea_version": null,
                "owner": null,
                "schema_name": "CRYPTOPUNKS",
                "symbol": "PUNK",
                "total_supply": null,
                "description": "CryptoPunks launched as a fixed set of 10,000 items in mid-2017 and became one of the inspirations for the ERC-721 standard. They have been featured in places like The New York Times, Christieโ€™s of London, Art|Basel Miami, and The PBS NewsHour.",
                "external_link": "https://www.larvalabs.com/cryptopunks",
                "image_url": "https://lh3.googleusercontent.com/BdxvLseXcfl57BiuQcQYdJ64v-aI8din7WPk0Pgo3qQFhAUH-B6i-dCqqc_mCkRIzULmwzwecnohLhrcH8A9mpWIZqA7ygc52Sr81hE=s120",
                "default_to_fiat": false,
                "dev_buyer_fee_basis_points": 0,
                "dev_seller_fee_basis_points": 0,
                "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": 250,
                "payout_address": null
            }
        ],
        "traits": {},
        "stats": {
            "one_day_volume": 484.4,
            "one_day_change": -0.5888818162529176,
            "one_day_sales": 5,
            "one_day_average_price": 96.88,
            "seven_day_volume": 4480.029999999999,
            "seven_day_change": 0.430743534551586,
            "seven_day_sales": 60,
            "seven_day_average_price": 74.66716666666665,
            "thirty_day_volume": 28276.27370000003,
            "thirty_day_change": -0.3072489951946178,
            "thirty_day_sales": 337,
            "thirty_day_average_price": 83.90585667655796,
            "total_volume": 983484.2858932811,
            "total_sales": 21324,
            "total_supply": 9999,
            "count": 9999,
            "num_owners": 3566,
            "average_price": 46.12100384042774,
            "num_reports": 2,
            "market_cap": 746596.9994999998,
            "floor_price": 0
        },
        "banner_image_url": "https://lh3.googleusercontent.com/48oVuDyfe_xhs24BC2TTVcaYCX7rrU5mpuQLyTgRDbKHj2PtzKZsQ5qC3xTH4ar34wwAXxEKH8uUDPAGffbg7boeGYqX6op5vBDcbA=s2500",
        "chat_url": null,
        "created_date": "2019-04-26T22:13:09.691572",
        "default_to_fiat": false,
        "description": "CryptoPunks launched as a fixed set of 10,000 items in mid-2017 and became one of the inspirations for the ERC-721 standard. They have been featured in places like The New York Times, Christieโ€™s of London, Art|Basel Miami, and The PBS NewsHour.",
        "dev_buyer_fee_basis_points": "0",
        "dev_seller_fee_basis_points": "0",
        "discord_url": "https://discord.gg/tQp4pSE",
        "display_data": {
            "card_display_style": "cover"
        },
        "external_url": "https://www.larvalabs.com/cryptopunks",
        "featured": false,
        "featured_image_url": "https://openseauserdata.com/0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb-featured-1556589448.png",
        "hidden": false,
        "safelist_request_status": "verified",
        "image_url": "https://lh3.googleusercontent.com/BdxvLseXcfl57BiuQcQYdJ64v-aI8din7WPk0Pgo3qQFhAUH-B6i-dCqqc_mCkRIzULmwzwecnohLhrcH8A9mpWIZqA7ygc52Sr81hE=s120",
        "is_subject_to_whitelist": false,
        "large_image_url": "https://lh3.googleusercontent.com/QB2kKuQEw04X02V9EoC2BNYZV652LYuewUv9ZdR7KJfI9Jocwmd28jIfsGg0umSCr2bOMV8O9UpLAkoaqfYwvwmC",
        "medium_username": null,
        "name": "CryptoPunks",
        "only_proxied_transfers": false,
        "opensea_buyer_fee_basis_points": "0",
        "opensea_seller_fee_basis_points": "250",
        "payout_address": null,
        "require_email": false,
        "short_description": null,
        "slug": "cryptopunks",
        "telegram_url": null,
        "twitter_username": "larvalabs",
        "instagram_username": null,
        "wiki_url": null,
        "is_nsfw": false
    },
    "decimals": null,
    "token_metadata": null,
    "is_nsfw": false,
    "owner": {
        "user": null,
        "profile_img_url": "https://storage.googleapis.com/opensea-static/opensea-profile/32.png",
        "address": "0xb88f61e6fbda83fbfffabe364112137480398018",
        "config": ""
    },
    "seaport_sell_orders": null,
    "creator": {
        "user": null,
        "profile_img_url": "https://storage.googleapis.com/opensea-static/opensea-profile/22.png",
        "address": "0xc352b534e8b987e036a93539fd6897f53488e56a",
        "config": ""
    },
    "traits": [
        {
            "trait_type": "type",
            "value": "Male",
            "display_type": null,
            "max_value": null,
            "trait_count": 6039,
            "order": null
        },
        {
            "trait_type": "accessory",
            "value": "Mohawk",
            "display_type": null,
            "max_value": null,
            "trait_count": 441,
            "order": null
        },
        {
            "trait_type": "accessory",
            "value": "Smile",
            "display_type": null,
            "max_value": null,
            "trait_count": 238,
            "order": null
        },
        {
            "trait_type": "accessory",
            "value": "2 attributes",
            "display_type": null,
            "max_value": null,
            "trait_count": 3279,
            "order": null
        }
    ],
    "last_sale": {
        "asset": {
            "decimals": null,
            "token_id": "1"
        },
        "asset_bundle": null,
        "event_type": "successful",
        "event_timestamp": "2020-11-30T18:44:26",
        "auction_type": null,
        "total_price": "60000000000000000000",
        "payment_token": {
            "symbol": "ETH",
            "address": "0x0000000000000000000000000000000000000000",
            "image_url": "https://openseauserdata.com/files/6f8e2979d428180222796ff4a33ab929.svg",
            "name": "Ether",
            "decimals": 18,
            "eth_price": "1.000000000000000",
            "usd_price": "1406.910000000000082000"
        },
        "transaction": {
            "block_hash": "0xe3eacbc6f4d6bb43525b69baffe09477f452f0f5e1a5b1d5232dc23b6cb176cb",
            "block_number": "11361817",
            "from_account": {
                "user": {
                    "username": "GoWestBTC"
                },
                "profile_img_url": "https://storage.googleapis.com/opensea-static/opensea-profile/4.png",
                "address": "0xee3766e4f996dc0e0f8c929954eaafef3441de87",
                "config": ""
            },
            "id": 63641091,
            "timestamp": "2020-11-30T18:44:26",
            "to_account": {
                "user": null,
                "profile_img_url": "https://storage.googleapis.com/opensea-static/opensea-profile/23.png",
                "address": "0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb",
                "config": ""
            },
            "transaction_hash": "0xf4af5563f3c4c3b26dee3ab027902f113bee5985b28d9ede5b81ab42b46abb30",
            "transaction_index": "58"
        },
        "created_date": "2020-11-30T18:45:11.476313",
        "quantity": "1"
    },
    "top_bid": null,
    "listing_date": null,
    "is_presale": false,
    "transfer_fee_payment_token": null,
    "transfer_fee": null,
    "related_assets": [],
    "orders": null,
    "auctions": [],
    "supports_wyvern": false,
    "top_ownerships": [
        {
            "owner": {
                "user": null,
                "profile_img_url": "https://storage.googleapis.com/opensea-static/opensea-profile/32.png",
                "address": "0xb88f61e6fbda83fbfffabe364112137480398018",
                "config": ""
            },
            "quantity": "1",
            "created_date": "2019-08-17T03:07:10.527756+00:00"
        }
    ],
    "ownership": null,
    "highest_buyer_commitment": null,
    "token_id": "1"
}

- ์›ํ•˜๋Š” Collection์˜ NFT๋ฅผ ์›ํ•˜๋Š” ์ˆ˜ ๋งŒํผ ์กฐํšŒ

Request

GET /opensea/onlycollections

Parameter

Parameter Type Description Necessary
limit ์ˆซ์ž ์กฐํšŒํ•˜๊ณ  ์‹ถ์€ NFT์˜ ์ˆ˜ ํ•„์ˆ˜
collection_slug ๋ฌธ์ž์—ด collection slug ํ•„์ˆ˜

ex)/opensea/onlycollections?limit=10&collection_slug=clonex

Response

์‘๋‹ต์€ ๋‹ค์Œ๊ณผ ๊ฐ™์€ JSON ํ˜•์‹์ž…๋‹ˆ๋‹ค.

[
    {
        "id": 580249434,
        "num_sales": 0,
        "background_color": null,
        "image_url": "https://lh3.googleusercontent.com/XTyuxLaB1EC5jkzUBbFot5vH3R8tfTsk9wFAdqQqkhibBHdcelMUiIEjB2kvnfNF487meoNL9YygnR5elJDJhQyvPqVa4A9U9hRv",
        "image_preview_url": "https://lh3.googleusercontent.com/XTyuxLaB1EC5jkzUBbFot5vH3R8tfTsk9wFAdqQqkhibBHdcelMUiIEjB2kvnfNF487meoNL9YygnR5elJDJhQyvPqVa4A9U9hRv=s250",
        "image_thumbnail_url": "https://lh3.googleusercontent.com/XTyuxLaB1EC5jkzUBbFot5vH3R8tfTsk9wFAdqQqkhibBHdcelMUiIEjB2kvnfNF487meoNL9YygnR5elJDJhQyvPqVa4A9U9hRv=s128",
        "image_original_url": "https://clonex-assets.rtfkt.com/images/19357.png",
        "animation_url": null,
        "animation_original_url": null,
        "name": "CloneX #7889",
        "description": "๐Ÿงฌ CLONE X ๐Ÿงฌ\n\n20,000 next-gen Avatars, by RTFKT and Takashi Murakami ๐ŸŒธ\n\nIf you own a clone without any Murakami trait please read the terms regarding RTFKT - Owned Content here: https://rtfkt.com/legal-2A\n\nYou are also entitled to a commercial license, please read the terms to that here: https://rtfkt.com/legal-2C",
        "external_link": null,
        "asset_contract": {
            "address": "0x49cf6f5d44e70224e2e23fdcdd2c053f30ada28b",
            "asset_contract_type": "non-fungible",
            "created_date": "2021-12-12T13:51:22.173653",
            "name": "CloneX",
            "nft_version": "3.0",
            "opensea_version": null,
            "owner": 141800495,
            "schema_name": "ERC721",
            "symbol": "CloneX",
            "total_supply": "0",
            "description": "๐Ÿงฌ CLONE X ๐Ÿงฌ\r\n\r\n20,000 next-gen Avatars, by RTFKT and Takashi Murakami ๐ŸŒธ",
            "external_link": "http://www.rtfkt.com",
            "image_url": "https://lh3.googleusercontent.com/XN0XuD8Uh3jyRWNtPTFeXJg_ht8m5ofDx6aHklOiy4amhFuWUa0JaR6It49AH8tlnYS386Q0TW_-Lmedn0UET_ko1a3CbJGeu5iHMg=s120",
            "default_to_fiat": false,
            "dev_buyer_fee_basis_points": 0,
            "dev_seller_fee_basis_points": 500,
            "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": 750,
            "payout_address": "0xe65b6865dbce299ae6a20efcc7543362540741d8"
        },
        "permalink": "https://opensea.io/assets/ethereum/0x49cf6f5d44e70224e2e23fdcdd2c053f30ada28b/19357",
        "collection": {
            "banner_image_url": "https://lh3.googleusercontent.com/4elUtz8UyFYDH34vDxd4hpQX8S-EdkFq8s9ombkuQTDBWLwHvsjRM_RXWT2zX8Vt2bAiO2BHslwN57FyTW1JIn_FyFI0BsZfmvmeJQ=s2500",
            "chat_url": null,
            "created_date": "2021-12-12T18:32:58.410707",
            "default_to_fiat": false,
            "description": "๐Ÿงฌ CLONE X ๐Ÿงฌ\r\n\r\n20,000 next-gen Avatars, by RTFKT and Takashi Murakami ๐ŸŒธ",
            "dev_buyer_fee_basis_points": "0",
            "dev_seller_fee_basis_points": "500",
            "discord_url": "https://discord.gg/RTFKT",
            "display_data": {
                "card_display_style": "contain"
            },
            "external_url": "http://www.rtfkt.com",
            "featured": false,
            "featured_image_url": "https://lh3.googleusercontent.com/IUO8EeKXUXiy0lAtp5qnNJa4KoUu-Nu_kYqcl5JUxw29YKPABYAuhQi-ihQR3j6IFrEJHAhKQ_e9s940frbA5jb1l0SHih3nP2UV5jw=s300",
            "hidden": false,
            "safelist_request_status": "verified",
            "image_url": "https://lh3.googleusercontent.com/XN0XuD8Uh3jyRWNtPTFeXJg_ht8m5ofDx6aHklOiy4amhFuWUa0JaR6It49AH8tlnYS386Q0TW_-Lmedn0UET_ko1a3CbJGeu5iHMg=s120",
            "is_subject_to_whitelist": false,
            "large_image_url": "https://lh3.googleusercontent.com/IUO8EeKXUXiy0lAtp5qnNJa4KoUu-Nu_kYqcl5JUxw29YKPABYAuhQi-ihQR3j6IFrEJHAhKQ_e9s940frbA5jb1l0SHih3nP2UV5jw=s300",
            "medium_username": null,
            "name": "CLONE X - X TAKASHI MURAKAMI",
            "only_proxied_transfers": false,
            "opensea_buyer_fee_basis_points": "0",
            "opensea_seller_fee_basis_points": "250",
            "payout_address": "0xe65b6865dbce299ae6a20efcc7543362540741d8",
            "require_email": false,
            "short_description": null,
            "slug": "clonex",
            "telegram_url": null,
            "twitter_username": "RTFKTstudios",
            "instagram_username": "RTFKTSTUDIOS",
            "wiki_url": null,
            "is_nsfw": false
        },
        "decimals": null,
        "token_metadata": "https://clonex-assets.rtfkt.com/19357",
        "is_nsfw": false,
        "owner": {
            "user": {
                "username": "II_Cr4zZy_zZ"
            },
            "profile_img_url": "https://storage.googleapis.com/opensea-static/opensea-profile/6.png",
            "address": "0xfa46ad58763732eec983a0e0e2cb11ec8267b486",
            "config": ""
        },
        "seaport_sell_orders": null,
        "creator": {
            "user": {
                "username": "RTFKTCLONEXTM"
            },
            "profile_img_url": "https://storage.googleapis.com/opensea-static/opensea-profile/18.png",
            "address": "0x12ea19217c65f36385bb030d00525c1034e2f0af",
            "config": "verified"
        },
        "traits": [
            {
                "trait_type": "Clothing",
                "value": "BLCK BNDN Shirt",
                "display_type": null,
                "max_value": null,
                "trait_count": 293,
                "order": null
            },
            {
                "trait_type": "DNA",
                "value": "Robot",
                "display_type": null,
                "max_value": null,
                "trait_count": 5795,
                "order": null
            },
            {
                "trait_type": "Hair",
                "value": "BRWN Ponytail",
                "display_type": null,
                "max_value": null,
                "trait_count": 114,
                "order": null
            },
            {
                "trait_type": "Type",
                "value": "MK-BLCK",
                "display_type": null,
                "max_value": null,
                "trait_count": 493,
                "order": null
            }
        ],
        "last_sale": null,
        "top_bid": null,
        "listing_date": null,
        "is_presale": false,
        "transfer_fee_payment_token": null,
        "transfer_fee": null,
        "token_id": "19357"
    }
]

- NFT Collections ์กฐํšŒ

Request

GET /opensea

Parameter

Parameter Type Description Necessary
collectionoffset ๋ฌธ์ž์—ด offset ์ˆซ์ž ํ•„์ˆ˜
collectionlimit ๋ฌธ์ž์—ด Maximum ์ˆซ์ž ํ•„์ˆ˜

ex)/opensea?collectionoffset=0&collectionlimit=10

Response

์‘๋‹ต์€ ๋‹ค์Œ๊ณผ ๊ฐ™์€ JSON ํ˜•์‹์ž…๋‹ˆ๋‹ค.

[
    {
        "primary_asset_contracts": [
            {
                "address": "0x237fec1d2cd0090da28865e6ed03b5a54ffcfd0c",
                "asset_contract_type": "non-fungible",
                "created_date": "2022-08-12T03:23:31.942694",
                "name": "hossol.lens-Follower",
                "nft_version": "3.0",
                "opensea_version": null,
                "owner": null,
                "schema_name": "ERC721",
                "symbol": "hoss-Fl",
                "total_supply": "1",
                "description": null,
                "external_link": null,
                "image_url": null,
                "default_to_fiat": false,
                "dev_buyer_fee_basis_points": 0,
                "dev_seller_fee_basis_points": 0,
                "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": 250,
                "payout_address": null
            }
        ],
        "traits": {},
        "stats": {
            "one_day_volume": 0,
            "one_day_change": 0,
            "one_day_sales": 0,
            "one_day_average_price": 0,
            "seven_day_volume": 0,
            "seven_day_change": 0,
            "seven_day_sales": 0,
            "seven_day_average_price": 0,
            "thirty_day_volume": 0,
            "thirty_day_change": 0,
            "thirty_day_sales": 0,
            "thirty_day_average_price": 0,
            "total_volume": 0,
            "total_sales": 0,
            "total_supply": 0,
            "count": 0,
            "num_owners": 0,
            "average_price": 0,
            "num_reports": 0,
            "market_cap": 0,
            "floor_price": 0
        },
        "banner_image_url": null,
        "chat_url": null,
        "created_date": "2022-08-12T03:23:32.029955",
        "default_to_fiat": false,
        "description": null,
        "dev_buyer_fee_basis_points": "0",
        "dev_seller_fee_basis_points": "0",
        "discord_url": null,
        "display_data": {
            "card_display_style": "contain",
            "images": []
        },
        "external_url": null,
        "featured": false,
        "featured_image_url": null,
        "hidden": false,
        "safelist_request_status": "not_requested",
        "image_url": null,
        "is_subject_to_whitelist": false,
        "large_image_url": null,
        "medium_username": null,
        "name": "hossol.lens-Follower",
        "only_proxied_transfers": false,
        "opensea_buyer_fee_basis_points": "0",
        "opensea_seller_fee_basis_points": "250",
        "payout_address": null,
        "require_email": false,
        "short_description": null,
        "slug": "hossol-lens-follower",
        "telegram_url": null,
        "twitter_username": null,
        "instagram_username": null,
        "wiki_url": null,
        "is_nsfw": false
    }
]

- ํ•˜๋‚˜์˜ NFT Collection ์กฐํšŒ

Request

GET /opensea

Parameter

Parameter Type Description Necessary
collecionslug ๋ฌธ์ž์—ด collection slug ํ•„์ˆ˜

ex)/opensea?collecionslug=abc

Response

์‘๋‹ต์€ ๋‹ค์Œ๊ณผ ๊ฐ™์€ JSON ํ˜•์‹์ž…๋‹ˆ๋‹ค.

{
    "editors": [
        "0x4dd3eb966dee807893d9e4ff8ac99752eb8a6ab0",
        "0x47e33894ed60a691a5c795325dae461363863c8c",
        "0xeaf54391793cc80de696d72713d7518c6190bfe0",
        "0x816a138bec6f829127458b7c2f79b72f516d9efc",
        "0x222d9881e2f7e8f8f54ae76594f79e73e9779c41",
        "0x2b80b9a83d3df5fd457e458822d69aecb084b45c",
        "0x75b63aae4d84c7cad8b3a302d4a4149e9403f040",
        "0x4ff00e6cf23158ccc9e7a6b9a504cd37e5bc0a93",
        "0x8eaf5461e19fced3c47e024cbff5b3bb55adbb0e",
        "0x10e328cf4245501cde8b3825d34b605c5f6a436b",
        "0xd2dfa218b2b30f8b7ce5ccb3142b8429c9d33e7d",
        "0x8dbbf70afb0681eafde71be77781b207539746b9",
        "0x8d1a65837225b7a3b4bdc685f2941b482c5620a7",
        "0x10ee35231ff8f7ab5489cfb29648387b5e64a87b",
        "0xd7383c3c94a1e2f1224ec54b06db9fae5352d375"
    ],
    "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": 1905.51
        },
        {
            "id": 4645681,
            "symbol": "WETH",
            "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "image_url": "https://openseauserdata.com/files/accae6b6fb3888cbff27a013729c22dc.svg",
            "name": "Wrapped Ether",
            "decimals": 18,
            "eth_price": 1,
            "usd_price": 1905.51
        }
    ],
    "primary_asset_contracts": [],
    "traits": {},
    "stats": {
        "one_day_volume": 0,
        "one_day_change": 0,
        "one_day_sales": 0,
        "one_day_average_price": 0,
        "seven_day_volume": 0,
        "seven_day_change": 0,
        "seven_day_sales": 0,
        "seven_day_average_price": 0,
        "thirty_day_volume": 0,
        "thirty_day_change": 0,
        "thirty_day_sales": 0,
        "thirty_day_average_price": 0,
        "total_volume": 0,
        "total_sales": 0,
        "total_supply": 0,
        "count": 0,
        "num_owners": 0,
        "average_price": 0,
        "num_reports": 0,
        "market_cap": 0,
        "floor_price": null
    },
    "banner_image_url": null,
    "chat_url": null,
    "created_date": "2020-12-18T15:23:47.344932",
    "default_to_fiat": false,
    "description": "",
    "dev_buyer_fee_basis_points": "0",
    "dev_seller_fee_basis_points": "0",
    "discord_url": null,
    "display_data": {
        "card_display_style": "contain",
        "images": []
    },
    "external_url": null,
    "featured": false,
    "featured_image_url": null,
    "hidden": false,
    "safelist_request_status": "not_requested",
    "image_url": "https://lh3.googleusercontent.com/fGdi2QVocyqmGudULcsQ04LTYNuXvfY6rGMrkhJE1DOU80gaq5DO5vRpdta9FVoQUavAfO5JdY3CQOstm7aPrtQhgB9eR8ESiGkUIG4=s120",
    "is_subject_to_whitelist": false,
    "large_image_url": null,
    "medium_username": null,
    "name": "abc",
    "only_proxied_transfers": false,
    "opensea_buyer_fee_basis_points": "0",
    "opensea_seller_fee_basis_points": "250",
    "payout_address": null,
    "require_email": false,
    "short_description": null,
    "slug": "abc",
    "telegram_url": null,
    "twitter_username": null,
    "instagram_username": null,
    "wiki_url": null,
    "is_nsfw": false
}

- NFT ๋ณด์œ  ๋ชฉ๋ก ์กฐํšŒ

Request

GET /explore

Parameter

Parameter Type Description Necessary
account ๋ฌธ์ž์—ด ํ•ด๋‹น ๊ณ„์ •์ด ์†Œ์œ ํ•˜๊ณ  ์žˆ๋Š” NFT ์กฐํšŒ ํ•„์ˆ˜ ์•„๋‹˜
name ๋ฌธ์ž์—ด ํ•ด๋‹น ์ด๋ฆ„์— ๋Œ€์‘ํ•˜๋Š” NFT ์กฐํšŒ ํ•„์ˆ˜ ์•„๋‹˜

ex) /explore?account=0x... /explore?name=...

parameter๊ฐ€ ์—†๋Š” GET ์š”์ฒญ์€ ์„œ๋ฒ„์— ๋“ฑ๋ก๋˜์–ด ์žˆ๋Š” ๋ชจ๋“  NFT๋ฅผ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค.

Response

์‘๋‹ต์€ ๋‹ค์Œ๊ณผ ๊ฐ™์€ JSON ํ˜•์‹์ž…๋‹ˆ๋‹ค.

[
    {
        "token_id": 1,
        "token_img": "์ด๋ฏธ์ง€ ์ฃผ์†Œ",
        "token_name": "ํ† ํฐ ์ด๋ฆ„",
        "token_owner": "owner ๊ณ„์ •",
        "token_description": "description",
        "token_price": 2.3
    }
]

๋ฉ”์„ธ์ง€์—์„œ ์‚ฌ์šฉํ•˜๋Š” ์†์„ฑ์€ ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

parameter Type Description
token_id ์ˆซ์ž ๋ฐœ๊ธ‰๋œ NFT์˜ ๊ณ ์œ ํ•œ tokenId
token_img ๋ฌธ์ž์—ด NFT์˜ ์ด๋ฏธ์ง€ ๋งํฌ
token_name ๋ฌธ์ž์—ด NFT์˜ ์ด๋ฆ„
token_owner ๋ฌธ์ž์—ด NFT๋ฅผ ์†Œ์œ ํ•˜๊ณ  ์žˆ๋Š” ์ฃผ์†Œ
token_description ๋ฌธ์ž์—ด NFT์— ๋Œ€ํ•œ ์„ค๋ช…
token_price ์ˆซ์ž NFT์˜ ๊ฐ€๊ฒฉ

- ์ง€๊ฐ‘ ์—ฐ๊ฒฐ ์‹œ ๊ณ„์ • ์ •๋ณด ์ €์žฅ

Request

POST /connect

์š”์ฒญ ํ˜•์‹ : JSON

Parameter

Parameter Type Description Necessary
user_account ๋ฌธ์ž์—ด ํ•ด๋‹น ์œ ์ €์˜ ๊ณ„์ • ํ•„์ˆ˜
user_balance ๋ฌธ์ž์—ด ํ•ด๋‹น ์œ ์ €์˜ ์ž”๊ณ  ํ•„์ˆ˜
chain ๋ฌธ์ž์—ด ํ•ด๋‹น ์œ ์ €์˜ ๋„คํŠธ์›Œํฌ ์ฒด์ธ ํ•„์ˆ˜
  1. ์ƒˆ๋กœ์šด ๊ณ„์ •์œผ๋กœ ์ง€๊ฐ‘ ์—ฐ๊ฒฐ ํ–ˆ์„ ๊ฒฝ์šฐ : ์—ฐ๊ฒฐํ•œ ์œ ์ €์˜ ๊ณ„์ •, ์ž”๊ณ , ๋„คํŠธ์›Œํฌ ์ฒด์ธ ์ •๋ณด๋ฅผ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.
  2. ๊ณ„์ •์„ ๋‹ค๋ฅธ ๋„คํŠธ์›Œํฌ ์ฒด์ธ์— ์—ฐ๊ฒฐํ•  ๊ฒฝ์šฐ : ์—ฐ๊ฒฐํ•œ ์œ ์ €์˜ ๊ณ„์ •, ์ž”๊ณ , ๋„คํŠธ์›Œํฌ ์ฒด์ธ ์ •๋ณด๋ฅผ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.
  3. ํ˜„์žฌ ๊ณ„์ •์˜ ์ž”๊ณ ๊ฐ€ ๋ณ€ํ•  ๊ฒฝ์šฐ : ๋ณ€๊ฒฝ๋œ ์ž”๊ณ  ์ •๋ณด๋ฅผ ๊ธฐ์กด ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์—…๋ฐ์ดํŠธ ํ•ฉ๋‹ˆ๋‹ค.