moralis-data-api

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

CRITICAL: Read Rule Files Before Implementing

重要提示：实现前请先阅读规则文件

The #1 cause of bugs is not reading the endpoint rule file before writing code.

For EVERY endpoint:

Read
```
rules/{EndpointName}.md
```
Find "Example Response" section
Copy the EXACT JSON structure
Note field names (snake_case), data types, HTTP method, path, wrapper structure

Reading Order:

This SKILL.md (core patterns)
Endpoint rule file in
```
rules/
```
Pattern references in
```
references/
```
(for edge cases only)

导致bug的头号原因是在编写代码前未阅读端点规则文件。

对于每一个端点：

阅读
```
rules/{EndpointName}.md
```
找到“Example Response”部分
复制完全一致的JSON结构
注意字段名（snake_case）、数据类型、HTTP方法、路径、包装结构

阅读顺序：

本SKILL.md（核心模式）
```
rules/
```
目录下的端点规则文件
```
references/
```
中的模式参考（仅用于处理边缘情况）

Setup

配置

API Key (optional)

API密钥（可选）

Never ask the user to paste their API key into the chat. Instead:

Check if
```
MORALIS_API_KEY
```
is already set in the environment (try running
```
echo $MORALIS_API_KEY
```
).
If not set, offer to create the
```
.env
```
file with an empty placeholder:
```
MORALIS_API_KEY=
```
Tell the user to open the
```
.env
```
file and paste their key there themselves.
Let them know: without the key, you won't be able to test or call the Moralis API on their behalf.

If they don't have a key yet, point them to admin.moralis.com/register (free, no credit card).

绝对不要让用户在聊天中粘贴他们的API密钥。 正确做法：

检查环境中是否已设置
```
MORALIS_API_KEY
```
（可尝试运行
```
echo $MORALIS_API_KEY
```
）。
如果未设置，主动提议创建包含空占位符的
```
.env
```
文件：
```
MORALIS_API_KEY=
```
告知用户自行打开
```
.env
```
文件并粘贴密钥。
提醒用户：没有密钥的话，无法代表他们测试或调用Moralis API。

如果用户还没有密钥，引导他们前往admin.moralis.com/register注册（免费，无需信用卡）。

Environment Variable Discovery

环境变量位置

The

.env

file location depends on how skills are installed:

Create the

.env

file in the project root (same directory the user runs Claude Code from). Make sure

.env

is in

.gitignore

.env

文件的位置取决于技能的安装方式：

在项目根目录创建

.env

文件（即用户运行Claude Code的同一目录）。确保

.env

已添加到

.gitignore

中。

Verify Your Key

验证密钥

bash

curl "https://deep-index.moralis.io/api/v2.2/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balance?chain=0x1" \
  -H "X-API-Key: $MORALIS_API_KEY"

bash

curl "https://deep-index.moralis.io/api/v2.2/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balance?chain=0x1" \
  -H "X-API-Key: $MORALIS_API_KEY"

Base URLs

基础URL

API	Base URL
EVM	`https://deep-index.moralis.io/api/v2.2`
Solana	`https://solana-gateway.moralis.io`

API	基础URL
EVM	`https://deep-index.moralis.io/api/v2.2`
Solana	`https://solana-gateway.moralis.io`

Authentication

身份验证

All requests require:

X-API-Key: $MORALIS_API_KEY

所有请求都需要携带：

X-API-Key: $MORALIS_API_KEY

Quick Reference: Most Common Patterns

快速参考：最常用模式

Data Type Rules

数据类型规则

Field	Reality	NOT
`block_number`	Decimal `12386788`	Hex `0xf2b5a4`
`timestamp`	ISO `"2021-05-07T11:08:35.000Z"`	Unix `1620394115`
`balance`	String `"1000000000000000000"`	Number
`decimals`	String or number	Always number

字段	正确格式	错误格式
`block_number`	十进制数字 `12386788`	十六进制 `0xf2b5a4`
`timestamp`	ISO字符串 `"2021-05-07T11:08:35.000Z"`	时间戳数字 `1620394115`
`balance`	字符串 `"1000000000000000000"`	数字类型
`decimals`	字符串或数字	仅数字类型

Block Numbers (always decimal)

区块编号（始终为十进制）

typescript

block_number: 12386788; // number - use directly
block_number: "12386788"; // string - parseInt(block_number, 10)

typescript

block_number: 12386788; // 数字类型 - 直接使用
block_number: "12386788"; // 字符串类型 - 使用parseInt(block_number, 10)转换

Timestamps (usually ISO strings)

时间戳（通常为ISO字符串）

typescript

"2021-05-07T11:08:35.000Z"; // → new Date(timestamp).getTime()

typescript

"2021-05-07T11:08:35.000Z"; // → 使用new Date(timestamp).getTime()转换

Balances (always strings unless its a property named "formatted" eg. balanceFormatted, BigInt)

余额（除非字段名为"formatted"，如balanceFormatted，否则始终为字符串，需用BigInt处理）

typescript

balance: "1000000000000000000";
// → (Number(BigInt(balance)) / 1e18).toFixed(6)

typescript

balance: "1000000000000000000";
// → (Number(BigInt(balance)) / 1e18).toFixed(6)

Response Patterns

响应模式

Pattern	Example Endpoints
Direct array `[...]`	getWalletTokenBalancesPrice, getTokenMetadata
Wrapped `{ result: [] }`	getWalletNFTs, getWalletTransactions
Paginated `{ page, cursor, result }`	getWalletHistory, getNFTTransfers

typescript

// Safe extraction
const data = Array.isArray(response) ? response : response.result || [];

模式	示例端点
直接数组 `[...]`	getWalletTokenBalancesPrice, getTokenMetadata
包装结构 `{ result: [] }`	getWalletNFTs, getWalletTransactions
分页结构 `{ page, cursor, result }`	getWalletHistory, getNFTTransfers

typescript

// 安全提取数据
const data = Array.isArray(response) ? response : response.result || [];

Common Field Mappings

常见字段映射

typescript

token_address → tokenAddress
from_address_label → fromAddressLabel
block_number → blockNumber
receipt_status: "1" → success, "0" → failed
possible_spam: "true"/"false" → boolean check

typescript

token_address → tokenAddress
from_address_label → fromAddressLabel
block_number → blockNumber
receipt_status: "1" → success, "0" → failed
possible_spam: "true"/"false" → 布尔值检查

Common Pitfalls (Top 5)

常见陷阱（前5名）

Block numbers are decimal, not hex - Use
```
parseInt(x, 10)
```
, not
```
parseInt(x, 16)
```
Timestamps are ISO strings - Use
```
new Date(timestamp).getTime()
```
Balances are strings - Use
```
BigInt(balance)
```
for math
Response may be wrapped - Check for
```
.result
```
before
```
.map()
```
Path inconsistencies - Some use
```
/wallets/{address}/...
```
, others
```
/{address}/...
```

See references/CommonPitfalls.md for complete reference.

区块编号是十进制，不是十六进制 - 使用
```
parseInt(x, 10)
```
，而非
```
parseInt(x, 16)
```
时间戳是ISO字符串 - 使用
```
new Date(timestamp).getTime()
```
转换
余额是字符串类型 - 计算时使用
```
BigInt(balance)
```
响应可能被包装 - 调用
```
.map()
```
前先检查
```
.result
```
字段
路径不一致 - 部分端点使用
```
/wallets/{address}/...
```
，其他使用
```
/{address}/...
```

完整参考请见references/CommonPitfalls.md。

Pagination

分页

Many endpoints use cursor-based pagination:

bash

undefined

许多端点使用基于游标（cursor）的分页：

bash

undefined

First request

首次请求

curl "...?limit=100" -H "X-API-Key: $KEY"

下一页请求

curl "...?limit=100&cursor=<cursor_from_response>" -H "X-API-Key: $KEY"


See [references/Pagination.md](references/Pagination.md) for details.

---

curl "...?limit=100&cursor=<cursor_from_response>" -H "X-API-Key: $KEY"


详细说明请见[references/Pagination.md](references/Pagination.md)。

---

Testing Endpoints

测试端点

bash

ADDRESS="0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
CHAIN="0x1"

bash

ADDRESS="0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
CHAIN="0x1"

Wallet Balance

钱包余额

curl "https://deep-index.moralis.io/api/v2.2/${ADDRESS}/balance?chain=${CHAIN}"
-H "X-API-Key: $MORALIS_API_KEY"

Token Price

代币价格

curl "https://deep-index.moralis.io/api/v2.2/erc20/0x6B175474E89094C44Da98b954EedeAC495271d0F/price?chain=${CHAIN}"
-H "X-API-Key: $MORALIS_API_KEY"

Wallet Transactions (note result wrapper)

钱包交易记录（注意结果被包装）

curl "https://deep-index.moralis.io/api/v2.2/${ADDRESS}?chain=${CHAIN}&limit=5"
-H "X-API-Key: $MORALIS_API_KEY" | jq '.result'

---

curl "https://deep-index.moralis.io/api/v2.2/${ADDRESS}?chain=${CHAIN}&limit=5"
-H "X-API-Key: $MORALIS_API_KEY" | jq '.result'

---

Quick Troubleshooting

快速故障排查

Issue	Cause	Solution
"Property does not exist"	Field name mismatch	Check snake_case in rule file
"Cannot read undefined"	Missing optional field	Use `?.` optional chaining
"blockNumber is NaN"	Parsing decimal as hex	Use radix 10: `parseInt(x, 10)`
"Wrong timestamp"	Parsing ISO as number	Use `new Date(timestamp).getTime()`
"404 Not Found"	Wrong endpoint path	Verify path in rule file

问题	原因	解决方案
"Property does not exist"	字段名不匹配	检查规则文件中的snake_case字段名
"Cannot read undefined"	缺少可选字段	使用 `?.` 可选链操作符
"blockNumber is NaN"	将十进制解析为十六进制	使用基数10： `parseInt(x, 10)`
"Wrong timestamp"	将ISO字符串解析为数字	使用 `new Date(timestamp).getTime()`
"404 Not Found"	端点路径错误	验证规则文件中的路径

Default Chain Behavior

默认链行为

EVM addresses (
0x...
): Default to Ethereum (

chain=0x1

) unless specified.

Solana addresses (base58): Auto-detected and routed to Solana API.

EVM地址（
0x...
格式）：除非指定，否则默认使用Ethereum链（

chain=0x1

）。

Solana地址（base58格式）： 自动检测并路由到Solana API。

Supported Chains

支持的链

EVM (40+ chains): Ethereum (0x1), Polygon (0x89), BSC (0x38), Arbitrum (0xa4b1), Optimism (0xa), Base (0x2105), Avalanche (0xa86a), and more.

Solana: Mainnet, Devnet

See references/SupportedApisAndChains.md for full list.

EVM（40+条链）： Ethereum (0x1), Polygon (0x89), BSC (0x38), Arbitrum (0xa4b1), Optimism (0xa), Base (0x2105), Avalanche (0xa86a)等。

Solana： 主网、测试网

完整列表请见references/SupportedApisAndChains.md。

Endpoint Catalog

端点目录

Complete list of all 135 endpoints (101 EVM + 34 Solana) organized by category.

所有135个端点的完整列表（101个EVM端点 + 34个Solana端点），按类别组织。

Wallet

钱包

Balances, tokens, NFTs, transaction history, profitability, and net worth data.

Endpoint	Description
getNativeBalance	Get native balance by wallet
getNativeBalancesForAddresses	Get native balance for a set of wallets
getWalletActiveChains	Get active chains by wallet address
getWalletApprovals	Get ERC20 approvals by wallet
getWalletHistory	Get the complete decoded transaction history of a wallet
getWalletNetWorth	Get wallet net worth
getWalletNFTCollections	Get NFT collections by wallet address
getWalletNFTs	Get NFTs by wallet address
getWalletNFTTransfers	Get NFT Transfers by wallet address
getWalletProfitability	Get detailed profit and loss by wallet address
getWalletProfitabilitySummary	Get profit and loss summary by wallet address
getWalletStats	Get summary stats by wallet address
getWalletTokenBalancesPrice	Get token balances with prices by wallet address
getWalletTokenTransfers	Get ERC20 token transfers by wallet address
getWalletTransactions	Get native transactions by wallet
getWalletTransactionsVerbose	Get decoded transactions by wallet

余额、代币、NFT、交易历史、收益和净值数据。

端点	描述
getNativeBalance	通过钱包地址查询原生代币余额
getNativeBalancesForAddresses	查询一组钱包地址的原生代币余额
getWalletActiveChains	通过钱包地址查询活跃链
getWalletApprovals	通过钱包地址查询ERC20授权记录
getWalletHistory	查询钱包的完整解码交易历史
getWalletNetWorth	查询钱包净值
getWalletNFTCollections	通过钱包地址查询NFT藏品
getWalletNFTs	通过钱包地址查询NFT
getWalletNFTTransfers	通过钱包地址查询NFT转账记录
getWalletProfitability	通过钱包地址查询详细的盈亏数据
getWalletProfitabilitySummary	通过钱包地址查询盈亏摘要
getWalletStats	通过钱包地址查询摘要统计数据
getWalletTokenBalancesPrice	通过钱包地址查询带价格的代币余额
getWalletTokenTransfers	通过钱包地址查询ERC20代币转账记录
getWalletTransactions	通过钱包地址查询原生代币交易记录
getWalletTransactionsVerbose	通过钱包地址查询解码后的交易记录

Token

代币

Token prices, metadata, pairs, DEX swaps, analytics, security scores, and sniper detection.

Endpoint	Description
getAggregatedTokenPairStats	Get aggregated token pair statistics by address
getHistoricalTokenScore	Get historical token score by token address
getMultipleTokenAnalytics	Get token analytics for a list of token addresses
getPairAddress	Get DEX token pair address
getPairReserves	Get DEX token pair reserves
getPairStats	Get stats by pair address
getSnipersByPairAddress	Get snipers by pair address
getSwapsByPairAddress	Get swap transactions by pair address
getSwapsByTokenAddress	Get swap transactions by token address
getSwapsByWalletAddress	Get swap transactions by wallet address
getTimeSeriesTokenAnalytics	Retrieve timeseries trading stats by token addresses
getTokenAnalytics	Get token analytics by token address
getTokenBondingStatus	Get the token bonding status
getTokenCategories	Get ERC20 token categories
getTokenHolders	Get a holders summary by token address
getTokenMetadata	Get ERC20 token metadata by contract
getTokenMetadataBySymbol	Get ERC20 token metadata by symbols
getTokenOwners	Get ERC20 token owners by contract
getTokenPairs	Get token pairs by address
getTokenScore	Get token score by token address
getTokenStats	Get ERC20 token stats
getTokenTransfers	Get ERC20 token transfers by contract address

代币价格、元数据、交易对、DEX交易、分析数据、安全评分和狙击手检测。

端点	描述
getAggregatedTokenPairStats	通过地址查询聚合的代币交易对统计数据
getHistoricalTokenScore	通过代币地址查询历史代币评分
getMultipleTokenAnalytics	查询一组代币地址的代币分析数据
getPairAddress	查询DEX代币交易对地址
getPairReserves	查询DEX代币交易对储备金
getPairStats	通过交易对地址查询统计数据
getSnipersByPairAddress	通过交易对地址查询狙击手
getSwapsByPairAddress	通过交易对地址查询swap交易记录
getSwapsByTokenAddress	通过代币地址查询swap交易记录
getSwapsByWalletAddress	通过钱包地址查询swap交易记录
getTimeSeriesTokenAnalytics	通过代币地址查询时间序列交易统计数据
getTokenAnalytics	通过代币地址查询代币分析数据
getTokenBondingStatus	查询代币绑定状态
getTokenCategories	查询ERC20代币分类
getTokenHolders	通过代币地址查询持有者摘要
getTokenMetadata	通过合约地址查询ERC20代币元数据
getTokenMetadataBySymbol	通过代币符号查询ERC20代币元数据
getTokenOwners	通过合约地址查询ERC20代币持有者
getTokenPairs	通过地址查询代币交易对
getTokenScore	通过代币地址查询代币评分
getTokenStats	查询ERC20代币统计数据
getTokenTransfers	通过合约地址查询ERC20代币转账记录

NFT

NFT metadata, transfers, traits, rarity, floor prices, and trades.

Endpoint	Description
getContractNFTs	Get NFTs by contract address
getMultipleNFTs	Get Metadata for NFTs
getNFTBulkContractMetadata	Get metadata for multiple NFT contracts
getNFTByContractTraits	Get NFTs by traits
getNFTCollectionStats	Get summary stats by NFT collection
getNFTContractMetadata	Get NFT collection metadata
getNFTContractSalePrices	Get NFT sale prices by collection
getNFTContractTransfers	Get NFT transfers by contract address
getNFTFloorPriceByContract	Get NFT floor price by contract
getNFTFloorPriceByToken	Get NFT floor price by token
getNFTHistoricalFloorPriceByContract	Get historical NFT floor price by contract
getNFTMetadata	Get NFT metadata
getNFTOwners	Get NFT owners by contract address
getNFTSalePrices	Get NFT sale prices by token
getNFTTokenIdOwners	Get NFT owners by token ID
getNFTTrades	Get NFT trades by collection
getNFTTradesByToken	Get NFT trades by token
getNFTTradesByWallet	Get NFT trades by wallet address
getNFTTraitsByCollection	Get NFT traits by collection
getNFTTraitsByCollectionPaginate	Get NFT traits by collection paginate
getNFTTransfers	Get NFT transfers by token ID
getTopNFTCollectionsByMarketCap	Get top NFT collections by market cap

NFT元数据、转账、特质、稀有度、地板价和交易记录。

端点	描述
getContractNFTs	通过合约地址查询NFT
getMultipleNFTs	查询NFT元数据
getNFTBulkContractMetadata	查询多个NFT合约的元数据
getNFTByContractTraits	通过特质查询NFT
getNFTCollectionStats	通过NFT藏品查询摘要统计数据
getNFTContractMetadata	查询NFT藏品元数据
getNFTContractSalePrices	通过藏品查询NFT售价
getNFTContractTransfers	通过合约地址查询NFT转账记录
getNFTFloorPriceByContract	通过合约地址查询NFT地板价
getNFTFloorPriceByToken	通过代币查询NFT地板价
getNFTHistoricalFloorPriceByContract	通过合约地址查询NFT历史地板价
getNFTMetadata	查询NFT元数据
getNFTOwners	通过合约地址查询NFT持有者
getNFTSalePrices	通过代币查询NFT售价
getNFTTokenIdOwners	通过代币ID查询NFT持有者
getNFTTrades	通过藏品查询NFT交易记录
getNFTTradesByToken	通过代币查询NFT交易记录
getNFTTradesByWallet	通过钱包地址查询NFT交易记录
getNFTTraitsByCollection	通过藏品查询NFT特质
getNFTTraitsByCollectionPaginate	分页查询藏品의 NFT特质
getNFTTransfers	通过代币ID查询NFT转账记录
getTopNFTCollectionsByMarketCap	查询市值最高的NFT藏品

DeFi

DeFi protocol positions, liquidity, and exposure data.

Endpoint	Description
getDefiPositionsByProtocol	Get detailed DeFi positions by protocol for a wallet
getDefiPositionsSummary	Get DeFi positions of a wallet
getDefiSummary	Get the DeFi summary of a wallet

DeFi协议仓位、流动性和风险敞口数据。

端点	描述
getDefiPositionsByProtocol	查询钱包在指定DeFi协议中的详细仓位
getDefiPositionsSummary	查询钱包的DeFi仓位
getDefiSummary	查询钱包的DeFi摘要

Entity

实体

Labeled addresses including exchanges, funds, protocols, and whales.

Endpoint	Description
getEntity	Get Entity Details By Id
getEntityCategories	Get Entity Categories

带标签的地址，包括交易所、基金、协议和巨鲸地址。

端点	描述
getEntity	通过ID查询实体详情
getEntityCategories	查询实体分类

Price

价格

Token and NFT prices, OHLCV candlestick data.

Endpoint	Description
getMultipleTokenPrices	Get Multiple ERC20 token prices
getPairPrice	Get DEX token pair price
getTokenPrice	Get ERC20 token price

代币和NFT价格、OHLCV蜡烛图数据。

端点	描述
getMultipleTokenPrices	查询多个ERC20代币价格
getPairPrice	查询DEX代币交易对价格
getTokenPrice	查询ERC20代币价格

Blockchain

区块链

Blocks, transactions, date-to-block conversion, and contract functions.

Endpoint	Description
getBlock	Get block by hash
getDateToBlock	Get block by date
getLatestBlockNumber	Get latest block number
getTransaction	Get transaction by hash
getTransactionVerbose	Get decoded transaction by hash

区块、交易、日期转区块转换和合约函数。

端点	描述
getBlock	通过哈希查询区块
getDateToBlock	通过日期查询区块
getLatestBlockNumber	查询最新区块编号
getTransaction	通过哈希查询交易
getTransactionVerbose	通过哈希查询解码后的交易

Discovery

发现

Trending tokens, blue chips, market movers, and token discovery.

Endpoint	Description
getDiscoveryToken	Get token details
getTimeSeriesVolume	Retrieve timeseries trading stats by chain
getTimeSeriesVolumeByCategory	Retrieve timeseries trading stats by category
getTopCryptoCurrenciesByMarketCap	Get top crypto currencies by market cap
getTopCryptoCurrenciesByTradingVolume	Get top crypto currencies by trading volume
getTopERC20TokensByMarketCap	Get top ERC20 tokens by market cap
getTopERC20TokensByPriceMovers	Get top ERC20 tokens by price movements (winners and losers)
getTopGainersTokens	Get tokens with top gainers
getTopLosersTokens	Get tokens with top losers
getTopProfitableWalletPerToken	Get top traders for a given ERC20 token
getTrendingTokens	Get trending tokens
getVolumeStatsByCategory	Get trading stats by categories
getVolumeStatsByChain	Get trading stats by chain

热门代币、蓝筹币、市场异动和代币发现。

端点	描述
getDiscoveryToken	查询代币详情
getTimeSeriesVolume	通过链查询时间序列交易统计数据
getTimeSeriesVolumeByCategory	通过分类查询时间序列交易统计数据
getTopCryptoCurrenciesByMarketCap	查询市值最高的加密货币
getTopCryptoCurrenciesByTradingVolume	查询交易量最高的加密货币
getTopERC20TokensByMarketCap	查询市值最高的ERC20代币
getTopERC20TokensByPriceMovers	查询价格波动最大的ERC20代币（上涨和下跌）
getTopGainersTokens	查询涨幅最高的代币
getTopLosersTokens	查询跌幅最高的代币
getTopProfitableWalletPerToken	查询指定ERC20代币的顶级盈利钱包
getTrendingTokens	查询热门代币
getVolumeStatsByCategory	通过分类查询交易统计数据
getVolumeStatsByChain	通过链查询交易统计数据

Other

其他

Utility endpoints including API version, endpoint weights, and address resolution.

Endpoint	Description
getBondingTokensByExchange	Get bonding tokens by exchange
getCandleSticks	Get OHLCV by pair address
getEntitiesByCategory	Get Entities By Category
getFilteredTokens	Returns a list of tokens that match the specified filters and criteria
getGraduatedTokensByExchange	Get graduated tokens by exchange
getHistoricalTokenHolders	Get timeseries holders data
getNewTokensByExchange	Get new tokens by exchange
getUniqueOwnersByCollection	Get unique wallet addresses owning NFTs from a contract.
resolveAddress	ENS lookup by address
resolveAddressToDomain	Resolve Address to Unstoppable domain
resolveDomain	Resolve Unstoppable domain
resolveENSDomain	ENS lookup by domain
reSyncMetadata	Resync NFT metadata
searchEntities	Search Entities, Organizations or Wallets
searchTokens	Search for tokens based on contract address, pair address, token name or token symbol.

实用工具端点，包括API版本、端点权重和地址解析。

端点	描述
getBondingTokensByExchange	通过交易所查询绑定代币
getCandleSticks	通过交易对地址查询OHLCV蜡烛图
getEntitiesByCategory	通过分类查询实体
getFilteredTokens	返回符合指定筛选条件的代币列表
getGraduatedTokensByExchange	通过交易所查询已毕业代币
getHistoricalTokenHolders	查询时间序列持有者数据
getNewTokensByExchange	通过交易所查询新代币
getUniqueOwnersByCollection	查询持有某合约NFT的唯一钱包地址数量
resolveAddress	通过地址查询ENS域名
resolveAddressToDomain	将地址解析为Unstoppable域名
resolveDomain	解析Unstoppable域名
resolveENSDomain	通过域名查询ENS地址
reSyncMetadata	重新同步NFT元数据
searchEntities	搜索实体、组织或钱包
searchTokens	根据合约地址、交易对地址、代币名称或代币符号搜索代币

Solana Endpoints

Solana端点

Solana-specific endpoints (24 native + 10 EVM variants that support Solana chain = 34 total).

Endpoint	Description
balance	Gets native balance owned by the given address
getAggregatedTokenPairStats	Get aggregated token pair statistics by address
getBondingTokensByExchange	Get bonding tokens by exchange
getCandleSticks	Get candlesticks for a pair address
getGraduatedTokensByExchange	Get graduated tokens by exchange
getHistoricalTokenHolders	Get token holders overtime for a given tokens
getMultipleTokenMetadata	Get multiple token metadata
getMultipleTokenPrices	Get token price
getNFTMetadata	Get the global metadata for a given contract
getNFTs	Gets NFTs owned by the given address
getNewTokensByExchange	Get new tokens by exchange
getPairStats	Get stats for a pair address
getPortfolio	Gets the portfolio of the given address
getSPL	Gets token balances owned by the given address
getSnipersByPairAddress	Get snipers by pair address.
getSwapsByPairAddress	Get all swap related transactions (buy, sell, add liquidity & remove liquidity)
getSwapsByTokenAddress	Get all swap related transactions (buy, sell)
getSwapsByWalletAddress	Get all swap related transactions (buy, sell) for a specific wallet address.
getTokenBondingStatus	Get Token Bonding Status
getTokenHolders	Get the summary of holders for a given token token.
getTokenMetadata	Get Token metadata
getTokenPairs	Get token pairs by address
getTokenPrice	Get token price
getTopHolders	Get paginated top holders for a given token.
getDiscoveryToken	Solana variant: Get token details
getHistoricalTokenScore	Solana variant: Get historical token score by token address
getTimeSeriesVolume	Solana variant: Retrieve timeseries trading stats by chain
getTimeSeriesVolumeByCategory	Solana variant: Retrieve timeseries trading stats by category
getTokenAnalytics	Solana variant: Get token analytics by token address
getTokenScore	Solana variant: Get token score by token address
getTopGainersTokens	Solana variant: Get tokens with top gainers
getTopLosersTokens	Solana variant: Get tokens with top losers
getTrendingTokens	Solana variant: Get trending tokens
getVolumeStatsByCategory	Solana variant: Get trading stats by categories

Solana专属端点（24个原生端点 + 10个支持Solana链的EVM变体端点 = 共34个）。

端点	描述
balance	查询指定地址的原生代币余额
getAggregatedTokenPairStats	通过地址查询聚合的代币交易对统计数据
getBondingTokensByExchange	通过交易所查询绑定代币
getCandleSticks	通过交易对地址查询蜡烛图
getGraduatedTokensByExchange	通过交易所查询已毕业代币
getHistoricalTokenHolders	查询指定代币的时间序列持有者数据
getMultipleTokenMetadata	查询多个代币元数据
getMultipleTokenPrices	查询代币价格
getNFTMetadata	查询指定合约的全局元数据
getNFTs	查询指定地址持有的NFT
getNewTokensByExchange	通过交易所查询新代币
getPairStats	通过交易对地址查询统计数据
getPortfolio	查询指定地址的投资组合
getSPL	查询指定地址持有的代币余额
getSnipersByPairAddress	通过交易对地址查询狙击手
getSwapsByPairAddress	查询所有与swap相关的交易（买入、卖出、添加流动性、移除流动性）
getSwapsByTokenAddress	查询所有与swap相关的交易（买入、卖出）
getSwapsByWalletAddress	查询指定钱包地址的所有与swap相关的交易（买入、卖出）
getTokenBondingStatus	查询代币绑定状态
getTokenHolders	查询指定代币的持有者摘要
getTokenMetadata	查询代币元数据
getTokenPairs	通过地址查询代币交易对
getTokenPrice	查询代币价格
getTopHolders	分页查询指定代币的顶级持有者
getDiscoveryToken	Solana变体：查询代币详情
getHistoricalTokenScore	Solana变体：通过代币地址查询历史代币评分
getTimeSeriesVolume	Solana变体：通过链查询时间序列交易统计数据
getTimeSeriesVolumeByCategory	Solana变体：通过分类查询时间序列交易统计数据
getTokenAnalytics	Solana变体：通过代币地址查询代币分析数据
getTokenScore	Solana变体：通过代币地址查询代币评分
getTopGainersTokens	Solana变体：查询涨幅最高的代币
getTopLosersTokens	Solana变体：查询跌幅最高的代币
getTrendingTokens	Solana变体：查询热门代币
getVolumeStatsByCategory	Solana变体：通过分类查询交易统计数据

Reference Documentation

参考文档

references/CommonPitfalls.md - Complete pitfalls reference
references/DataTransformations.md - Type conversion reference
references/ResponsePatterns.md - Pagination patterns
references/SupportedApisAndChains.md - Chains and APIs

references/CommonPitfalls.md - 完整陷阱参考
references/DataTransformations.md - 类型转换参考
references/ResponsePatterns.md - 分页模式参考
references/SupportedApisAndChains.md - 支持的链和API参考

另请参阅

Endpoint rules:
```
rules/*.md
```
files
Streams API: @moralis-streams-api for real-time events

端点规则：
```
rules/*.md
```
文件
流API：@moralis-streams-api用于实时事件

moralis-data-api

Original

Translation

CRITICAL: Read Rule Files Before Implementing

重要提示：实现前请先阅读规则文件

Setup

配置

API Key (optional)

API密钥（可选）

Environment Variable Discovery

环境变量位置

Verify Your Key

验证密钥

Base URLs

基础URL

Authentication

身份验证

Quick Reference: Most Common Patterns

快速参考：最常用模式

Data Type Rules

数据类型规则

Block Numbers (always decimal)

区块编号（始终为十进制）

Timestamps (usually ISO strings)

时间戳（通常为ISO字符串）

Balances (always strings unless its a property named "formatted" eg. balanceFormatted, BigInt)

余额（除非字段名为"formatted"，如balanceFormatted，否则始终为字符串，需用BigInt处理）

Response Patterns

响应模式

Common Field Mappings

常见字段映射

Common Pitfalls (Top 5)

常见陷阱（前5名）

Pagination

分页

First request

首次请求

Next page

下一页请求

Testing Endpoints

测试端点

Wallet Balance

钱包余额

Token Price

代币价格

Wallet Transactions (note result wrapper)

钱包交易记录（注意结果被包装）

Quick Troubleshooting

快速故障排查

Default Chain Behavior

默认链行为

Supported Chains

支持的链

Endpoint Catalog

端点目录

Wallet

钱包

Token

代币

NFT

NFT

DeFi

DeFi

Entity

实体

Price

价格

Blockchain

区块链

Discovery

发现

Other

其他

Solana Endpoints

Solana端点

Reference Documentation

参考文档

See Also

另请参阅