🔗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.

https://api.felonsecurity.net/loginapi.felonsecurity.net

If you need a refresher on your API key, just head to; https://api.felonsecurity.net/dashboard

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

Name	Type	Description
address*		Ethereum address

200: OK

{
    // Response
}

404: Not Found

401: Unauthorized

Account Trading History

GET https://api.felonsecurity.net/v1/nft/account/trading/info/address=

Fetches an address' NFT trading history.

Path Parameters

Name	Type	Description
address*	String	Ethereum address

200: OK

{
    // Response
}

401: Unauthorized

404: Not Found

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

Name	Type	Description
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

200: OK

{
    // Response
}

401: Unauthorized

404: Not Found

NFT Collection Endpoints

Collection Info

GET https://api.felonsecurity.net/v1/nft/collections/info/contractAddress=

Fetches collection info, retrieves info from Opensea.

Path Parameters

Name	Type	Description
contractAddress*	String	Contract address

200: OK

{
    // Response
}

401: Unauthorized

404: Not Found

Collection Stats

GET https://api.felonsecurity.net/v1/nft/collections/stats/contractAddress=

Fetches collection statistics, retrieves info from Opensea.

Path Parameters

Name	Type	Description
contractAddress*	String	Contract address

200: OK

{
    // Response
}

404: Not Found

401: Unauthorized

Collection Floor

GET https://api.felonsecurity.net/v1/nft/collections/floor/contractAddress=

Fetches a collections floor, retrieves info from multiple marketplaces.

Path Parameters

Name	Type	Description
contractAddress*	String	Contract address

200: OK

{
    // Response
}

401: Unauthorized

404: Not Found

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

Name	Type	Description
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.

200: OK

{
    // Response
}

401: Unauthorized

404: Not Found

Owner Spread

GET https://api.felonsecurity.net/v1/nft/collections/ownerspread/contractAddress=

Fetch the address list of all owners from a collection.

Path Parameters

Name	Type	Description
contractAddress*	String	Contract address

200: OK

{
    // Response
}

401: Unauthorized

404: Not Found

Mint Volume

GET https://api.felonsecurity.net/v1/nft/collections/mintvolume/contractAddress=

Fetches a collections minting volume.

Path Parameters

Name	Type	Description
contractAddress*	String	Contract address

200: OK

{
    // Response
}

404: Not Found

401: Unauthorized

Compare Owners

GET https://api.felonsecurity.net/v1/nft/collections/compareowners/contractAddressOne=&contractAddressTwo=

Compare owners from two different collections.

Path Parameters

Name	Type	Description
contractAddressOne*	String	First contract address
contractAddressTwo*	String	Second contract address

200: OK

{
    // Response
}

401: Unauthorized

404: Not Found

Token Endpoints

Token Owner

GET https://api.felonsecurity.net/v1/nft/token/owner/contractAddress=&tokenId=

Fetches the owner of a specific token.

Path Parameters

Name	Type	Description
contractAddress*	String	Contract address
tokenId*	String	Token ID

200: OK

{
    // Response
}

404: Not Found

401: Unauthorized

Token Info

GET https://api.felonsecurity.net/v1/nft/token/info/contractAddress=&tokenId=

Retrieves a token's owner.

Path Parameters

Name	Type	Description
contractAddress*	String	Contract address
tokenId*	String	Token ID

200: OK

{
    // Response
}

401: Unauthorized

404: Not Found

Metadata Endpoints

Token Metadata

GET https://api.felonsecurity.net/v1/nft/metadata/contractAddress=&tokenId=

Fetch a tokens metadata.

Path Parameters

Name	Type	Description
contractAddress*	String	Contract address
tokenId*	String	Token ID

200: OK

{
    // Response
}

401: Unauthorized

404: Not Found

Collection Metadata Spread

GET https://api.felonsecurity.net/v1/nft/metadata/spread/contractAddress=

Fetch a collections metadata spread.

Path Parameters

Name	Type	Description
contractAddress*	String	Contract address

200: OK

{
    // Response
}

401: Unauthorized

404: Not Found

Collection's Contract ABI (BETA)

GET https://api.felonsecurity.net/v1/nft/metadata/abi/contractAddress=

Retrieves the ABI from a contract.

Path Parameters

Name	Type	Description
contractAddress*	String	Contract address

200: OK

{
    // Response
}

401: Unauthorized

404: Not Found