🔗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.
We have made the OpenSea account information endpoint public. We understand that developers currently have an issue with fetching bio information for accounts, so we wanted to help out.
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.
If you feel uncomfortable signing into your discord account, feel free to join our discord and create a ticket. We can always manually give you an API key.
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
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
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
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
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
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
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.
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
Mint Volume
GET
https://api.felonsecurity.net/v1/nft/collections/mintvolume/contractAddress=
Fetches a collections minting volume.
Path Parameters
contractAddress*
String
Contract address
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
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
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
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
Collection Metadata Spread
GET
https://api.felonsecurity.net/v1/nft/metadata/spread/contractAddress=
Fetch a collections metadata spread.
Path Parameters
contractAddress*
String
Contract address
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
Last updated