moralis_solana_nft_api_json.json•17.1 kB
{
"moralis_solana_nft_api": {
"base_url": "https://solana-gateway.moralis.io/api",
"description": "Moralis Solana NFT API for comprehensive NFT data access including metadata, collections, transfers, and ownership",
"authentication": {
"method": "API_KEY",
"header": "X-API-Key",
"description": "API key required for all requests"
},
"endpoints": {
"get_nft_metadata": {
"method": "GET",
"path": "/nft/{network}/{address}/metadata",
"description": "Get NFT metadata for a specific token mint address",
"parameters": {
"network": {
"type": "string",
"description": "Network identifier (mainnet, devnet)",
"required": true,
"enum": ["mainnet", "devnet"]
},
"address": {
"type": "string",
"description": "NFT mint address",
"required": true
}
},
"response": {
"mint": "string",
"standard": "string",
"name": "string",
"symbol": "string",
"metaplex": {
"metadataUri": "string",
"updateAuthority": "string",
"sellerFeeBasisPoints": "number",
"primarySaleHappened": "boolean",
"isMutable": "boolean",
"masterEdition": "boolean",
"creators": [
{
"address": "string",
"verified": "boolean",
"share": "number"
}
]
},
"metadata": {
"name": "string",
"symbol": "string",
"description": "string",
"image": "string",
"externalUrl": "string",
"attributes": [
{
"trait_type": "string",
"value": "string"
}
],
"properties": {
"files": [
{
"uri": "string",
"type": "string"
}
],
"category": "string",
"creators": [
{
"address": "string",
"share": "number"
}
]
}
}
}
},
"get_wallet_nfts": {
"method": "GET",
"path": "/account/{network}/{address}/nft",
"description": "Get all NFTs owned by a wallet address",
"parameters": {
"network": {
"type": "string",
"description": "Network identifier",
"required": true,
"enum": ["mainnet", "devnet"]
},
"address": {
"type": "string",
"description": "Wallet address",
"required": true
},
"cursor": {
"type": "string",
"description": "Pagination cursor",
"required": false
},
"limit": {
"type": "number",
"description": "Results limit (max 100)",
"required": false,
"default": 100
}
},
"response": {
"nfts": [
{
"associatedTokenAddress": "string",
"mint": "string",
"name": "string",
"symbol": "string",
"uri": "string",
"amount": "string",
"amountRaw": "string",
"decimals": "number",
"collectionAddress": "string",
"collectionName": "string",
"verified": "boolean",
"possible_spam": "boolean",
"metaplex": {
"metadataUri": "string",
"updateAuthority": "string",
"sellerFeeBasisPoints": "number",
"primarySaleHappened": "boolean",
"isMutable": "boolean",
"masterEdition": "boolean",
"creators": [
{
"address": "string",
"verified": "boolean",
"share": "number"
}
]
},
"metadata": {
"name": "string",
"symbol": "string",
"description": "string",
"image": "string",
"externalUrl": "string",
"attributes": [
{
"trait_type": "string",
"value": "string"
}
],
"properties": {
"files": [
{
"uri": "string",
"type": "string"
}
],
"category": "string"
}
}
}
],
"cursor": "string",
"hasNextPage": "boolean"
}
},
"get_nft_transfers": {
"method": "GET",
"path": "/nft/{network}/{address}/transfers",
"description": "Get transfer history for a specific NFT",
"parameters": {
"network": {
"type": "string",
"description": "Network identifier",
"required": true,
"enum": ["mainnet", "devnet"]
},
"address": {
"type": "string",
"description": "NFT mint address",
"required": true
},
"cursor": {
"type": "string",
"description": "Pagination cursor",
"required": false
},
"limit": {
"type": "number",
"description": "Results limit (max 100)",
"required": false,
"default": 100
},
"from_date": {
"type": "string",
"description": "Start date (ISO 8601)",
"required": false
},
"to_date": {
"type": "string",
"description": "End date (ISO 8601)",
"required": false
}
},
"response": {
"transfers": [
{
"signature": "string",
"slot": "number",
"blockTime": "string",
"fromAddress": "string",
"toAddress": "string",
"mint": "string",
"amount": "string",
"name": "string",
"symbol": "string",
"transferType": "string"
}
],
"cursor": "string",
"hasNextPage": "boolean"
}
},
"get_wallet_nft_transfers": {
"method": "GET",
"path": "/account/{network}/{address}/nft/transfers",
"description": "Get NFT transfer history for a wallet address",
"parameters": {
"network": {
"type": "string",
"description": "Network identifier",
"required": true,
"enum": ["mainnet", "devnet"]
},
"address": {
"type": "string",
"description": "Wallet address",
"required": true
},
"cursor": {
"type": "string",
"description": "Pagination cursor",
"required": false
},
"limit": {
"type": "number",
"description": "Results limit (max 100)",
"required": false,
"default": 100
},
"from_date": {
"type": "string",
"description": "Start date (ISO 8601)",
"required": false
},
"to_date": {
"type": "string",
"description": "End date (ISO 8601)",
"required": false
}
},
"response": {
"transfers": [
{
"signature": "string",
"slot": "number",
"blockTime": "string",
"fromAddress": "string",
"toAddress": "string",
"mint": "string",
"amount": "string",
"name": "string",
"symbol": "string",
"transferType": "string"
}
],
"cursor": "string",
"hasNextPage": "boolean"
}
},
"get_nft_collection_metadata": {
"method": "GET",
"path": "/nft/collection/{network}/{address}",
"description": "Get collection metadata for NFT collections",
"parameters": {
"network": {
"type": "string",
"description": "Network identifier",
"required": true,
"enum": ["mainnet", "devnet"]
},
"address": {
"type": "string",
"description": "Collection address",
"required": true
}
},
"response": {
"address": "string",
"name": "string",
"symbol": "string",
"description": "string",
"image": "string",
"externalUrl": "string",
"totalSupply": "number",
"verified": "boolean",
"floorPrice": "number",
"volume24h": "number",
"creators": [
{
"address": "string",
"verified": "boolean",
"share": "number"
}
],
"royalties": {
"sellerFeeBasisPoints": "number",
"recipients": [
{
"address": "string",
"share": "number"
}
]
}
}
},
"search_nfts": {
"method": "GET",
"path": "/nft/search",
"description": "Search NFTs by metadata criteria",
"parameters": {
"network": {
"type": "string",
"description": "Network identifier",
"required": true,
"enum": ["mainnet", "devnet"]
},
"query": {
"type": "string",
"description": "Search query (name, description, attributes)",
"required": false
},
"collection": {
"type": "string",
"description": "Collection address filter",
"required": false
},
"attributes": {
"type": "object",
"description": "Attribute filters",
"required": false
},
"limit": {
"type": "number",
"description": "Results limit (max 100)",
"required": false,
"default": 100
},
"cursor": {
"type": "string",
"description": "Pagination cursor",
"required": false
}
},
"response": {
"nfts": [
{
"mint": "string",
"name": "string",
"symbol": "string",
"uri": "string",
"collectionAddress": "string",
"collectionName": "string",
"verified": "boolean",
"possible_spam": "boolean",
"metadata": {
"name": "string",
"description": "string",
"image": "string",
"attributes": [
{
"trait_type": "string",
"value": "string"
}
]
}
}
],
"cursor": "string",
"hasNextPage": "boolean"
}
},
"get_nft_owners": {
"method": "GET",
"path": "/nft/{network}/{address}/owners",
"description": "Get current and historical owners of an NFT",
"parameters": {
"network": {
"type": "string",
"description": "Network identifier",
"required": true,
"enum": ["mainnet", "devnet"]
},
"address": {
"type": "string",
"description": "NFT mint address",
"required": true
}
},
"response": {
"mint": "string",
"currentOwner": "string",
"ownershipHistory": [
{
"owner": "string",
"fromDate": "string",
"toDate": "string",
"transferSignature": "string"
}
]
}
},
"get_collection_nfts": {
"method": "GET",
"path": "/nft/collection/{network}/{address}/nfts",
"description": "Get all NFTs in a specific collection",
"parameters": {
"network": {
"type": "string",
"description": "Network identifier",
"required": true,
"enum": ["mainnet", "devnet"]
},
"address": {
"type": "string",
"description": "Collection address",
"required": true
},
"cursor": {
"type": "string",
"description": "Pagination cursor",
"required": false
},
"limit": {
"type": "number",
"description": "Results limit (max 100)",
"required": false,
"default": 100
}
},
"response": {
"collection": {
"address": "string",
"name": "string",
"symbol": "string",
"totalSupply": "number"
},
"nfts": [
{
"mint": "string",
"name": "string",
"symbol": "string",
"uri": "string",
"owner": "string",
"verified": "boolean",
"metadata": {
"name": "string",
"description": "string",
"image": "string",
"attributes": [
{
"trait_type": "string",
"value": "string"
}
]
}
}
],
"cursor": "string",
"hasNextPage": "boolean"
}
}
},
"supported_networks": [
"mainnet",
"devnet"
],
"supported_nft_standards": [
"NFT (Non-Fungible Token)",
"cNFT (Compressed NFT)",
"SFT (Semi-Fungible Token)",
"Metaplex Standard"
],
"rate_limits": {
"free_tier": {
"requests_per_minute": 25,
"requests_per_day": 25000
},
"pro_tier": {
"requests_per_minute": 100,
"requests_per_day": 100000
},
"enterprise_tier": {
"requests_per_minute": "unlimited",
"requests_per_day": "unlimited"
}
},
"features": {
"comprehensive_metadata": true,
"spam_detection": true,
"collection_support": true,
"transfer_tracking": true,
"ownership_verification": true,
"search_functionality": true,
"media_urls": true,
"attribute_filtering": true,
"creator_information": true,
"royalty_data": true,
"compressed_nft_support": true,
"real_time_updates": true
},
"spam_detection": {
"description": "Advanced spam detection to filter out potential scam NFTs",
"indicators": [
"Compliance with standards",
"Honeypot activity detection",
"Copycat token identification",
"Suspicious minting patterns",
"Transfer behavior analysis"
],
"response_field": "possible_spam"
},
"example_requests": {
"get_nft_metadata": {
"url": "https://solana-gateway.moralis.io/api/nft/mainnet/4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R/metadata",
"method": "GET",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
},
"get_wallet_nfts": {
"url": "https://solana-gateway.moralis.io/api/account/mainnet/9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM/nft",
"method": "GET",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
},
"get_nft_transfers": {
"url": "https://solana-gateway.moralis.io/api/nft/mainnet/4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R/transfers",
"method": "GET",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
},
"search_nfts": {
"url": "https://solana-gateway.moralis.io/api/nft/search?network=mainnet&query=Degen&limit=10",
"method": "GET",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
},
"error_responses": {
"400": {
"description": "Bad Request - Invalid parameters or malformed request"
},
"401": {
"description": "Unauthorized - Invalid API key"
},
"404": {
"description": "Not Found - NFT or collection not found"
},
"429": {
"description": "Too Many Requests - Rate limit exceeded"
},
"500": {
"description": "Internal Server Error"
}
}
}
}