Moralis Web3 企业级API Moralis Web3API.token

2024-02-26 开发教程 Moralis Web3 企业级API 匿名 5℃

getTokenMetadata

返回给定代币合约地址（异步）的元数据（名称、符号、小数、徽标）。

选项：

chain（可选）：从中获取数据的区块链。有效值列在支持的链上。默认值 Eth。
address（必需）：获取元数据的地址或地址数组

你可以使用JS、React、curl、Unity来实现

//Get metadata for one token. Ex: USDT token on ETH
const options = {
  chain: "eth",
  addresses: "0xdAC17F958D2ee523a2206206994597C13D831ec7",
};
const tokenMetadata = await Moralis.Web3API.token.getTokenMetadata(options);
//Get metadata for an array of tokens. Ex: USDT and USDC tokens on BSC
const options = {
  chain: "bsc",
  addresses: [
    "0x55d398326f99059ff775485246999027b3197955",
    "0x0a385f86059e0b2a048171d78afd1f38558121f3",
  ],
};
const tokenMetadata = await Moralis.Web3API.token.getTokenMetadata(options);

import React from "react";
import { useMoralisWeb3Api } from "react-moralis";
const Web3Api = useMoralisWeb3Api();
const fetchTokenMetadata = async () => {
  //Get metadata for one token. Ex: USDT token on ETH
  const options = {
    chain: "eth",
    addresses: "0xdAC17F958D2ee523a2206206994597C13D831ec7",
  };
  const tokenMetadata = await Web3Api.token.getTokenMetadata(options);
  console.log(tokenMetadata);
  //Get metadata for an array of tokens. Ex: USDT and USDC tokens on BSC
  const options = {
    chain: "bsc",
    addresses: [
      "0x55d398326f99059ff775485246999027b3197955",
      "0x0a385f86059e0b2a048171d78afd1f38558121f3",
    ],
  };
  const tokenArrayMetadata = await Web3Api.token.getTokenMetadata(options);
  console.log(tokenArrayMetadata);
};

curl -X 'GET' \
  'https://deep-index.moralis.io/api/v2/erc20/metadata?chain=bsc&addresses=0x55d398326f99059ff775485246999027b3197955&addresses=0x0a385f86059e0b2a048171d78afd1f38558121f3' \
  -H 'accept: application/json' \
  -H 'X-API-Key: MY-API-KEY'

using System.Collections.Generic;
using Moralis.Web3Api.Models;
using MoralisWeb3ApiSdk;
  public async void fetchTokenMetadata()
  {
    List<string> addresses = new List<string>();
    addresses.Add("0xdAC17F958D2ee523a2206206994597C13D831ec7");
    addresses.Add("0x0a385f86059e0b2a048171d78afd1f38558121f3");
    List<Erc20Metadata> resp = await web3Api.Token.GetTokenMetadata(addresses, ChainList.eth);
    foreach(Erc20Metadata erc20metadata in resp){
      print(erc20metadata.ToJson());
    }
  }

示例结果：

[
  {
    address: "0x0a385f86059e0b2a048171d78afd1f38558121f3",
    name: "USD Coin on BSC",
    symbol: "USDC",
    logo: null,
    logo_hash: null,
    thumbnail: null,
    decimals: "6",
    block_number: "8242108",
    validated: 1,
    created_at: "2022-01-20T10:41:03.034Z",
  },
  {
    address: "0x55d398326f99059ff775485246999027b3197955",
    name: "Tether USD",
    symbol: "USDT",
    logo: null,
    logo_hash: null,
    thumbnail: null,
    decimals: "18",
    block_number: "8242108",
    validated: 1,
    created_at: "2022-01-20T10:41:03.034Z",
  },
];

getTokenMetadataBySymbol

返回给定符号（异步）的元数据（名称、地址、小数、徽标）。

选项：

chain（可选）：从中获取数据的区块链。有效值列在支持的链上。默认值 Eth。
symbols（必需）：要获取元数据的令牌符号或符号数组

你可以使用JS、React、curl、Unity来实现

//Get metadata for one token
const options = { chain: "bsc", symbols: "LINK" };
const tokenMetadata = await Moralis.Web3API.token.getTokenMetadataBySymbol(
  options
);
//Get metadata for an array of tokens
const options = { chain: "bsc", symbols: ["LINK", "AAVE"] };
const tokenMetadata = await Moralis.Web3API.token.getTokenMetadataBySymbol(
  options
);

import React from "react";
import { useMoralisWeb3Api } from "react-moralis";
const Web3Api = useMoralisWeb3Api();
const fetchTokenMetadataBySymbol = async () => {
  //Get metadata for one token
  const options = { chain: "bsc", symbols: "LINK" };
  const tokenMetadata = await Web3Api.token.getTokenMetadataBySymbol(options);
  console.log(tokenMetadata);
  //Get metadata for an array of tokens
  const options = { chain: "bsc", symbols: ["LINK", "AAVE"] };
  const tokenArrayMetadata = await Web3Api.token.getTokenMetadataBySymbol(
    options
  );
  console.log(tokenArrayMetadata);
};

curl -X 'GET' \
  'https://deep-index.moralis.io/api/v2/erc20/metadata/symbols?chain=bsc&symbols=LINK&symbols=AAVE' \
  -H 'accept: application/json' \
  -H 'X-API-Key: MY-API-KEY'

using System.Collections.Generic;
using Moralis.Web3Api.Models;
using MoralisWeb3ApiSdk;
  public async void fetchTokenMetadataBySymbol()
  {
    List<string> symbols = new List<string>();
    symbols.Add("AAVE");
    symbols.Add("LINK");
    List<Erc20Metadata> resp = await web3Api.Token.GetTokenMetadataBySymbol(symbols, ChainList.bsc);
    foreach(Erc20Metadata erc20metadata in resp){
      print(erc20metadata.ToJson());
    }
  }

示例结果：

[
  {
    address:
      "0x2d30ca6f024dbc1307ac8a1a44ca27de6f797ec22ef20627a1307243b0ab7d09",
    name: "Kylin Network",
    symbol: "KYL",
    decimals: "18",
    logo: "https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c.png",
    logo_hash:
      "ee7aa2cdf100649a3521a082116258e862e6971261a39b5cd4e4354fcccbc54d",
    thumbnail:
      "https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c_thumb.png",
    block_number: "string",
    validated: "string",
  },
];

getTokenAllowance

返回允许支出者从支出者提取的金额（异步）。

选项：

chain（可选）：从中获取数据的区块链。有效值列在支持的链上。默认值 Eth。
owner_address（必填）：代币所有者的地址
spender_address（必填）：代币支出者的地址
address(必填): 代币合约的地址

你可以使用JS、React、curl、Unity来实现

//Get token allowace on ETH
const options = {
  //token holder
  owner_address: "0xd1628228ffaede220cd583da5f9262355682210a",
  //uniswap v3 router 2 contract address
  spender_address: "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
  //ENS token contract address
  address: "0xC18360217D8F7Ab5e7c516566761Ea12Ce7F9D72",
};
const allowance = await Moralis.Web3API.token.getTokenAllowance(options);

import React from "react";
import { useMoralisWeb3Api } from "react-moralis";
const Web3Api = useMoralisWeb3Api();
const fetchTokenAllowance = async () => {
  //Get token allowace on ETH
  const options = {
    //token holder
    owner_address: "0xd1628228ffaede220cd583da5f9262355682210a",
    //uniswap v3 router 2 contract address
    spender_address: "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
    //ENS token contract address
    address: "0xC18360217D8F7Ab5e7c516566761Ea12Ce7F9D72",
  };
  const allowance = await Web3Api.token.getTokenAllowance(options);
  console.log(allowance);
};

curl -X 'GET' \
  'https://deep-index.moralis.io/api/v2/erc20/0xC18360217D8F7Ab5e7c516566761Ea12Ce7F9D72/allowance?chain=eth&owner_address=0xd1628228ffaede220cd583da5f9262355682210a&spender_address=0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45' \
  -H 'accept: application/json' \
  -H 'X-API-Key: MY-API-KEY'

using System.Collections.Generic;
using Moralis.Web3Api.Models;
using MoralisWeb3ApiSdk;
  public async void fetchTokenMetadataBySymbol()
  {
    Erc20Allowance allowance = await MoralisInterface.GetClient().Web3Api.Token.GetTokenAllowance(address: "0xC18360217D8F7Ab5e7c516566761Ea12Ce7F9D72", ownerAddress: "0xd1628228ffaede220cd583da5f9262355682210a", spenderAddress: "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45", ChainList.eth);
    print(allowance.ToJson());
  }

示例结果：

{
  "allowance": "115792089237316195423570985008687907853269984665640564039457584007913129639935"
}

getTokenPrice

返回本地代币中指定的价格和给定代币合约地址的美元（异步）。

选项：

chain（可选）：从中获取数据的区块链。有效值列在支持的链上。默认值 Eth。
exchange（可选）：代币交易所的工厂名称或地址。对于不同的链，可能的交换是：
ETH mainnet：uniswap-v3、sushiswap、uniswap-v2
BSC mainnet：pancakeswap-v2、pancakeswap-v1
Polygon mainnet：快速交换。如果没有指定交换，则检查所有交换（按上面列出的顺序），直到找到有效的池。请注意，此请求可能需要更多时间。因此，在大多数情况下，指定交换会导致更快的响应。
address(必填): 代币合约的地址
to_block（可选）：返回给定区块号的价格（历史价格数据）

你可以使用JS、React、curl来实现

//Get token price on PancakeSwap v2 BSC
const options = {
  address: "0x42F6f551ae042cBe50C739158b4f0CAC0Edb9096",
  chain: "bsc",
  exchange: "PancakeSwapv2",
};
const price = await Moralis.Web3API.token.getTokenPrice(options);

import React from "react";
import { useMoralisWeb3Api } from "react-moralis";
const Web3Api = useMoralisWeb3Api();
const fetchTokenPrice = async () => {
  //Get token price on PancakeSwap v2 BSC
  const options = {
    address: "0x42F6f551ae042cBe50C739158b4f0CAC0Edb9096",
    chain: "bsc",
    exchange: "PancakeSwapv2",
  };
  const price = await Web3Api.token.getTokenPrice(options);
  console.log(price);
};

curl -X 'GET' \
  'https://deep-index.moralis.io/api/v2/erc20/0x42F6f551ae042cBe50C739158b4f0CAC0Edb9096/price?chain=bsc&exchange=PancakeSwapv2' \
  -H 'accept: application/json' \
  -H 'X-API-Key: MY-API-KEY'

示例结果：

{
  "nativePrice": {
    "value": "8409770570506626",
    "decimals": 18,
    "name": "Ether",
    "symbol": "ETH"
  },
  "usdPrice": 19.722370676,
  "exchangeAddress": "0x1f98431c8ad98523631ae4a59f267346ea31f984",
  "exchangeName": "Uniswap v3"
}

getAllTokenIds

针对给定的代币合约地址（异步）返回一个包含多个 NFT 的对象和一个包含 NFT 元数据（名称、符号）的数组。

选项：

chain（可选）：从中获取数据的区块链。有效值列在支持的链上。默认值 Eth。
format（可选）：token id 的格式。可用值：十进制、十六进制。默认值：十进制。
offset（可选）：偏移量。
limit（可选）：限制。
address（必填）：代币合约的地址。

你可以使用JS、React、curl、Unity来实现

const options = {
  address: "0x7dE3085b3190B3a787822Ee16F23be010f5F8686",
  chain: "eth",
};
const NFTs = await Moralis.Web3API.token.getAllTokenIds(options);

import React from "react";
import { useMoralisWeb3Api } from "react-moralis";
const Web3Api = useMoralisWeb3Api();
const fetchAllTokenIds = async () => {
  const options = {
    address: "0x7dE3085b3190B3a787822Ee16F23be010f5F8686",
    chain: "eth",
  };
  const NFTs = await Web3Api.token.getAllTokenIds(options);
  console.log(NFTs);
};

curl -X 'GET' \
  'https://deep-index.moralis.io/api/v2/nft/0x7dE3085b3190B3a787822Ee16F23be010f5F8686?chain=eth&format=decimal' \
  -H 'accept: application/json' \
  -H 'X-API-Key: MY-API-KEY'

using System.Collections.Generic;
using Moralis.Web3Api.Models;
using MoralisWeb3ApiSdk;
  public async void fetchAllTokenIds()
  {
    NftCollection nfts = await MoralisInterface.GetClient().Web3Api.Token.GetAllTokenIds(address: "0x7dE3085b3190B3a787822Ee16F23be010f5F8686" , ChainList.eth);
    print(nfts.ToJson());
  }

示例结果：

[
  {
    token_address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
    token_id: "728",
    amount: "1",
    contract_type: "ERC721",
    name: "Baby Ape Mutant Club",
    symbol: "BAMC",
    token_uri:
      "https://gateway.moralisipfs.com/ipfs/QmajSqgxY3cWBgBeRm38vasJAcTit1kp5EwqVHxszJYgUC/728.json",
    metadata:
      '{\n  "name": "Baby Mutant #728",\n  "description": "",\n  "image": "ipfs://QmPUDVLP9W1pWpCTpGvpPbMu4nVpCuu2A7M6tQovDpVDoD/728.png",\n  "dna": "172bef0b78106072e4eacb26db57ae70fb17b37b",\n  "edition": 728,\n  "date": 1645023568505,\n  "artist": "Skurvydogg",\n  "attributes": [\n    {\n      "trait_type": "BackGrounds",\n      "value": "Putrid_Purple"\n    },\n    {\n      "trait_type": "Furs",\n      "value": "Red_rum"\n    },\n    {\n      "trait_type": "Eyes",\n      "value": "Robot_M1"\n    },\n    {\n      "trait_type": "Hats",\n      "value": "Bunny_Ears_M2"\n    },\n    {\n      "trait_type": "Mouths",\n      "value": "Xenomorf_M1"\n    }\n  ]\n}',
    synced_at: "2022-03-05T02:29:18.441Z",
  },
];

getNFTMetadata

返回给定合约（异步）的合约级别元数据（名称、符号、基本令牌 uri）。

选项：

chain（可选）：从中获取数据的区块链。有效值列在支持的链上。默认值 Eth。
address（必填）：代币合约的地址。

你可以使用JS、React、curl、Unity来实现

对尚未索引的合约地址的请求将自动启动该 NFT 集合的索引过程

示例结果：

{
  "token_address": "0x7de3085b3190b3a787822ee16f23be010f5f8686",
  "name": "Baby Ape Mutant Club",
  "symbol": "BAMC",
  "contract_type": "ERC721",
  "synced_at": "2022-02-19"
}

getNFTOwners

返回具有多个 NFT 所有者的对象和具有给定代币合约地址（异步）的 NFT 元数据（名称、符号）的数组。

选项：

chain（可选）：从中获取数据的区块链。有效值列在支持的链上。默认值 Eth。
format（可选）：token id 的格式。可用值：十进制、十六进制。默认值：十进制。
offset（可选）：偏移量。
limit（可选）：限制。
address(必填): 合约地址

你可以使用JS、React、curl、Unity来实现

const options = {
  address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
  chain: "eth",
};
const nftOwners = await Moralis.Web3API.token.getNFTOwners(options);

import React from "react";
import { useMoralisWeb3Api } from "react-moralis";
const Web3Api = useMoralisWeb3Api();
const fetchNFTOwners = async () => {
  const options = {
    address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
    chain: "eth",
  };
  const nftOwners = await Web3Api.token.getNFTOwners(options);
  console.log(nftOwners);
};

curl -X 'GET' \
  'https://deep-index.moralis.io/api/v2/nft/0x7de3085b3190b3a787822ee16f23be010f5f8686/owners?chain=eth&format=decimal' \
  -H 'accept: application/json' \
  -H 'X-API-Key: MY-API-KEY'

using System.Collections.Generic;
using Moralis.Web3Api.Models;
using MoralisWeb3ApiSdk;
  public async void fetchNFTOwners()
  {
    NftOwnerCollection nftowners = await MoralisInterface.GetClient().Web3Api.Token.GetNFTOwners(address: "0x7de3085b3190b3a787822ee16f23be010f5f8686", ChainList.eth);
    print(nftowners.ToJson());
  }

确保在 token_id 之类的列上包含排序参数，以获得一致的分页结果

对尚未索引的合约地址的请求将自动启动该 NFT 集合的索引过程

示例结果：

[
  {
    token_address: "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
    token_id: "15",
    contract_type: "ERC721",
    owner_of: "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
    block_number: "88256",
    block_number_minted: "88256",
    token_uri: "string",
    metadata: "string",
    synced_at: "string",
    amount: "1",
    name: "CryptoKitties",
    symbol: "RARI",
  },
];

searchNFTs

非常强大且快速的工具，用于基于元数据搜索（异步）获取 NFT 数据。

选项：

chain（可选）：从中获取数据的区块链。有效值列在支持的链上。默认值 Eth。
format（可选）：token id 的格式。可用值：十进制、十六进制。默认值：十进制。
offset（可选）：偏移量。
limit（可选）：限制。
q（必需）：搜索字符串参数
filter（必需）：搜索应匹配的字段。要查看整个元数据，请将值设置为全局。要获得更好的响应时间，您可以查看特定字段，例如名称。可用值：name; description; attributes; global; name,description; name,attributes; description,attributes; name,description,attributes

你可以使用JS、React、curl、Unity来实现

const options = { q: "Pancake", chain: "bsc", filter: "name" };
const NFTs = await Moralis.Web3API.token.searchNFTs(options);

import React from "react";
import { useMoralisWeb3Api } from "react-moralis";
const Web3Api = useMoralisWeb3Api();
const fetchSearchNFTs = async () => {
  const options = { q: "Pancake", chain: "bsc", filter: "name" };
  const NFTs = await Web3Api.token.searchNFTs(options);
  console.log(NFTs);
};

curl -X 'GET' \
  'https://deep-index.moralis.io/api/v2/nft/search?chain=bsc&format=decimal&q=Pancake&filter=name' \
  -H 'accept: application/json' \
  -H 'X-API-Key: MY-API-KEY'

using System.Collections.Generic;
using Moralis.Web3Api.Models;
using MoralisWeb3ApiSdk;
  public async void fetchSearchNFTs()
  {
    NftMetadataCollection nft = await MoralisInterface.GetClient().Web3Api.Token.SearchNFTs(q: "Pancake", ChainList.bsc, filter: "name");
    print(nft.ToJson());
  }

示例结果：

[
  {
    token_id: "124436",
    token_address: "0x3afa102b264b5f79ce80fed29e0724f922ba57c7",
    token_uri:
      "https://ipfs.moralis.io:2053/ipfs/QmVAD8v4s2SXF8FgjePqMdQ2GV5hE2isZnzxcrA36XcSDA/metadata.json",
    metadata:
      '{"name":"Pancake","description":"The dessert series 1","image":"ipfs://QmNQFXCZ6LGzvpMW9Q5PWbCrEnLknQrPwr2r8pbQAgzQ9A/4863BD6B-6C92-4B96-BF80-8020B2F7C3A5.jpeg"}',
    contract_type: "ERC721",
    token_hash: "d03fe436e972bf9215d7bb8c64c4c556",
    synced_at: null,
    created_at: "2021-09-19T10:36:16.610Z",
  },
];

全局搜索

const options = { q: "bored ape", chain: "bsc", filter: "global" };
const NFTs = await Moralis.Web3API.token.searchNFTs(options);

import React from "react";
import { useMoralisWeb3Api } from "react-moralis";
const Web3Api = useMoralisWeb3Api();
const fetchSearchNFTs = async () => {
  const options = { q: "bored ape", chain: "bsc", filter: "global" };
  const NFTs = await Web3Api.token.searchNFTs(options);
  console.log(NFTs);
};

curl -X 'GET' \
  'https://deep-index.moralis.io/api/v2/nft/search?chain=bsc&format=decimal&q=Pancake&filter=global' \
  -H 'accept: application/json' \
  -H 'X-API-Key: MY-API-KEY'

using System.Collections.Generic;
using Moralis.Web3Api.Models;
using MoralisWeb3ApiSdk;
  public async void fetchSearchNFTs()
  {
    NftMetadataCollection nft = await MoralisInterface.GetClient().Web3Api.Token.SearchNFTs(q: "Pancake", ChainList.bsc, filter: "global");
    print(nft.ToJson());
  }

按描述、属性搜索

const options = {
  q: "loves bananas",
  chain: "bsc",
  filter: "description,attributes",
};
const NFTs = await Moralis.Web3API.token.searchNFTs(options);

import React from "react";
import { useMoralisWeb3Api } from "react-moralis";
const Web3Api = useMoralisWeb3Api();
const fetchSearchNFTs = async () => {
  const options = {
    q: "loves bananas",
    chain: "bsc",
    filter: "description,attributes",
  };
  const NFTs = await Web3Api.token.searchNFTs(options);
  console.log(NFTs);
};

curl -X 'GET' \
  'https://deep-index.moralis.io/api/v2/nft/search?chain=bsc&format=decimal&q=Pancake&filter=description%2Cattributes' \
  -H 'accept: application/json' \
  -H 'X-API-Key: MY-API-KEY'

using System.Collections.Generic;
using Moralis.Web3Api.Models;
using MoralisWeb3ApiSdk;
  public async void fetchSearchNFTs()
  {
    NftMetadataCollection nft = await MoralisInterface.GetClient().Web3Api.Token.SearchNFTs(q: "Pancake", ChainList.bsc, filter: "description,attributes");
    print(nft.ToJson());
  }

getContractNFTTransfers

针对给定的代币合约地址（异步）返回一个包含 NFT 传输数量的对象和一个包含 NFT 传输的数组。

选项：

chain（可选）：从中获取数据的区块链。有效值列在支持的链上。默认值 Eth。
format（可选）：token id 的格式。可用值：十进制、十六进制。默认值为十进制。
offset（可选）：偏移量。
limit（可选）：限制。
address(必填): 合约地址

你可以使用JS、React、curl、Unity来实现

const options = {
  address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
  chain: "eth",
};
const nftTransfers = await Moralis.Web3API.token.getContractNFTTransfers(
  options
);

import React from "react";
import { useMoralisWeb3Api } from "react-moralis";
const Web3Api = useMoralisWeb3Api();
const fetchContractNFTTransfers = async () => {
  const options = {
    address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
    chain: "eth",
  };
  const nftTransfers = await Web3Api.token.getContractNFTTransfers(options);
  console.log(NFTs);
};

curl -X 'GET' \
  'https://deep-index.moralis.io/api/v2/nft/0x7de3085b3190b3a787822ee16f23be010f5f8686/1/transfers?chain=eth&format=decimal' \
  -H 'accept: application/json' \
  -H 'X-API-Key: MY-API-KEY'

using System.Collections.Generic;
using Moralis.Web3Api.Models;
using MoralisWeb3ApiSdk;
  public async void fetchContractNFTTransfers()
  {
    NftTransferCollection nftTransers = await MoralisInterface.GetClient().Web3Api.Token.GetContractNFTTransfers(address: "0x7de3085b3190b3a787822ee16f23be010f5f8686", ChainList.eth);
    print(nftTransfers.ToJson());
  }

示例结果：

[
  {
    block_number: "14238158",
    block_timestamp: "2022-02-19T18:49:02.000Z",
    block_hash:
      "0x8124f4a126996d306a90fa00b871b6ed9669a1a9806106b34fa28f3de61e5f8b",
    transaction_hash:
      "0x2db36892fc17bf99a3f6dd8a639f3c704f772858f3961cbcd26b3a42a2cd561e",
    transaction_index: 162,
    log_index: 419,
    value: "0",
    contract_type: "ERC721",
    transaction_type: "Single",
    token_address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
    token_id: "1",
    from_address: "0x0000000000000000000000000000000000000000",
    to_address: "0x324fb4a58674758e00c3a49409b815de1398bfe8",
    amount: "1",
    verified: 1,
    operator: null,
  },
];

getTokenIdMetadata

返回数据，包括给定合约地址的给定令牌 id 的完全解析的元数据（异步）。

选项：

chain（可选）：从中获取数据的区块链。有效值列在支持的链上。默认值 Eth。
format（可选）：token id 的格式。可用值：十进制、十六进制。默认值为十进制。
address(必填): 合约地址
token_id （必填）：token 的 id

你可以使用JS、React、curl、Unity来实现

const options = {
  address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
  token_id: "1",
  chain: "eth",
};
const tokenIdMetadata = await Moralis.Web3API.token.getTokenIdMetadata(options);

import React from "react";
import { useMoralisWeb3Api } from "react-moralis";
const Web3Api = useMoralisWeb3Api();
const fetchTokenIdMetadata = async () => {
  const options = {
    address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
    token_id: "1",
    chain: "eth",
  };
  const tokenIdMetadata = await Web3Api.token.getTokenIdMetadata(options);
  console.log(tokenIdMetadata);
};

curl -X 'GET' \
  'https://deep-index.moralis.io/api/v2/nft/0x7de3085b3190b3a787822ee16f23be010f5f8686/1?chain=eth&format=decimal' \
  -H 'accept: application/json' \
  -H 'X-API-Key: MY-API-KEY'

using System.Collections.Generic;
using Moralis.Web3Api.Models;
using MoralisWeb3ApiSdk;
  public async void fetchTokenIdMetadata()
  {
    Nft tokenIdMetadata = await MoralisInterface.GetClient().Web3Api.Token.GetTokenIdMetadata(address: "0x7de3085b3190b3a787822ee16f23be010f5f8686", tokenId: "1", ChainList.eth);
    print(tokenIdMetadata.ToJson());
  }

示例结果：

{
  "token_address": "0x7de3085b3190b3a787822ee16f23be010f5f8686",
  "token_id": "1",
  "block_number_minted": "14238158",
  "owner_of": "0x324fb4a58674758e00c3a49409b815de1398bfe8",
  "block_number": "14238158",
  "amount": "1",
  "contract_type": "ERC721",
  "name": "Baby Ape Mutant Club",
  "symbol": "BAMC",
  "token_uri": "https://ipfs.moralis.io:2053/ipfs/QmYuHVS98nZxzYmuk9E6HA1TNr2W6PpV4fvE4MDfCFgfCP",
  "metadata": "{\n  \"name\": \"Baby Ape Mutant Club\",\n  \"description\": \"Wait for reveal\",\n  \"image\": \"ipfs://QmPS5CMBd9Zwidies964iHb9hcdDmXZkWBGZyaJ9c1Gmif\"\n}\n",
  "synced_at": "2022-02-19T18:50:43.217Z",
  "is_valid": 1,
  "syncing": 2,
  "frozen": 0
}

getTokenIdOwners

返回一个包含 NFT 传输次数的对象和一个包含给定合约集合中所有 NFT 项目所有者的数组（异步）。

选项：

chain（可选）：从中获取数据的区块链。有效值列在支持的链上。默认值 Eth。
format（可选）：token id 的格式。可用值：十进制、十六进制。默认值为十进制
offset（可选）：偏移量。
limit（可选）：限制。
address（必填）：合约地址。
token_id(必填)：token的id。

你可以使用JS、React、curl、Unity来实现

const options = {
  address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
  token_id: "1",
  chain: "eth",
};
const tokenIdOwners = await Moralis.Web3API.token.getTokenIdOwners(options);

import React from "react";
import { useMoralisWeb3Api } from "react-moralis";
const Web3Api = useMoralisWeb3Api();
const fetchTokenIdOwners = async () => {
  const options = {
    address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
    token_id: "1",
    chain: "eth",
  };
  const tokenIdOwners = await Web3Api.token.getTokenIdOwners(options);
  console.log(tokenIdOwners);
};

curl -X 'GET' \
  'https://deep-index.moralis.io/api/v2/nft/0x7de3085b3190b3a787822ee16f23be010f5f8686/1/owners?chain=eth&format=decimal' \
  -H 'accept: application/json' \
  -H 'X-API-Key: MY-API-KEY'

using System.Collections.Generic;
using Moralis.Web3Api.Models;
using MoralisWeb3ApiSdk;
  public async void fetchTokenIdOwners()
  {
    NftOwnerCollection tokenIdOwners = await MoralisInterface.GetClient().Web3Api.Token.GetTokenIdOwners(address: "0x7de3085b3190b3a787822ee16f23be010f5f8686", tokenId: "1" , ChainList.eth);
    print(tokenIdOwners.ToJson());
  }

示例结果

[
  {
    token_address: "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
    token_id: "15",
    contract_type: "ERC721",
    owner_of: "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
    block_number: "88256",
    block_number_minted: "88256",
    token_uri: "string",
    metadata: "string",
    synced_at: "string",
    amount: "1",
    name: "CryptoKitties",
    symbol: "RARI",
  },
];

getWalletTokenIdTransfers

返回一个包含 NFT 传输次数的对象和一个包含所有 NFT 传输的数组（按令牌 ID（异步））。

选项：

chain（可选）：从中获取数据的区块链。有效值列在支持的链上。默认值 Eth。
format（可选）：token id 的格式。可用值：十进制、十六进制。默认值为十进制
offset（可选）：偏移量。
limit（可选）：限制。
address（必填）：合约地址。
token_id(必填)：token的id。

你可以使用JS、React、curl、Unity来实现

const options = {
  address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
  token_id: "1",
  chain: "eth",
};
const transfers = await Moralis.Web3API.token.getWalletTokenIdTransfers(
  options
);

import React from "react";
import { useMoralisWeb3Api } from "react-moralis";
const Web3Api = useMoralisWeb3Api();
const fetchWalletTokenIdTransfers = async () => {
  const options = {
    address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
    token_id: "1",
    chain: "eth",
  };
  const transfers = await Web3Api.token.getWalletTokenIdTransfers(options);
  console.log(transfers);
};

curl -X 'GET' \
  'https://deep-index.moralis.io/api/v2/nft/0x7de3085b3190b3a787822ee16f23be010f5f8686/1/transfers?chain=eth&format=decimal' \
  -H 'accept: application/json' \
  -H 'X-API-Key: MY-API-KEY'

using System.Collections.Generic;
using Moralis.Web3Api.Models;
using MoralisWeb3ApiSdk;
  public async void fetchWalletTokenIdTransfers()
  {
    NftTransferCollection transfers = await  MoralisInterface.GetClient().Web3Api.Token.GetWalletTokenIdTransfers(address: "0x7de3085b3190b3a787822ee16f23be010f5f8686", tokenId: "1", ChainList.eth);
    print(transfers.ToJson());
  }

示例结果：

[
  {
    block_number: "14238158",
    block_timestamp: "2022-02-19T18:49:02.000Z",
    block_hash:
      "0x8124f4a126996d306a90fa00b871b6ed9669a1a9806106b34fa28f3de61e5f8b",
    transaction_hash:
      "0x2db36892fc17bf99a3f6dd8a639f3c704f772858f3961cbcd26b3a42a2cd561e",
    transaction_index: 162,
    log_index: 419,
    value: "0",
    contract_type: "ERC721",
    transaction_type: "Single",
    token_address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
    token_id: "1",
    from_address: "0x0000000000000000000000000000000000000000",
    to_address: "0x324fb4a58674758e00c3a49409b815de1398bfe8",
    amount: "1",
    verified: 1,
    operator: null,
  },
];

getNFTTrades

返回给定合约和市场的 NFT 交易对象

选项：

chain（可选）：从中获取数据的区块链。有效值列在支持的链上。默认值 Eth。
from_date（可选）：获取交易的日期（momentjs 接受的任何格式）。提供参数 'from_block' 或 'from_date' 如果提供了 'from_date' 和 'from_block'，则将使用 'from_block'。
to_date（可选）：获取到此日期的交易（momentjs 接受的任何格式）。提供参数 'to_block' 或 'to_date' 如果提供了 'to_date' 和 'to_block'，将使用 'to_block'。
from_block（可选）：从哪里获得交易的最小区块号提供参数'from_block'或'from_date'如果提供'from_date'和'from_block'，将使用'from_block'。
to_block（可选）：获取交易的最大区块数。提供参数 'to_block' 或 'to_date' 如果提供了 'to_date' 和 'to_block'，将使用 'to_block'。
offset（可选）：偏移量。
limit（可选）：限制。
marketplace（可选）：获取交易的市场（目前仅支持 opensea）。
address（必填）：合约地址（即 0x1a2b3x...）。

你可以使用JS、React、curl、Unity来实现

const options = {
  address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
  limit: "10",
  chain: "eth",
};
const NFTTrades = await Moralis.Web3API.token.getNFTTrades(options);

import React from "react";
import { useMoralisWeb3Api } from "react-moralis";
const Web3Api = useMoralisWeb3Api();
const fetchNFTTrades = async () => {
  const options = {
    address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
    limit: "10",
    chain: "eth",
  };
  const NFTTrades = await Web3Api.token.getNFTTrades(options);
  console.log(NFTTrades);
};

curl -X 'GET' \
  'https://deep-index.moralis.io/api/v2/nft/0x7de3085b3190b3a787822ee16f23be010f5f8686/trades?chain=eth&marketplace=opensea' \
  -H 'accept: application/json' \
  -H 'X-API-Key: MY-API-KEY'

using System.Collections.Generic;
using Moralis.Web3Api.Models;
using MoralisWeb3ApiSdk;
  public async void fetchNFTTrades()
  {
    TradeCollection trades = await MoralisInterface.GetClient().Web3Api.Token.GetNFTTrades(address: "0x7de3085b3190b3a787822ee16f23be010f5f8686", ChainList.eth, limit: 10);
    print(trades.ToJson());
  }

示例结果：

[
  {
    transaction_hash:
      "0x4de0bcef1450492bd5c2e7693cf644c40005868d0dcc8a7a50a80ef2efa88d1e",
    transaction_index: "164",
    token_ids: ["16404"],
    seller_address: "0xbae90f486d751f133702655627ce599249cd26b8",
    buyer_address: "0x8795e90de359c1e0bf2579646486f7f12f270d2f",
    token_address: "0xdf7952b35f24acf7fc0487d01c8d5690a60dba07",
    marketplace_address: "0x7be8076f4ea4a4ad08075c2508e481d6c946d12b",
    price: "280000000000000000",
    price_token_address: null,
    block_timestamp: "2021-05-09T23:00:25.000Z",
    block_number: "7281522",
    block_hash:
      "0xe870c197b0c614e055f4de5b264bc7c69eafc93a6d0ce300309de444b2ff7e3a",
  },
];

getNFTLowestPrice

返回最近 x 天的 NFT 代币合约价格最低的对象（仅以 ETH 支付的交易）

选项：

chain（可选）：从中获取数据的区块链。有效值列在支持的链上。默认值 Eth。
days（可选）：查找最低价格的天数如果未提供，则默认为 7 天
marketplace（可选）：获取交易的市场（目前仅支持 opensea）。
address（必填）：合约地址（即 0x1a2b3x...）。

你可以使用JS、React、curl、Unity来实现

const options = {
  address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
  days: "3",
};
const NFTLowestPrice = await Moralis.Web3API.token.getNFTLowestPrice(options);

import React from "react";
import { useMoralisWeb3Api } from "react-moralis";
const Web3Api = useMoralisWeb3Api();
const fetchNFTLowestPrice = async () => {
  const options = {
    address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
    days: "3",
  };
  const NFTLowestPrice = await Web3Api.token.getNFTLowestPrice(options);
  console.log(NFTLowestPrice);
};

curl -X 'GET' \
  'https://deep-index.moralis.io/api/v2/nft/0x7de3085b3190b3a787822ee16f23be010f5f8686/lowestprice?chain=eth&days=3&marketplace=opensea' \
  -H 'accept: application/json' \
  -H 'X-API-Key: MY-API-KEY'

using System.Collections.Generic;
using Moralis.Web3Api.Models;
using MoralisWeb3ApiSdk;
  public async void fetchNFTLowestPrice()
  {
    Trade NFTLowestPrice = await MoralisInterface.GetClient().Web3Api.Token.GetNFTLowestPrice(address: "0x7de3085b3190b3a787822ee16f23be010f5f8686", ChainList.eth, days: 2);
    print(NFTLowestPrice.ToJson());
  }

示例结果：

[
  {
    transaction_hash:
      "0xda5f3337eb74b56e99aebb5d9ebfc1e82b1c0aacc3b9b7cc606d4112ba12801d",
    transaction_index: "168",
    token_ids: ["254"],
    seller_address: "0x8a04cea099e2d2886aea08e33446b5a52b9cf900",
    buyer_address: "0xcf806faa913b3ac7bcb7b57b1199411a76d96646",
    token_address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
    marketplace_address: "0x7be8076f4ea4a4ad08075c2508e481d6c946d12b",
    price: "0",
    block_timestamp: "2022-02-26T17:19:23.000Z",
    block_number: "14283046",
    block_hash:
      "0x997713ef27375f735f7017824958c0f0093236fe7515f8759bead1ce21d554fb",
  },
];

reSyncMetadata

重新同步给定 token_id 的元数据

选项：

chain（可选）：从中获取数据的区块链。有效值列在支持的链上。默认值 Eth。
address（必填）：合约地址。
token_id(必填)：token的id。
flag（可选）：要操作的重新同步的类型。可用值：uri、metadata。默认值：metadata。 metadata标志将重新同步 nft 的metadata。 uri 标志将重新同步 NFT 的 token_uri。

你可以使用JS、React、curl、Unity来实现

const options = {
  address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
  token_id: "1",
  flag: "metadata",
};
const NFTLowestPrice = await Moralis.Web3API.token.reSyncMetadata(options);

import React from "react";
import { useMoralisWeb3Api } from "react-moralis";
const Web3Api = useMoralisWeb3Api();
const reSyncMetadata = async () => {
  const options = {
    address: "0x7de3085b3190b3a787822ee16f23be010f5f8686",
    token_id: "1",
    flag: "metadata",
  };
  const result = await Web3Api.token.reSyncMetadata(options);
  console.log(result);
};

curl -X 'PUT' \
  'https://deep-index.moralis.io/api/v2/nft/0x7de3085b3190b3a787822ee16f23be010f5f8686/sync?chain=eth' \
  -H 'accept: */*' \
  -H 'X-API-Key: MY-API-KEY'

using System.Collections.Generic;
using Moralis.Web3Api.Models;
using MoralisWeb3ApiSdk;
  public async void resyncMetadata()
  {
    await MoralisInterface.GetClient().Web3Api.Token.ReSyncMetadata(address: "0x7de3085b3190b3a787822ee16f23be010f5f8686", tokenId: "1", chain: ChainList.eth);
  }

示例结果：

{
  status: "Request initiated";
}

上一节： Moralis Web3API.account

下一节： Moralis Web3API.defi

"Moralis Web3 企业级API"的目录

Moralis Web3 企业级API Moralis Web3API.token

getTokenMetadata

getTokenMetadataBySymbol

getTokenAllowance

getTokenPrice

getAllTokenIds

getNFTMetadata

getNFTOwners

searchNFTs

全局搜索

按描述、属性搜索

getContractNFTTransfers

getTokenIdMetadata

getTokenIdOwners

getWalletTokenIdTransfers

getNFTTrades

getNFTLowestPrice

reSyncMetadata