evm_api.nft
evm_api.nft.get_contract_nfts()
Get NFTs for a given contract address, including metadata for all NFTs (where available).
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
"chain": "eth",
"format": "decimal",
"limit": 0,
"disable_total": True,
"totalRanges": 0,
"range": 0,
"cursor": "",
"normalizeMetadata": True,
"media_items": True,
}
result = evm_api.nft.get_contract_nfts(
api_key=api_key,
params=params,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
address | str | The address of the NFT contract | Yes | “0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB” | |
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” | |
format | enum[str]: - “decimal” - “hex” |
The format of the token ID | “decimal” | “decimal” | |
limit | int | The desired page size of the result. | 0 | ||
disable_total | bool | If the result should skip returning the total count (Improves performance). | True | True | |
totalRanges | int | The number of subranges to split the results into | 0 | ||
range | int | The desired subrange to query | 0 | ||
cursor | str | The cursor returned in the previous response (used for getting the next page). | ”” | ||
normalizeMetadata | bool | Should normalized metadata be returned? | False | True | |
media_items | bool | Should preview media data be returned? | False | True |
evm_api.nft.get_multiple_nfts()
Returns an array of NFTs specified in the request.
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"chain": "eth",
}
body = {
"tokens": [{'token_address': '0xa4991609c508b6d4fb7156426db0bd49fe298bd8', 'token_id': '12'}, {'token_address': '0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7', 'token_id': '1'}, {'token_address': '0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7', 'token_id': '200'}],
"normalizeMetadata": False,
"media_items": False,
}
result = evm_api.nft.get_multiple_nfts(
api_key=api_key,
params=params,
body=body,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” |
Object with the properties:
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
tokens | List of object: - token_address: str - token_id: str |
The tokens to be fetched (max 25 tokens) | Yes | [{‘token_address’: ‘0xa4991609c508b6d4fb7156426db0bd49fe298bd8’, ‘token_id’: ‘12’}, {‘token_address’: ‘0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7’, ‘token_id’: ‘1’}, {‘token_address’: ‘0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7’, ‘token_id’: ‘200’}] | |
normalizeMetadata | bool | Should normalized metadata be returned? | Yes | False | |
media_items | bool | Should preview media data be returned? | Yes | False |
evm_api.nft.get_nft_contract_metadata()
Get the collection / contract level metadata for a given contract (name, symbol, base token URI).
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
"chain": "eth",
}
result = evm_api.nft.get_nft_contract_metadata(
api_key=api_key,
params=params,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
address | str | The address of the NFT contract | Yes | “0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB” | |
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” |
evm_api.nft.get_nft_contract_transfers()
Get transfers of NFTs for a given contract and other parameters.
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
"chain": "eth",
"from_block": 0,
"to_block": 0,
"from_date": "",
"to_date": "",
"format": "decimal",
"limit": 0,
"disable_total": True,
"cursor": "",
}
result = evm_api.nft.get_nft_contract_transfers(
api_key=api_key,
params=params,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
address | str | The address of the NFT contract | Yes | “0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB” | |
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” | |
from_block | int | The minimum block number from where to get the transfers * Provide the param ‘from_block’ or ‘from_date’ * If ‘from_date’ and ‘from_block’ are provided, ‘from_block’ will be used. |
0 | ||
to_block | int | The maximum block number from where to get the transfers. * Provide the param ‘to_block’ or ‘to_date’ * If ‘to_date’ and ‘to_block’ are provided, ‘to_block’ will be used. |
0 | ||
from_date | str | The date from where to get the transfers (any format that is accepted by momentjs) * Provide the param ‘from_block’ or ‘from_date’ * If ‘from_date’ and ‘from_block’ are provided, ‘from_block’ will be used. |
”” | ||
to_date | str | Get transfers up until this date (any format that is accepted by momentjs) * Provide the param ‘to_block’ or ‘to_date’ * If ‘to_date’ and ‘to_block’ are provided, ‘to_block’ will be used. |
”” | ||
format | enum[str]: - “decimal” - “hex” |
The format of the token ID | “decimal” | “decimal” | |
limit | int | The desired page size of the result. | 0 | ||
disable_total | bool | If the result should skip returning the total count (Improves performance). | True | True | |
cursor | str | The cursor returned in the previous response (used for getting the next page). | ”” |
evm_api.nft.get_nft_lowest_price()
Get the lowest executed price for an NFT contract for the last x days (only trades paid in ETH).
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
"chain": "eth",
"days": 0,
"marketplace": "opensea",
}
result = evm_api.nft.get_nft_lowest_price(
api_key=api_key,
params=params,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
address | str | The address of the NFT contract | Yes | “0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D” | |
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” | |
days | int | The number of days to look back to find the lowest price If not provided 7 days will be the default |
0 | ||
marketplace | enum[str]: - “opensea” |
Marketplace from which to get the trades (only OpenSea is supported at the moment) | “opensea” | “opensea” |
evm_api.nft.get_nft_metadata()
Get NFT data, including metadata (where available), for the given NFT token ID and contract address.
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
"token_id": "1",
"chain": "eth",
"format": "decimal",
"normalizeMetadata": True,
"media_items": True,
}
result = evm_api.nft.get_nft_metadata(
api_key=api_key,
params=params,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
address | str | The address of the NFT contract | Yes | “0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB” | |
token_id | str | The ID of the token | Yes | “1” | |
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” | |
format | enum[str]: - “decimal” - “hex” |
The format of the token ID | “decimal” | “decimal” | |
normalizeMetadata | bool | Should normalized metadata be returned? | False | True | |
media_items | bool | Should preview media data be returned? | False | True |
evm_api.nft.get_nft_owners()
Get owners of NFTs for a given contract.
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
"chain": "eth",
"format": "decimal",
"limit": 0,
"disable_total": True,
"cursor": "",
"normalizeMetadata": True,
"media_items": True,
}
result = evm_api.nft.get_nft_owners(
api_key=api_key,
params=params,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
address | str | The address of the NFT contract | Yes | “0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB” | |
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” | |
format | enum[str]: - “decimal” - “hex” |
The format of the token ID | “decimal” | “decimal” | |
limit | int | The desired page size of the result. | 0 | ||
disable_total | bool | If the result should skip returning the total count (Improves performance). | True | True | |
cursor | str | The cursor returned in the previous response (used for getting the next page). | ”” | ||
normalizeMetadata | bool | Should normalized metadata be returned? | False | True | |
media_items | bool | Should preview media data be returned? | False | True |
evm_api.nft.get_nft_token_id_owners()
Get owners of a specific NFT given the contract address and token ID.
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
"token_id": "1",
"chain": "eth",
"format": "decimal",
"limit": 0,
"disable_total": True,
"cursor": "",
"normalizeMetadata": True,
"media_items": True,
}
result = evm_api.nft.get_nft_token_id_owners(
api_key=api_key,
params=params,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
address | str | The address of the NFT contract | Yes | “0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB” | |
token_id | str | The ID of the token | Yes | “1” | |
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” | |
format | enum[str]: - “decimal” - “hex” |
The format of the token ID | “decimal” | “decimal” | |
limit | int | The desired page size of the result. | 0 | ||
disable_total | bool | If the result should skip returning the total count (Improves performance). | True | True | |
cursor | str | The cursor returned in the previous response (used for getting the next page). | ”” | ||
normalizeMetadata | bool | Should normalized metadata be returned? | False | True | |
media_items | bool | Should preview media data be returned? | False | True |
evm_api.nft.get_nft_trades()
Get trades of NFTs for a given contract and marketplace.
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
"chain": "eth",
"from_block": 0,
"to_block": "",
"from_date": "",
"to_date": "",
"marketplace": "opensea",
"cursor": "",
"limit": 0,
"disable_total": True,
}
result = evm_api.nft.get_nft_trades(
api_key=api_key,
params=params,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
address | str | The address of the NFT contract | Yes | “0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB” | |
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” | |
from_block | int | The minimum block number from which to get the transfers * Provide the param ‘from_block’ or ‘from_date’ * If ‘from_date’ and ‘from_block’ are provided, ‘from_block’ will be used. |
0 | ||
to_block | str | The block number to get the trades from | ”” | ||
from_date | str | The start date from which to get the transfers (any format that is accepted by momentjs) * Provide the param ‘from_block’ or ‘from_date’ * If ‘from_date’ and ‘from_block’ are provided, ‘from_block’ will be used. |
”” | ||
to_date | str | The end date from which to get the transfers (any format that is accepted by momentjs) * Provide the param ‘to_block’ or ‘to_date’ * If ‘to_date’ and ‘to_block’ are provided, ‘to_block’ will be used. |
”” | ||
marketplace | enum[str]: - “opensea” |
Marketplace from which to get the trades (only OpenSea is supported at the moment) | “opensea” | “opensea” | |
cursor | str | The cursor returned in the previous response (used for getting the next page). | ”” | ||
limit | int | The desired page size of the result. | 0 | ||
disable_total | bool | If the result should skip returning the total count (Improves performance). | True | True |
evm_api.nft.get_nft_transfers()
Get transfers of an NFT given a contract address and token ID.
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
"token_id": "1",
"chain": "eth",
"format": "decimal",
"limit": 0,
"disable_total": True,
"cursor": "",
}
result = evm_api.nft.get_nft_transfers(
api_key=api_key,
params=params,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
address | str | The address of the NFT contract | Yes | “0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB” | |
token_id | str | The ID of the token | Yes | “1” | |
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” | |
format | enum[str]: - “decimal” - “hex” |
The format of the token ID | “decimal” | “decimal” | |
limit | int | The desired page size of the result. | 0 | ||
disable_total | bool | If the result should skip returning the total count (Improves performance). | True | True | |
cursor | str | The cursor returned in the previous response (used for getting the next page). | ”” |
evm_api.nft.get_nft_transfers_by_block()
Get transfers of NFTs given a block number or block hash.
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"block_number_or_hash": "15846571",
"chain": "eth",
"limit": 0,
"disable_total": True,
"cursor": "",
}
result = evm_api.nft.get_nft_transfers_by_block(
api_key=api_key,
params=params,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
block_number_or_hash | str | The block number or block hash | Yes | “15846571” | |
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” | |
limit | int | The desired page size of the result. | 100 | 0 | |
disable_total | bool | If the result should skip returning the total count (Improves performance). | True | True | |
cursor | str | The cursor returned in the previous response (used for getting the next page). | ”” |
evm_api.nft.get_nft_transfers_from_to_block()
Get transfers of NFTs from a block number to a block number.
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"chain": "eth",
"from_block": 0,
"to_block": 0,
"from_date": "",
"to_date": "",
"format": "decimal",
"limit": 0,
"disable_total": True,
"cursor": "",
}
result = evm_api.nft.get_nft_transfers_from_to_block(
api_key=api_key,
params=params,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” | |
from_block | int | The minimum block number from which to get the transfers * Provide the param ‘from_block’ or ‘from_date’ * If ‘from_date’ and ‘from_block’ are provided, ‘from_block’ will be used. |
0 | ||
to_block | int | The maximum block number from which to get the transfers. * Provide the param ‘to_block’ or ‘to_date’ * If ‘to_date’ and ‘to_block’ are provided, ‘to_block’ will be used. |
0 | ||
from_date | str | The start date from which to get the transfers (any format that is accepted by momentjs) * Provide the param ‘from_block’ or ‘from_date’ * If ‘from_date’ and ‘from_block’ are provided, ‘from_block’ will be used. |
”” | ||
to_date | str | The end date from which to get the transfers (any format that is accepted by momentjs) * Provide the param ‘to_block’ or ‘to_date’ * If ‘to_date’ and ‘to_block’ are provided, ‘to_block’ will be used. |
”” | ||
format | enum[str]: - “decimal” - “hex” |
The format of the token ID | “decimal” | “decimal” | |
limit | int | The desired page size of the result. | 0 | ||
disable_total | bool | If the result should skip returning the total count (Improves performance). | True | True | |
cursor | str | The cursor returned in the previous response (for getting the next page) |
”” |
evm_api.nft.get_wallet_nft_collections()
Get NFT collections owned by a given wallet address.
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"chain": "eth",
"limit": 0,
"disable_total": True,
"cursor": "",
}
result = evm_api.nft.get_wallet_nft_collections(
api_key=api_key,
params=params,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
address | str | The wallet address of the owner of NFTs in the collections | Yes | “0xd8da6bf26964af9d7eed9e03e53415d37aa96045” | |
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” | |
limit | int | The desired page size of the result. | 0 | ||
disable_total | bool | If the result should skip returning the total count (Improves performance). | True | True | |
cursor | str | The cursor returned in the previous response (used for getting the next page). | ”” |
evm_api.nft.get_wallet_nft_transfers()
Get transfers of NFTs given the wallet and other parameters.
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"chain": "eth",
"format": "decimal",
"direction": "both",
"from_block": 0,
"to_block": "",
"from_date": "",
"to_date": "",
"limit": 0,
"disable_total": True,
"cursor": "",
}
result = evm_api.nft.get_wallet_nft_transfers(
api_key=api_key,
params=params,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
address | str | The wallet address of the sender or recipient of the transfers | Yes | “0xd8da6bf26964af9d7eed9e03e53415d37aa96045” | |
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” | |
format | enum[str]: - “decimal” - “hex” |
The format of the token ID | “decimal” | “decimal” | |
direction | enum[str]: - “both” - “to” - “from” |
The transfer direction | “both” | “both” | |
from_block | int | The minimum block number from which to get the transfers * Provide the param ‘from_block’ or ‘from_date’ * If ‘from_date’ and ‘from_block’ are provided, ‘from_block’ will be used. |
0 | ||
to_block | str | To get the reserves at this block number | ”” | ||
from_date | str | The date from where to get the transfers (any format that is accepted by momentjs) * Provide the param ‘from_block’ or ‘from_date’ * If ‘from_date’ and ‘from_block’ are provided, ‘from_block’ will be used. |
”” | ||
to_date | str | Get transfers up until this date (any format that is accepted by momentjs) * Provide the param ‘to_block’ or ‘to_date’ * If ‘to_date’ and ‘to_block’ are provided, ‘to_block’ will be used. |
”” | ||
limit | int | The desired page size of the result. | 0 | ||
disable_total | bool | If the result should skip returning the total count (Improves performance). | True | True | |
cursor | str | The cursor returned in the previous response (used for getting the next page). | ”” |
evm_api.nft.get_wallet_nfts()
Get NFTs owned by a given address.
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"chain": "eth",
"format": "decimal",
"limit": 0,
"disable_total": True,
"token_addresses": [],
"cursor": "",
"normalizeMetadata": True,
"media_items": True,
}
result = evm_api.nft.get_wallet_nfts(
api_key=api_key,
params=params,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
address | str | The address of the wallet | Yes | “0xd8da6bf26964af9d7eed9e03e53415d37aa96045” | |
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” | |
format | enum[str]: - “decimal” - “hex” |
The format of the token ID | “decimal” | “decimal” | |
limit | int | The desired page size of the result. | 0 | ||
disable_total | bool | If the result should skip returning the total count (Improves performance). | True | True | |
token_addresses | List of str | The addresses to get balances for (optional) | [] | ||
cursor | str | The cursor returned in the previous response (used for getting the next page). | ”” | ||
normalizeMetadata | bool | Should normalized metadata be returned? | False | True | |
media_items | bool | Should preview media data be returned? | False | True |
evm_api.nft.re_sync_metadata()
Resync the metadata for an NFT
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
"token_id": "1",
"chain": "eth",
"flag": "uri",
"mode": "sync",
}
result = evm_api.nft.re_sync_metadata(
api_key=api_key,
params=params,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
address | str | The address of the NFT contract | Yes | “0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB” | |
token_id | str | The ID of the token | Yes | “1” | |
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” | |
flag | enum[str]: - “uri” - “metadata” |
The type of resync to operate | “uri” | “uri” | |
mode | enum[str]: - “async” - “sync” |
To define the behaviour of the endpoint | “async” | “sync” |
evm_api.nft.search_nfts()
Get NFTs that match a given metadata search query.
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"q": "",
"chain": "eth",
"format": "decimal",
"filter": "name",
"from_block": 0,
"to_block": 0,
"from_date": "",
"to_date": "",
"addresses": [],
"cursor": "",
"limit": 0,
"disable_total": True,
}
result = evm_api.nft.search_nfts(
api_key=api_key,
params=params,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
q | str | The search string | Yes | ”” | |
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” | |
format | enum[str]: - “decimal” - “hex” |
The format of the token ID | “decimal” | “decimal” | |
filter | enum[str]: - “name” - “description” - “attributes” - “global” - “name,description” - “name,attributes” - “description,attributes” - “name,description,attributes” |
What fields the search should match on. To look into the entire metadata set the value to ‘global’. To have a better response time you can look into a specific field like name | “global” | “name” | |
from_block | int | The minimum block number from which to start the search * Provide the param ‘from_block’ or ‘from_date’ * If ‘from_date’ and ‘from_block’ are provided, ‘from_block’ will be used. |
0 | ||
to_block | int | The maximum block number from which to end the search * Provide the param ‘to_block’ or ‘to_date’ * If ‘to_date’ and ‘to_block’ are provided, ‘to_block’ will be used. |
0 | ||
from_date | str | The date from which to start the search (any format that is accepted by momentjs) * Provide the param ‘from_block’ or ‘from_date’ * If ‘from_date’ and ‘from_block’ are provided, ‘from_block’ will be used. |
”” | ||
to_date | str | Get search results up until this date (any format that is accepted by momentjs) * Provide the param ‘to_block’ or ‘to_date’ * If ‘to_date’ and ‘to_block’ are provided, ‘to_block’ will be used. |
”” | ||
addresses | List of str | The addresses to get metadata for | [] | ||
cursor | str | The cursor returned in the previous response (used for getting the next page). | ”” | ||
limit | int | The desired page size of the result. | 0 | ||
disable_total | bool | If the result should skip returning the total count (Improves performance). | True | True |
evm_api.nft.sync_nft_contract()
Initiates a sync of a previously non synced contract.
from moralis import evm_api
api_key = "YOUR_API_KEY"
params = {
"address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
"chain": "eth",
}
result = evm_api.nft.sync_nft_contract(
api_key=api_key,
params=params,
)
print(result)
Name | Type | Description | Required | Default | Example |
---|---|---|---|---|---|
address | str | The address of the NFT contract | Yes | “0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB” | |
chain | enum[str]: - “eth” - “0x1” - “goerli” - “0x5” - “sepolia” - “0xaa36a7” - “polygon” - “0x89” - “mumbai” - “0x13881” - “bsc” - “0x38” - “bsc testnet” - “0x61” - “avalanche” - “0xa86a” - “fantom” - “0xfa” - “palm” - “0x2a15c308d” - “cronos” - “0x19” - “arbitrum” - “0xa4b1” |
The chain to query | “eth” | “eth” |