NFT Wallets
Create NFT Wallet
POST
https://api.nfty.dev/v1/accounts
This endpoint creates a new NFT Wallet and returns the address so you can associate it with a user in your app. You can optionally pass in a user_identifier (such as email or username) and we will keep track of the association as well.
Headers
Authorization
string
Your authentication token
Request Body
user_identifier
string
This is a unique user identifier, such as an email address, username, or user id that you want to associate with this wallet. Using an email address allows users to access this wallet via their email. It is also useful for querying the API based on your internal user id, etc.
Example Request:
Example Response:
Get NFT Wallet Address for User
GET
https://api.nfty.dev/v1/accounts/user/:user_identifier
This endpoint returns the NFT wallet address for a given user_identifier. This wallet address is needed for most other API calls that interact with the wallet. The user_identifer must have been associated with a wallet owned by your app during creation. If you did not associate a user_identifier, then you will not need to use this API.
Path Parameters
user_identifier
string
The user_identifier that you passed in during wallet creation. Remember to URI escape special characters.
Headers
Authorization
string
Your authentication token
Example Request:
Example Response:
List NFT Wallet Contents
GET
https://api.nfty.dev/v1/accounts/:address/(:contract_address)/(:token_id)
This endpoint returns the NFT items currently in the NFT Wallet. You can optionally filter by the contract_address and token_id as well. The address must be associated with a wallet owned by your app.
Path Parameters
address*
string
Address of this wallet
contract_address
string
Optional: Contract address for the NFTs you want to show
token_id
integer
Optional: ID of the token you want to filter by
Query Parameters
limit
integer
How many results to return. The maximum is 30.
offset
integer
The offset of the returned results. So you can paginate.
Headers
Authorization*
string
Your authentication token
Example Request:
Example Response:
List NFT Asset History
GET
https://api.nfty.dev/v1/accounts/:address/asset_history/:contract/(:token_id)
This endpoint returns the deposit and withdrawal history within this NFT Wallet for items from the given contract and optional token id and type. The address must be associated with a wallet owned by your app.
Path Parameters
token_id
integer
Optional: ID of the token you want to filter by
address*
string
Address of this wallet
contract*
string
Contract address for the NFTs you want to show
Query Parameters
type
string
Filter by deposit
or withdrawal
limit
integer
How many results to return. The maximum is 30.
offset
integer
The offset of the returned results. So you can paginate.
Headers
Authorization*
string
Your authentication token
Example Request:
Example Response:
Last updated
Was this helpful?