Nfts

Check if a user owns a validator NFT

get

Path parameters

ethosUserKeystringRequired

Responses

200

Successful response

application/json

contractAddressstringRequired

tokenIdstringRequired

namestring · nullableRequired

descriptionstring · nullableRequired

imageUrlstring · nullableRequired

thumbnailUrlstring · nullableRequired

animationUrlstring · nullableRequired

animationMimestring · nullableRequired

tokenUristring · nullableRequired

attributesJsonany · nullableOptional

mintedAtstring · nullableRequired

acquiredAtstring · nullableRequired

lastActivityAtstring · nullableRequired

createdAtstringRequired

updatedAtstringRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/nfts/user/{ethosUserKey}/owns-validator

HTTPcURLJavaScriptPython

GET /api/v2/nfts/user/{ethosUserKey}/owns-validator HTTP/1.1
Host: api.ethos.network
Accept: */*

[
  {
    "contractAddress": "text",
    "tokenId": "text",
    "name": "text",
    "description": "text",
    "imageUrl": "text",
    "thumbnailUrl": "text",
    "animationUrl": "text",
    "animationMime": "text",
    "tokenUri": "text",
    "attributesJson": null,
    "mintedAt": "text",
    "acquiredAt": "text",
    "lastActivityAt": "text",
    "createdAt": "text",
    "updatedAt": "text",
    "NftOwners": [
      {
        "ownerAddress": "text"
      }
    ],
    "collection": {
      "slug": "text"
    }
  }
]

Get NFTs owned by a user

get

Path parameters

ethosUserKeystringRequired

Query parameters

limitinteger · max: 1000OptionalDefault: 50

offsetnumberOptionalDefault: 0

Responses

200

Successful response

application/json

totalnumberRequired

limitnumberRequired

offsetnumberRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/nfts/user/{ethosUserKey}

HTTPcURLJavaScriptPython

GET /api/v2/nfts/user/{ethosUserKey} HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "values": [
    {
      "contractAddress": "text",
      "tokenId": "text",
      "name": "text",
      "description": "text",
      "imageUrl": "text",
      "thumbnailUrl": "text",
      "animationUrl": "text",
      "animationMime": "text",
      "tokenUri": "text",
      "attributesJson": null,
      "mintedAt": "text",
      "acquiredAt": "text",
      "lastActivityAt": "text",
      "createdAt": "text",
      "updatedAt": "text",
      "NftOwners": [
        {
          "ownerAddress": "text"
        }
      ],
      "collection": {
        "slug": "text"
      }
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}

Track a new NFT collection (Admin only)

post

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

contractAddressstringRequired

Responses

200

Successful response

application/json

anyOptional

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/nfts/track

HTTPcURLJavaScriptPython

POST /api/v2/nfts/track HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "contractAddress": "text"
}

No content

Get validator NFTs listed for sale on OpenSea

get

Query parameters

limitinteger · max: 50OptionalDefault: 50

offsetnumberOptionalDefault: 0

Responses

200

Successful response

application/json

totalnumberRequired

limitnumberRequired

offsetnumberRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/nfts/validators/listings

HTTPcURLJavaScriptPython

GET /api/v2/nfts/validators/listings HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "values": [
    {
      "orderHash": "text",
      "tokenId": "text",
      "name": "text",
      "imageUrl": "text",
      "priceWei": "text",
      "priceEth": "text",
      "currency": "text",
      "seller": "text",
      "openseaUrl": "text"
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}