⚙️
API Docs
  • ⚙️WalletChat API Reference
  • Reference
    • API Reference
      • Authentication
      • Direct Messages (DMs)
      • NFT Chats
      • Group Chats (Non-NFT Related)
      • Common API Endpoints
      • Inbox
      • Unused / Legacy
Powered by GitBook
On this page
  1. Reference
  2. API Reference

NFT Chats

NFT related API endpoints:

PreviousDirect Messages (DMs)NextGroup Chats (Non-NFT Related)

Last updated 2 years ago

Get Public Comments for given NFT Contract and ID

get

NFTs have a public comment section

Authorizations
Path parameters
addressstringRequired

Wallet Address

Responses
200
OK
application/json
get
GET /v1/get_comments/{nftaddr}/{nftid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
200

OK

[
  {
    "fromaddr": "text",
    "id": 1,
    "message": "text",
    "name": "text",
    "nftaddr": "text",
    "nftid": 1,
    "timestamp": "text"
  }
]

Get Public Comments Count for given NFT Contract and ID

get

NFTs have a public comment section

Authorizations
Path parameters
nftaddrstringRequired

NFT Contract Address

nftidstringRequired

NFT ID

Responses
200
OK
application/json
Responseinteger
get
GET /v1/get_comments_cnt/{nftaddr}/{nftid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
200

OK

1

Get all unread messages for a specific NFT context

get

Get Unread count for specifc NFT context given a wallet address and specific NFT

Authorizations
Path parameters
addressstringRequired

Wallet Address

nftaddrstringRequired

NFT Contract Address

nftidstringRequired

NFT ID

Responses
200
OK
application/json
Responseinteger
get
GET /v1/get_unread_cnt/{address}/{nftaddr}/{nftid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
200

OK

1

Get NFT Related Chat Items For Given Wallet Address

get

Get ALL NFT context items for a given wallet address

Authorizations
Path parameters
toaddrstringRequired

Wallet Address

Responses
200
OK
application/json
get
GET /v1/getnft_chatitems/{address} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
200

OK

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

Get NFT Related Chat Items For Given NFT Contract and ID, relating to one wallet

get

Get all specified NFT contract and ID items for a given wallet address

Authorizations
Path parameters
addressstringRequired

Wallet Address

nftaddrstringRequired

NFT Contract Address

nftidstringRequired

NFT ID

Responses
200
OK
application/json
get
GET /v1/getnft_chatitems/{address}/{nftaddr}/{nftid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
200

OK

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

Get NFT Related Chat Items For Given NFT Contract and ID, between two wallet addresses (TO and FROM are interchangable)

get

Get ALL NFT context items for a specifc NFT context convo between two wallets

Authorizations
Path parameters
nftaddrstringRequired

NFT Contract Address

nftidstringRequired

NFT ID

toaddrstringRequired

TO: Wallet Address

fromstringRequired

FROM: Wallet Address

Responses
200
OK
application/json
get
GET /v1/getnft_chatitems/{fromaddr}/{toaddr}/{nftaddr}/{nftid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
200

OK

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

Get NFT Related Chat Items For Given NFT Contract and ID

get

Get ALL NFT context items for a given wallet address

Authorizations
Path parameters
nftaddrstringRequired

NFT Contract Address

nftidstringRequired

NFT ID

Responses
200
OK
application/json
get
GET /v1/getnft_chatitems/{nftaddr}/{nftid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
200

OK

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]
  • POSTCreateCommunityChatitem creates GroupChatitem just with community tag (likely could be consolidated)
  • GETGet Community Chat Landing Page Info
  • GETGet Public Comments for given NFT Contract and ID
  • GETGet Public Comments Count for given NFT Contract and ID
  • GETGet all unread messages for a specific NFT context
  • GETGet NFT Related Chat Items For Given Wallet Address
  • GETGet NFT Related Chat Items For Given NFT Contract and ID, relating to one wallet
  • GETGet NFT Related Chat Items For Given NFT Contract and ID, between two wallet addresses (TO and FROM are interchangable)
  • GETGet NFT Related Chat Items For Given NFT Contract and ID

Get Community Chat Landing Page Info

get

TODO: need a creation API for communities, which includes specificied welcome message text, Twitter handle, page title

Authorizations
Path parameters
addressstringRequired

Wallet Address

Responses
200
OK
application/json
get
GET /v1/community/{community}/{address} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
200

OK

[
  {
    "has_messaged": true,
    "is_verified": true,
    "joined": true,
    "logo": "text",
    "members": 1,
    "messages": [
      {
        "context_type": "text",
        "fromaddr": "text",
        "id": 1,
        "message": "text",
        "nftaddr": "text",
        "sender_name": "text",
        "timestamp": "text",
        "timestamp_dtm": "text",
        "type": "text"
      }
    ],
    "name": "text",
    "social": [
      {
        "type": "text",
        "username": "text"
      }
    ],
    "tweets": [
      {
        "attachments": {
          "media_keys": [
            "text"
          ]
        },
        "author_id": "text",
        "created_at": "text",
        "id": "text",
        "media": {
          "media_keys": [
            "text"
          ]
        },
        "text": "text",
        "user": {
          "id": "text",
          "name": "text",
          "profile_image_url": "text",
          "username": "text"
        }
      }
    ]
  }
]

CreateCommunityChatitem creates GroupChatitem just with community tag (likely could be consolidated)

post

Community Chat Data

Authorizations
Body
context_typestringOptional
fromaddrstringOptional
idintegerOptional
messagestringOptional
nftaddrstringOptional
sender_namestringOptional
timestampstringOptional
timestamp_dtmstringOptional
typestringOptional
Responses
200
OK
application/json
post
POST /v1/community HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 159

{
  "context_type": "text",
  "fromaddr": "text",
  "id": 1,
  "message": "text",
  "nftaddr": "text",
  "sender_name": "text",
  "timestamp": "text",
  "timestamp_dtm": "text",
  "type": "text"
}
200

OK

[
  {
    "context_type": "text",
    "fromaddr": "text",
    "id": 1,
    "message": "text",
    "nftaddr": "text",
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "type": "text"
  }
]