🔗NFT & Marketplace API
This API allows you to fetch information such as; NFT account information (OS bios, etc), as well as sales/listing data & faucets for multiple marketplaces and aggregators.
The free API key's have a rate limit of 3 requests a second. If you're looking to upgrade plans, either join our discord or visit our store: https://buy.felonsecurity.net
Obtaining An API Key
Visit the link, HERE. (api.felonsecurity.net/login).
This will ask you to login with discord, you can check exactly what you're giving us access to which is your username. We cannot do anything malicious with this, we only record: your username and discord ID.
After you login, you're good to use the following endpoint(s). Just include the header: "token" to authenticate your requests.
NFT Account Endpoints
Fetch Account Info
GET
https://api.felonsecurity.net/v1/nft/account/opensea/address=
Fetch an accounts information, includes opensea bio.
Path Parameters
address*
Ethereum address
{
// Response
}
Account Trading History
GET
https://api.felonsecurity.net/v1/nft/account/trading/info/address=
Fetches an address' NFT trading history.
Path Parameters
address*
String
Ethereum address
{
// Response
}
Tokens Owned
GET
https://api.felonsecurity.net/v1/nft/account/token/owns/address=&contractAddress=&count=&offset=&withMetadata=
Fetches an address' owned tokens in a specific collection.
Path Parameters
address*
String
Ethereum address
contractAddress
String
Specific contract to check
count*
Integer
Amount to fetch (between 1 and 100)
offset*
Integer
Offset to use (must be greater than 0)
withMetadata*
Boolean
Option to return token metadata
{
// Response
}
NFT Collection Endpoints
Collection Info
GET
https://api.felonsecurity.net/v1/nft/collections/info/contractAddress=
Fetches collection info, retrieves info from Opensea.
Path Parameters
contractAddress*
String
Contract address
{
// Response
}
Collection Stats
GET
https://api.felonsecurity.net/v1/nft/collections/stats/contractAddress=
Fetches collection statistics, retrieves info from Opensea.
Path Parameters
contractAddress*
String
Contract address
{
// Response
}
Collection Floor
GET
https://api.felonsecurity.net/v1/nft/collections/floor/contractAddress=
Fetches a collections floor, retrieves info from multiple marketplaces.
Path Parameters
contractAddress*
String
Contract address
{
// Response
}
Collection Rankings
GET
https://api.felonsecurity.net/v1/nft/collections/rankings/orderBy=&timeframe=&count=&offset=&marketplace=
Fetch top collections by multiple statistics, on multiple different marketplaces.
Path Parameters
orderBy*
String
Which statistic to order the rankings by.
timeframe*
String
Timeframe for rankings.
count*
Integer
How many to display.
offset*
Integer
Offset to use.
marketplace*
String
Marketplace to fetch rankings from.
{
// Response
}
Owner Spread
GET
https://api.felonsecurity.net/v1/nft/collections/ownerspread/contractAddress=
Fetch the address list of all owners from a collection.
Path Parameters
contractAddress*
String
Contract address
{
// Response
}
Mint Volume
GET
https://api.felonsecurity.net/v1/nft/collections/mintvolume/contractAddress=
Fetches a collections minting volume.
Path Parameters
contractAddress*
String
Contract address
{
// Response
}
Compare Owners
GET
https://api.felonsecurity.net/v1/nft/collections/compareowners/contractAddressOne=&contractAddressTwo=
Compare owners from two different collections.
Path Parameters
contractAddressOne*
String
First contract address
contractAddressTwo*
String
Second contract address
{
// Response
}
Token Endpoints
Token Owner
GET
https://api.felonsecurity.net/v1/nft/token/owner/contractAddress=&tokenId=
Fetches the owner of a specific token.
Path Parameters
contractAddress*
String
Contract address
tokenId*
String
Token ID
{
// Response
}
Token Info
GET
https://api.felonsecurity.net/v1/nft/token/info/contractAddress=&tokenId=
Retrieves a token's owner.
Path Parameters
contractAddress*
String
Contract address
tokenId*
String
Token ID
{
// Response
}
Metadata Endpoints
Token Metadata
GET
https://api.felonsecurity.net/v1/nft/metadata/contractAddress=&tokenId=
Fetch a tokens metadata.
Path Parameters
contractAddress*
String
Contract address
tokenId*
String
Token ID
{
// Response
}
Collection Metadata Spread
GET
https://api.felonsecurity.net/v1/nft/metadata/spread/contractAddress=
Fetch a collections metadata spread.
Path Parameters
contractAddress*
String
Contract address
{
// Response
}
Collection's Contract ABI (BETA)
GET
https://api.felonsecurity.net/v1/nft/metadata/abi/contractAddress=
Retrieves the ABI from a contract.
Path Parameters
contractAddress*
String
Contract address
{
// Response
}
Last updated