Get started
The API provides programmatic access to read Wallet data and NFT assets for Solana, Ethereum and Polygon Blockchains.
You can retrieve all NFT's of a Solana, Ethereum and Polygon wallet, one single NFT mint details and metadata of a Solana,
Ethereum and Polygon asset or all available Solana Name Service Domains of a Solana Wallet.
To use this API, you need an API key. We are not providing API keys at the moment. Only /status endpoint is free to see.
Get service status
To get a service status update from the server, you need to make a GET call to the following url :
https://api.escu.xyz/status
solana - get all domains of a wallet
To get all Bonfida Domains associated to a Solana Wallet, you need to make a GET call to the following url :
https://api.escu.xyz/v2/sol/domains/get_all
MANDATORY HEADERS
| Field |
Type |
Description |
| x-api-key |
String |
Your API key. |
QUERY PARAMETERS
| Field |
Type |
Description |
| address |
String |
The Solana Wallet Public Key you wish to get Domains for. |
| refresh |
Boolean |
(Optional) If you want to force a refresh of cached data. |
solana - get all nft's of a wallet
To get all NFT's of a Solana Wallet, you need to make a GET call to the following url :
https://api.escu.xyz/v2/sol/nfts/get_all
MANDATORY HEADERS
| Field |
Type |
Description |
| x-api-key |
String |
Your API key. |
QUERY PARAMETERS
| Field |
Type |
Description |
| address |
String |
The Solana Wallet Public Key you wish to get NFT's for. |
| refresh |
Boolean |
(Optional) If you want to force a refresh of cached data. |
solana - get one nft mint details/metadata
To get one NFT mint details and metadata, you need to make a GET call to the following url :
https://api.escu.xyz/v2/sol/nfts/get_one
MANDATORY HEADERS
| Field |
Type |
Description |
| x-api-key |
String |
Your API key. |
QUERY PARAMETERS
| Field |
Type |
Description |
| address |
String |
The Mint Address or Asset Id for compressed NFT's of the NFT you wish to get the mint details/metadata for. |
| refresh |
Boolean |
(Optional) If you want to force a refresh of cached data. |
ethereum - get all nft's of a wallet
To get all NFT's of a Ethereum Wallet, you need to make a GET call to the following url :
https://api.escu.xyz/v2/eth/nfts/get_all
MANDATORY HEADERS
| Field |
Type |
Description |
| x-api-key |
String |
Your API key. |
QUERY PARAMETERS
| Field |
Type |
Description |
| address |
String |
The Ethereum Wallet Public Key you wish to get NFT's for. |
| refresh |
Boolean |
(Optional) If you want to force a refresh of cached data. |
ethereum - get one nft mint details/metadata
To get one NFT mint details and metadata, you need to make a GET call to the following url :
https://api.escu.xyz/v2/eth/nfts/get_one
MANDATORY HEADERS
| Field |
Type |
Description |
| x-api-key |
String |
Your API key. |
QUERY PARAMETERS
| Field |
Type |
Description |
| address |
String |
The Contract Address of the NFT you wish to get the mint details/metadata for. |
| id |
String |
The Asset Id of the NFT you wish to get the mint details/metadata for. |
| refresh |
Boolean |
(Optional) If you want to force a refresh of cached data. |
polygon - get all nft's of a wallet
To get all NFT's of a Ethereum Wallet, you need to make a GET call to the following url :
https://api.escu.xyz/v2/matic/nfts/get_all
MANDATORY HEADERS
| Field |
Type |
Description |
| x-api-key |
String |
Your API key. |
QUERY PARAMETERS
| Field |
Type |
Description |
| address |
String |
The Polygon Wallet Public Key you wish to get NFT's for. |
| refresh |
Boolean |
(Optional) If you want to force a refresh of cached data. |
polygon - get one nft mint details/metadata
To get one NFT mint details and metadata, you need to make a GET call to the following url :
https://api.escu.xyz/v2/eth/matic/get_one
MANDATORY HEADERS
| Field |
Type |
Description |
| x-api-key |
String |
Your API key. |
QUERY PARAMETERS
| Field |
Type |
Description |
| address |
String |
The Contract Address of the NFT you wish to get the mint details/metadata for. |
| id |
String |
The Asset Id of the NFT you wish to get the mint details/metadata for. |
| refresh |
Boolean |
(Optional) If you want to force a refresh of cached data. |
Errors
The API uses the following error messages:
| Error Message |
Meaning |
| "message": "Unauthorized" |
Unknown or unvalid x-api-key. This error appears if you use an unknown API key or if your API key expired.
|
| "message": "Missing Parameter" |
Some parameters are missing. This error appears when you don't pass every mandatory parameter.
|
| "message": "Invalid Wallet Address" |
The wallet "address" parameter is invalid. This error usually appears when you have a typo in the parameter.
|
| "message": "Invalid Contract Address" |
The contract "address" parameter is invalid. This error usually appears when you have a typo in the parameter.
|
| error: "Something went wrong..." |
Generic error of the endpoint worker. It can have many reasons behind it, best is to check the app logs.
|
