NFT API endpoints

The latest documentation for endpoints is always on the DevPortal: https://partner.socios.com/devportal/apis/f59193f0-b4ea-4eb7-83f8-8b1f2858f181/test

Endpoint to get nft data for currently logged-in user

GEThttps://api-public.socios.com/nft/1.0.0/user/nfts

Authorization

default

Query parameters

Response

200

Successfully retrieved list of User's nft's (simple paginationMode enabled)

Body

application/json

dataarray of UserNftDTO (object)

metadataone of

PaginationWithDetailedPaginationMode (object)PaginationWithSimplePaginationMode (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api-public.socios.com/nft/1.0.0/user/nfts', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "summary": {
        "collectibleId": "d6f09e6f-bea5-4db2-9e27-87c42ec08e00",
        "name": "My NFT",
        "description": "My NFT description",
        "imageUrl": "https://foo.bar/baz.png",
        "animationUrl": "https://foo.bar/baz.gif",
        "externalUrl": "https://foo.bar/my-nft",
        "backgroundColor": "51FF00",
        "metadataUrl": "https://foo.bar/my-nft/metadata.json",
        "supplyPosition": 1,
        "totalSupply": 10
      },
      "blockchain": {
        "tokenId": "10003555322666223325234212",
        "blockchainType": "DEPRECATED - ethereum_mainnet",
        "networkType": "polygon",
        "collectionId": "bd1b361a-80ab-465a-bb31-c02b330608f1",
        "smartContractAddress": "text",
        "isVerifiedSmartContract": false
      }
    }
  ],
  "metadata": {
    "total_items": 588,
    "current_page": 2,
    "last_page": 4,
    "cursor": "text"
  }
}

Endpoint to get single nft data

GEThttps://api-public.socios.com/nft/1.0.0/nft/{id}

Authorization

default

Path parameters

id*string (uuid)

The id of nft to be retrieved

Query parameters

Response

200

Successfully retrieved one nft data

Body

application/json

dataNftDTO (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api-public.socios.com/nft/1.0.0/nft/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": {
    "id": "d6f09e6f-bea5-4db2-9e27-87c42ec08e00",
    "summary": {
      "name": "text",
      "description": "text",
      "imageUrl": "text",
      "blockchainTokenId": "text"
    },
    "smartContract": {
      "name": "External SmartContract",
      "blockchainType": "DEPRECATED - ethereum_mainnet",
      "networkType": "polygon"
    },
    "currentOwner": {
      "blockchainType": "DEPRECATED - ethereum_mainnet",
      "blockchainAddress": "1.0765045074494785E+48",
      "networkType": "polygon"
    },
    "attributeValues": {
      "id": "text",
      "value": "text",
      "maxValue": 0,
      "traitType": "text",
      "displayType": "text",
      "applyTo": "text",
      "attribute": []
    }
  }
}