{ "openapi": "3.0.0", "info": { "title": "Token and NFT API v2 bundle API", "description": "Get information about NFTs and ERC-20 Tokens via simple RPC request.", "version": "1.0.0", "contact": { "email": "support@quiknode.io", "url": "https://support.quicknode.com/hc/en-us" } }, "servers": [ { "url": "https://{quicknode_endpoint}", "description": "Your Quicknode endpoint", "variables": { "quicknode_endpoint": { "default": "your-endpoint.quiknode.pro", "description": "Your Quicknode endpoint URL" } } } ], "tags": [ { "name": "JSON-RPC", "description": "See request body examples for the available methods you can call on this add-on" } ], "paths": { "/rpc": { "post": { "summary": "JSON-RPC methods for https://api.quicknode.com/rpc", "description": "Available methods:\n• qn_fetchNFTsByCollection: qn_fetchNFTsByCollection(object_with_contract_address_and_token_ids) returns an object with specific token data\n• qn_fetchNFTCollectionDetails: qn_fetchNFTCollectionDetails(object_with_contract_addresses) returns array of contract objects\n• qn_getWalletTokenBalance: qn_getWalletTokenBalance(object_with_wallet_and_contracts) returns an object with an array of token assets\n• qn_getWalletTokenTransactions: qn_getWalletTokenTransactions(object_with_address_and_contract) returns object containing token details and array of transfers\n• qn_getTokenMetadataByContractAddress: qn_getTokenMetadataByContractAddress(object_with_contract_address) returns an object with token details\n• qn_verifyNFTsOwner: qn_verifyNFTsOwner(object_with_wallet_address_and_array_of_contracts_and_tokens) returns object with owner and NFTs\n• qn_getTokenMetadataBySymbol: qn_getTokenMetadataBySymbol(object_with_symbol) returns an array of token metadata\n• qn_fetchNFTs: qn_fetchNFTs(object_with_wallet_and_contracts) returns an object with owner and NFTs\n• qn_getTransfersByNFT: qn_getTransfersByNFT(object_with_contract_address_and_token_id) returns an object with an array of transfer data\n• qn_getTransactionsByAddress: qn_getTransactionsByAddress (object_with_wallet_address) returns an object with an array of transaction data\n• qn_getContractABI: qn_getContractABI(object_with_contract) retrieves smart contract's ABI", "requestBody": { "required": true, "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "jsonrpc": { "type": "string", "enum": [ "2.0" ] }, "method": { "type": "string", "enum": [ "qn_fetchNFTsByCollection" ] }, "id": { "type": "integer", "example": 1 }, "params": { "type": "array", "description": "Positional parameters", "items": { "description": "Parameter value (can be string, number, boolean, object, etc.)" }, "example": [ "EXAMPLE" ] } }, "required": [ "jsonrpc", "method", "id", "params" ] }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "enum": [ "2.0" ] }, "method": { "type": "string", "enum": [ "qn_fetchNFTCollectionDetails" ] }, "id": { "type": "integer", "example": 1 }, "params": { "type": "array", "description": "Positional parameters", "items": { "description": "Parameter value (can be string, number, boolean, object, etc.)" }, "example": [ "EXAMPLE" ] } }, "required": [ "jsonrpc", "method", "id", "params" ] }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "enum": [ "2.0" ] }, "method": { "type": "string", "enum": [ "qn_getWalletTokenBalance" ] }, "id": { "type": "integer", "example": 1 }, "params": { "type": "array", "description": "Positional parameters", "items": { "description": "Parameter value (can be string, number, boolean, object, etc.)" }, "example": [ "EXAMPLE" ] } }, "required": [ "jsonrpc", "method", "id", "params" ] }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "enum": [ "2.0" ] }, "method": { "type": "string", "enum": [ "qn_getWalletTokenTransactions" ] }, "id": { "type": "integer", "example": 1 }, "params": { "type": "array", "description": "Positional parameters", "items": { "description": "Parameter value (can be string, number, boolean, object, etc.)" }, "example": [ "EXAMPLE" ] } }, "required": [ "jsonrpc", "method", "id", "params" ] }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "enum": [ "2.0" ] }, "method": { "type": "string", "enum": [ "qn_getTokenMetadataByContractAddress" ] }, "id": { "type": "integer", "example": 1 }, "params": { "type": "array", "description": "Positional parameters", "items": { "description": "Parameter value (can be string, number, boolean, object, etc.)" }, "example": [ "EXAMPLE" ] } }, "required": [ "jsonrpc", "method", "id", "params" ] }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "enum": [ "2.0" ] }, "method": { "type": "string", "enum": [ "qn_verifyNFTsOwner" ] }, "id": { "type": "integer", "example": 1 }, "params": { "type": "array", "description": "Positional parameters", "items": { "description": "Parameter value (can be string, number, boolean, object, etc.)" }, "example": [ "EXAMPLE" ] } }, "required": [ "jsonrpc", "method", "id", "params" ] }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "enum": [ "2.0" ] }, "method": { "type": "string", "enum": [ "qn_getTokenMetadataBySymbol" ] }, "id": { "type": "integer", "example": 1 }, "params": { "type": "array", "description": "Positional parameters", "items": { "description": "Parameter value (can be string, number, boolean, object, etc.)" }, "example": [ "EXAMPLE" ] } }, "required": [ "jsonrpc", "method", "id", "params" ] }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "enum": [ "2.0" ] }, "method": { "type": "string", "enum": [ "qn_fetchNFTs" ] }, "id": { "type": "integer", "example": 1 }, "params": { "type": "array", "description": "Positional parameters", "items": { "description": "Parameter value (can be string, number, boolean, object, etc.)" }, "example": [ "EXAMPLE" ] } }, "required": [ "jsonrpc", "method", "id", "params" ] }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "enum": [ "2.0" ] }, "method": { "type": "string", "enum": [ "qn_getTransfersByNFT" ] }, "id": { "type": "integer", "example": 1 }, "params": { "type": "array", "description": "Positional parameters", "items": { "description": "Parameter value (can be string, number, boolean, object, etc.)" }, "example": [ "EXAMPLE" ] } }, "required": [ "jsonrpc", "method", "id", "params" ] }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "enum": [ "2.0" ] }, "method": { "type": "string", "enum": [ "qn_getTransactionsByAddress" ] }, "id": { "type": "integer", "example": 1 }, "params": { "type": "array", "description": "Positional parameters", "items": { "description": "Parameter value (can be string, number, boolean, object, etc.)" }, "example": [ "EXAMPLE" ] } }, "required": [ "jsonrpc", "method", "id", "params" ] }, { "type": "object", "properties": { "jsonrpc": { "type": "string", "enum": [ "2.0" ] }, "method": { "type": "string", "enum": [ "qn_getContractABI" ] }, "id": { "type": "integer", "example": 1 }, "params": { "type": "array", "description": "Positional parameters", "items": { "description": "Parameter value (can be string, number, boolean, object, etc.)" }, "example": [ { "contract": "0xdAC17F958D2ee523a2206206994597C13D831ec7" } ] } }, "required": [ "jsonrpc", "method", "id", "params" ] } ], "discriminator": { "propertyName": "method" } }, "examples": { "qn_fetchNFTsByCollection": { "summary": "qn_fetchNFTsByCollection(object_with_contract_address_and_token_ids) returns an object with specific token data", "value": { "jsonrpc": "2.0", "method": "qn_fetchNFTsByCollection", "id": 1, "params": [ "EXAMPLE" ] } }, "qn_fetchNFTCollectionDetails": { "summary": "qn_fetchNFTCollectionDetails(object_with_contract_addresses) returns array of contract objects", "value": { "jsonrpc": "2.0", "method": "qn_fetchNFTCollectionDetails", "id": 1, "params": [ "EXAMPLE" ] } }, "qn_getWalletTokenBalance": { "summary": "qn_getWalletTokenBalance(object_with_wallet_and_contracts) returns an object with an array of token assets", "value": { "jsonrpc": "2.0", "method": "qn_getWalletTokenBalance", "id": 1, "params": [ "EXAMPLE" ] } }, "qn_getWalletTokenTransactions": { "summary": "qn_getWalletTokenTransactions(object_with_address_and_contract) returns object containing token details and array of transfers", "value": { "jsonrpc": "2.0", "method": "qn_getWalletTokenTransactions", "id": 1, "params": [ "EXAMPLE" ] } }, "qn_getTokenMetadataByContractAddress": { "summary": "qn_getTokenMetadataByContractAddress(object_with_contract_address) returns an object with token details", "value": { "jsonrpc": "2.0", "method": "qn_getTokenMetadataByContractAddress", "id": 1, "params": [ "EXAMPLE" ] } }, "qn_verifyNFTsOwner": { "summary": "qn_verifyNFTsOwner(object_with_wallet_address_and_array_of_contracts_and_tokens) returns object with owner and NFTs", "value": { "jsonrpc": "2.0", "method": "qn_verifyNFTsOwner", "id": 1, "params": [ "EXAMPLE" ] } }, "qn_getTokenMetadataBySymbol": { "summary": "qn_getTokenMetadataBySymbol(object_with_symbol) returns an array of token metadata", "value": { "jsonrpc": "2.0", "method": "qn_getTokenMetadataBySymbol", "id": 1, "params": [ "EXAMPLE" ] } }, "qn_fetchNFTs": { "summary": "qn_fetchNFTs(object_with_wallet_and_contracts) returns an object with owner and NFTs", "value": { "jsonrpc": "2.0", "method": "qn_fetchNFTs", "id": 1, "params": [ "EXAMPLE" ] } }, "qn_getTransfersByNFT": { "summary": "qn_getTransfersByNFT(object_with_contract_address_and_token_id) returns an object with an array of transfer data", "value": { "jsonrpc": "2.0", "method": "qn_getTransfersByNFT", "id": 1, "params": [ "EXAMPLE" ] } }, "qn_getTransactionsByAddress": { "summary": "qn_getTransactionsByAddress (object_with_wallet_address) returns an object with an array of transaction data", "value": { "jsonrpc": "2.0", "method": "qn_getTransactionsByAddress", "id": 1, "params": [ "EXAMPLE" ] } }, "qn_getContractABI": { "summary": "qn_getContractABI(object_with_contract) retrieves smart contract's ABI", "value": { "jsonrpc": "2.0", "method": "qn_getContractABI", "id": 1, "params": [ { "contract": "0xdAC17F958D2ee523a2206206994597C13D831ec7" } ] } } } } } }, "responses": { "200": { "description": "JSON-RPC response", "content": { "application/json": { "schema": { "type": "object", "properties": { "jsonrpc": { "type": "string", "enum": [ "2.0" ] }, "id": { "type": "integer" }, "result": { "description": "Method result" }, "error": { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "data": { "description": "Additional error data" } } } }, "required": [ "jsonrpc", "id" ] } } } } }, "externalDocs": { "url": "https://www.quicknode.com/docs/ethereum/qn_fetchNFTsByCollection_v2", "description": "Documentation: qn_fetchNFTsByCollection: https://www.quicknode.com/docs/ethereum/qn_fetchNFTsByCollection_v2, qn_fetchNFTCollectionDetails: https://www.quicknode.com/docs/ethereum/qn_fetchNFTCollectionDetails_v2, qn_getWalletTokenBalance: https://www.quicknode.com/docs/ethereum/qn_getWalletTokenBalance_v2, qn_getWalletTokenTransactions: https://www.quicknode.com/docs/ethereum/qn_getWalletTokenTransactions_v2, qn_getTokenMetadataByContractAddress: https://www.quicknode.com/docs/ethereum/qn_getTokenMetadataByContractAddress_v2, qn_verifyNFTsOwner: https://www.quicknode.com/docs/ethereum/qn_verifyNFTsOwner_v2, qn_getTokenMetadataBySymbol: https://www.quicknode.com/docs/ethereum/qn_getTokenMetadataBySymbol_v2, qn_fetchNFTs: https://www.quicknode.com/docs/ethereum/qn_fetchNFTs_v2, qn_getTransfersByNFT: https://www.quicknode.com/docs/ethereum/qn_getTransfersByNFT_v2, qn_getTransactionsByAddress: https://www.quicknode.com/docs/ethereum/qn_getTransactionsByAddress_v2, qn_getContractABI: https://www.quicknode.com/docs/ethereum/qn_fetchNFTs_v2" }, "tags": [ "JSON-RPC" ] } } }, "externalDocs": { "description": "Support Documentation", "url": "https://support.quicknode.com/hc/en-us" } }