Ethos Developers - API Docs
  • API Documentation
    • Introduction
    • API v2
      • Activity
      • Categories
      • Chains
      • Contributions
      • Nfts
      • Projects
      • Project Votes
      • Score
      • System
      • Users
      • Xp
    • API v1 (deprecated)
      • Activities
      • Addresses
      • Attestations
      • Categories
      • Contracts
      • Contributions
      • Curated Lists
      • ENS
      • Events
      • Exchange Rates
      • Fees
      • Invitations
      • Markets
      • Notifications
      • Profiles
      • Replies
      • Reviews
      • Scores
      • Search
      • Signatures
      • Slashes
      • Twitter
      • Users
      • Vouches
      • XP
  • Whitepaper
    • Whitepaper
Powered by GitBook
On this page
  1. API Documentation
  2. API v2

Nfts

PreviousContributionsNextProjects

Check if a user owns a validator NFT

get
Path parameters
ethosUserKeystringRequired
Responses
200
Successful response
application/json
400
Invalid input data
application/json
404
Not found
application/json
500
Internal server error
application/json
get
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
400
Invalid input data
application/json
404
Not found
application/json
500
Internal server error
application/json
get
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
}
  • GETCheck if a user owns a validator NFT
  • GETGet NFTs owned by a user
  • POSTTrack a new NFT collection (Admin only)

Track a new NFT collection (Admin only)

post
Authorizations
Body
contractAddressstringRequired
Responses
200
Successful response
application/json
Responseany
400
Invalid input data
application/json
401
Authorization not provided
application/json
403
Insufficient access
application/json
500
Internal server error
application/json
post
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