How to get the slug from contract address?

[rigwild]

Hi, I see that most of the API asks for the slug of a collection (e.g. Retrieve collection offers)

How to convert a contract address to its associated slug?

E.g. I want to convert 0xe2de2249cf1c9d76eaf24257b85bbe83bd218a0b to wonderlettersmysteriousclub

I tried to get it by calling the public GraphQL endpoint that is called when doing a search on the website, but this will probably cause some issues with CloudFlare / be unreliable.

I also see that the Get an NFT endpoint returns a detailed NFT object that includes the slug. But this API si not available in testnests endpoints?

Is there a clean way to get it?

Thanks!

[ryanio]

you can use getNFTsByCollection() and each item has the collection slug as the collection field. yes it is available in testnets.

[rigwild]

But this method take a slug as a parameter? I tried on mainnet with BAYC without success (it works when I pass boredapeyachtclub)

curl --request GET \
     --url https://api.opensea.io/v2/offers/collection/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d \
     --header 'X-API-KEY: xxxxx' \
     --header 'accept: application/json'

{"success":false}

Same on testnet

curl --request GET \
     --url https://testnets-api.opensea.io/v2/offers/collection/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d \
     --header 'accept: application/json'

{"success":false}

With slug

curl --request GET \
     --url https://testnets-api.opensea.io/v2/offers/collection/wonderlettersmysteriousclub \
     --header 'accept: application/json'

{
  "offers": [
    {
      "order_hash": "0xd367aaad496771ab5e0259ba2c6723ba9e9306b87b92f497147b3698874dc43f",
      "chain": "goerli",
      "criteria": {
        "collection": {
          "slug": "wonderlettersmysteriousclub"
        },
        "contract": {
          "address": "0xe2de2249cf1c9d76eaf24257b85bbe83bd218a0b"
        },
        "trait": null,
        "encoded_token_ids": "*"
      },
      "protocol_data": {
        "parameters": {
          "offerer": "0xd3d9f02807a8f1d6f43b4d6fcd77638b3380827a",
          "offer": [
            {
              "itemType": 1,
              "token": "0xB4FBF271143F4FBf7B91A5ded31805e42b2208d6",
              "identifierOrCriteria": "0",
              "startAmount": "100000000000000",
              "endAmount": "100000000000000"
            }
          ],
          "consideration": [
            {
              "itemType": 5,
              "token": "0xe2De2249Cf1C9d76EAF24257B85BBE83Bd218a0B",
              "identifierOrCriteria": "0",
              "startAmount": "1",
              "endAmount": "1",
              "recipient": "0xd3d9F02807A8F1D6f43B4d6fCd77638b3380827A"
            },
            {
              "itemType": 1,
              "token": "0xB4FBF271143F4FBf7B91A5ded31805e42b2208d6",
              "identifierOrCriteria": "0",
              "startAmount": "2500000000000",
              "endAmount": "2500000000000",
              "recipient": "0x0000a26b00c1F0DF003000390027140000fAa719"
            }
          ],
          "startTime": "1690229869",
          "endTime": "1690834666",
          "orderType": 2,
          "zone": "0x000000e7Ec00e7B300774b00001314B8610022b8",
          "zoneHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
          "salt": "0x360c6ebe000000000000000000000000000000000000000083f4c89657974434",
          "conduitKey": "0x0000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f0000",
          "totalOriginalConsiderationItems": 2,
          "counter": 0
        },
        "signature": null
      },
      "protocol_address": "0x00000000000000adc04c56bf30ac9d3c0aaf14dc"
    }
  ]
}

[ryanio]

ah sorry, i meant getNFTsByContract()

[thenerdassassin]

This one will also work: https://docs.opensea.io/reference/get-an-nft

[rigwild]

Not supported on testnet right?

curl --request GET \
     --url https://testnets-api.opensea.io/v2/chain/goerli/contract/0xe2de2249cf1c9d76eaf24257b85bbe83bd218a0b/nfts \
     --header 'accept: application/json'

curl --request GET \
     --url https://testnets-api.opensea.io/v2/chain/goerli/contract/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d/nfts/1 \
     --header 'accept: application/json'

both return HTTP 500

<!doctype html>
<html lang="en">
<head>
  <title>Server Error (500)</title>
</head>
<body>
  <h1>Server Error (500)</h1><p></p>
<script>(function(){var js = "window['__CF$cv$params']={r:'7ec82794484e0406'};_cpo=document.createElement('script');_cpo.nonce='',_cpo.src='/cdn-cgi/challenge-platform/scripts/invisible.js',document.getElementsByTagName('head')[0].appendChild(_cpo);";var _0xh = document.createElement('iframe');_0xh.height = 1;_0xh.width = 1;_0xh.style.position = 'absolute';_0xh.style.top = 0;_0xh.style.left = 0;_0xh.style.border = 'none';_0xh.style.visibility = 'hidden';document.body.appendChild(_0xh);function handler() {var _0xi = _0xh.contentDocument || _0xh.contentWindow.document;if (_0xi) {var _0xj = _0xi.createElement('script');_0xj.innerHTML = js;_0xi.getElementsByTagName('head')[0].appendChild(_0xj);}}if (document.readyState !== 'loading') {handler();} else if (window.addEventListener) {document.addEventListener('DOMContentLoaded', handler);} else {var prev = document.onreadystatechange || function () {};document.onreadystatechange = function (e) {prev(e);if (document.readyState !== 'loading') {document.onreadystatechange = prev;handler();}};}})();</script><script defer src="https://static.cloudflareinsights.com/beacon.min.js/v2cb3a2ab87c5498db5ce7e6608cf55231689030342039" integrity="sha512-DI3rPuZDcpH/mSGyN22erN5QFnhl760f50/te7FTIYxodEF8jJnSFnfnmG/c+osmIQemvUrnBtxnMpNdzvx1/g==" data-cf-beacon='{"rayId":"7ec82794484e0406","version":"2023.4.0","b":1,"token":"96047490de144c8b91be74ba7605ab69","si":100}' crossorigin="anonymous"></script>
</body>
</html>

[ryanio]

this is a separate issue we are investigating (#1102) thanks for sharing examples