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

Discord - A New Way to Chat with Friends & CommunitiesDiscord

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

{"status":0,"message":"Endpoint not found. If you believe this is an error, contact me on twitter: @carvethedegen."}

401: Unauthorized

{
    // Response
}

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

{
    // Response
}

404: Not Found

{
    // 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

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

{
    // Response
}

404: Not Found

{
    // 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

Name	Type	Description
contractAddress*	String	Contract address

200: OK

{
    // Response
}

401: Unauthorized

{
    // Response
}

404: Not Found

{
    // Response
}

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

{
    // Response
}

401: Unauthorized

{
    // Response
}

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

{
    // Response
}

404: Not Found

{
    // 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

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

{
    // Response
}

404: Not Found

{
    // 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

Name	Type	Description
contractAddress*	String	Contract address

200: OK

{
    // Response
}

401: Unauthorized

{
    // Response
}

404: Not Found

{
    // Response
}

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

{
    // Response
}

401: Unauthorized

{
    // Response
}

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

{
    // Response
}

404: Not Found

{
    // 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

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

200: OK

{
    // Response
}

404: Not Found

{
    // Response
}

401: Unauthorized

{
    // Response
}

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

{
    // Response
}

404: Not Found

{
    // Response
}

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

{
    // Response
}

404: Not Found

{
    // Response
}

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

{
    // Response
}

404: Not Found

{
    // Response
}

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

{
    // Response
}

404: Not Found

{
    // Response
}