Moralis

https://docs.moralis.com
Admin
Moralis is a Web3 infrastructure platform providing blockchain data APIs, wallet authentication,...
Tokens:2,040,673
Snippets:9,951
Trust Score:8.5
Update:1 week ago
Show doc for...
Tokens:
Raw
### Go example for GET /history/logs

Source: https://docs.moralis.com/streams/api-reference/history/get-logs

Uses net/http to send a GET request with an x-api-key header. Prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.moralis-streams.com/history/logs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Install ethers and dotenv

Source: https://docs.moralis.com/llms-full.txt

Creates a new project directory, initializes it, and installs the ethers and dotenv packages required for the JSON-RPC example.

```bash
mkdir my-rpc-project
cd my-rpc-project
npm init -y
npm install ethers dotenv
```

--------------------------------

### GET /erc20/metadata

Source: https://docs.moralis.com/llms-full.txt

Migration guide for the ERC-20 token metadata endpoint, showing how to replicate its on-chain core fields using Data Feeds templates. Includes a SQL query example for fetching token metadata with formatted supply and fully diluted valuation.

```APIDOC
## GET /erc20/metadata

### Description
This endpoint provides ERC-20 token metadata including name, symbol, decimals, total supply, and deploy information. The migration guide explains how to replicate the on-chain core fields using Data Feeds templates, with a SQL query example for fetching token metadata with formatted supply and fully diluted valuation.

### Method
GET

### Endpoint
/erc20/metadata

### Parameters
#### Query Parameters
- **addresses** (array of strings) - Required - List of token contract addresses to fetch metadata for. Lowercased addresses, no batch cap.

### Request Example
GET /erc20/metadata?addresses=0x...&addresses=0x...

### Response
#### Success Response (200)
- **address** (string) - Token contract address.
- **name** (string) - Token name.
- **symbol** (string) - Token symbol.
- **decimals** (integer) - Number of decimals.
- **total_supply** (string) - Raw total supply (no decimals applied).
- **total_supply_formatted** (string) - Total supply divided by 10^decimals.
- **block_number** (integer) - Block number of deployment.
- **created_at** (string) - Deployment timestamp (from token_metadata_observations.block_timestamp).
- **fully_diluted_valuation** (number) - Calculated as total_supply_formatted × usd_price via Token Prices template.
- **market_cap** (number) - Requires off-chain circulating supply; not directly available.
- **circulating_supply** (string) - Not available on-chain; add yourself.
- **implementations** (array) - Match across chains or use multichain token list; add yourself.
- **logo**, **logo_hash**, **thumbnail** (string) - Not available on-chain; add yourself.
- **possible_spam**, **verified_contract**, **validated**, **security_score** (boolean/integer) - Not available on-chain; add yourself.
- **categories**, **links**, **description**, **address_label** (string) - Not available on-chain; add yourself.

#### Response Example
{
  "address": "0x...",
  "name": "Example Token",
  "symbol": "EXT",
  "decimals": 18,
  "total_supply": "1000000000000000000000000",
  "total_supply_formatted": "1000000.0",
  "block_number": 12345678,
  "created_at": "2023-01-01T00:00:00Z",
  "fully_diluted_valuation": 1234567.89
}

### SQL Query Example
```sql
SELECT m.token_address AS address,
       m.name, m.symbol, m.decimals,
       m.total_supply,
       m.total_supply / power(10, m.decimals)               AS total_supply_formatted,
       m.total_supply / power(10, m.decimals) * p.usd_price AS fully_diluted_valuation
FROM token_metadata m
LEFT JOIN LATERAL (
  SELECT usd_price FROM token_price_updates
  WHERE token_address = m.token_address ORDER BY block_number DESC LIMIT 1
) p ON true
WHERE m.token_address = ANY($1);   -- lowercased addresses, no batch cap
```

### Notes
- **Not 1:1**: `fully_diluted_valuation` needs a price join; pair with Token Prices template.
- The endpoint's editorial layer (logo, possible_spam, etc.) is off-chain; bring your own token list or drop those fields.
- `market_cap` needs off-chain circulating supply; FDV is the on-chain-derivable alternative.
- Metadata is captured at contract deployment; token only appears if deploy block is indexed.
- `total_supply` is raw and live; tracks mint/burn.
- `created_at` is not on the token_metadata view; read from token_metadata_observations.
- Template is EVM-shaped; SPL token metadata doesn't flow through deployedContracts.
```

--------------------------------

### Set up the project directory and initialize npm

Source: https://docs.moralis.com/get-started/tutorials/data-api/bitcoin/bitcoin-quickstart

Creates a new directory named 'bitcoin-quickstart', changes into it, and initializes a new npm project with default settings. Requires Node.js v18+ and a Moralis API key.

```bash
mkdir bitcoin-quickstart && cd bitcoin-quickstart
npm init -y

```

--------------------------------

### Set Up Project Directory and Initialize npm

Source: https://docs.moralis.com/get-started/tutorials/data-api/prices-and-charts/build-crypto-price-charts-using-ohlc-data

Creates a new directory named crypto-charts, changes into it, and initializes a new npm project with default settings.

```bash
mkdir crypto-charts && cd crypto-charts
npm init -y

```

--------------------------------

### Get Block by ID - API Request Examples

Source: https://docs.moralis.com/data-api/bitcoin/blockchain/block

Example requests for the Get Block by ID endpoint. Replace {chainAlias} with 'bitcoin' or 'bitcoin-mainnet' and {blockIdentifier} with a block height or hash. All requests require the X-Api-Key header.

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.moralis.com/v1/chains/{chainAlias}/blocks/{blockIdentifier}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Api-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.moralis.com/v1/chains/{chainAlias}/blocks/{blockIdentifier}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Api-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

```

```java
HttpResponse<String> response = Unirest.get("https://api.moralis.com/v1/chains/{chainAlias}/blocks/{blockIdentifier}")
  .header("X-Api-Key", "<api-key>")
  .asString();

```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.moralis.com/v1/chains/{chainAlias}/blocks/{blockIdentifier}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

```

--------------------------------

### 200 response example for Get NFT floor price

Source: https://docs.moralis.com/data-api/evm/nft/prices/floor

Example 200 response from the Get NFT floor price endpoint. Shows the floor price in ETH and USD, the marketplace (blur) with its logo, and the last update timestamp.

```json
{
  "address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
  "token_id": "2441",
  "floor_price": "0.2176",
  "floor_price_usd": "564.24",
  "currency": "eth",
  "marketplace": {
    "name": "blur",
    "logo": "https://cdn.moralis.io/marketplaces/blur.png"
  },
  "last_updated": "2024-08-21T15:59:11.000Z"
}
```

--------------------------------

### Initialize project and install dependencies

Source: https://docs.moralis.com/get-started/tutorials/data-api/blocks-and-transactions/find-the-closest-block-by-unix-timestamp

Creates a new directory and initializes a Node.js project with npm.

```bash
mkdir get-block-by-date && cd get-block-by-date
npm init -y

```

--------------------------------

### Project Setup Commands

Source: https://docs.moralis.com/get-started/tutorials/charts-and-widgets/ohlc-chart-configurator

Commands to create a React app, navigate into it, and install required dependencies: lightweight-charts, axios, and react-spinners.

```bash
npx create-react-app crypto-charts
cd crypto-charts
npm install lightweight-charts axios react-spinners

```

--------------------------------

### 200 response example for Get supported DeFi protocols

Source: https://docs.moralis.com/data-api/universal/defi/supported-protocols

Example 200 response from the Get supported DeFi protocols endpoint. Shows the cursor for pagination and a result array with protocol details such as protocolId, protocolName, chains, protocolUrl, and protocolLogo.

```json
{
  "cursor": "eyJhbGciOi...VCaaw",
  "result": [
    {
      "protocolId": "uniswap-v3",
      "protocolName": "Uniswap V3",
      "chains": [
        "0x1",
        "0x89",
        "0xa4b1"
      ],
      "protocolUrl": "https://uniswap.org",
      "protocolLogo": "https://image-gateway.moralis.io/defi/db/logo.png"
    }
  ]
}
```

--------------------------------

### Example response for Get decoded transactions by wallet

Source: https://docs.moralis.com/data-api/evm/wallet/decoded-transactions

Example response from the Get decoded transactions by wallet endpoint. Shows a decoded transfer call and a Transfer event with decoded parameters, plus entity labels and pagination fields.

```json
{
  "result": [
    {
      "hash": "0x1ed85b3757a6d31d01a4d6677fc52fd3911d649a0af21fe5ca3f886b153773ed",
      "nonce": "1848059",
      "transaction_index": "108",
      "from_address": "0x267be1c1d684f78cb4f6a176c4911b741e4ffdc0",
      "value": "115580000000000000",
      "gas_price": "52500000000",
      "input": "0x",
      "receipt_cumulative_gas_used": "4923073",
      "receipt_gas_used": "21000",
      "receipt_status": "1",
      "transaction_fee": "0.00034",
      "block_timestamp": "2021-05-07T11:08:35.000Z",
      "block_number": "12386788",
      "block_hash": "0x9b559aef7ea858608c2e554246fe4a24287e7aeeb976848df2b9a2531f4b9171",
      "logs": [
        {
          "log_index": "273",
          "transaction_hash": "0xdd9006489e46670e0e85d1fb88823099e7f596b08aeaac023e9da0851f26fdd5",
          "transaction_index": "204",
          "address": "0x3105d328c66d8d55092358cf595d54608178e9b5",
          "data": "0x00000000000000000000000000000000000000000000000de05239bccd4d537400000000000000000000000000024dbc80a9f80e3d5fc0a0ee30e2693781a443",
          "topic0": "0x2caecd17d02f56fa897705dcc740da2d237c373f70686f4e0d9bd3bf0400ea7a",
          "block_timestamp": "2021-05-07T11:08:35.000Z",
          "block_number": "12386788",
          "block_hash": "0x9b559aef7ea858608c2e554246fe4a24287e7aeeb976848df2b9a2531f4b9171",
          "decoded_event": {
            "signature": "Transfer(address,address,uint256)",
            "label": "Transfer",
            "type": "event",
            "params": [
              {
                "name": "from",
                "value": "0x26C5011483Add49801eA8E3Ee354fE013895aCe5",
                "type": "address"
              }
            ]
          },
          "topic1": "0x000000000000000000000000031002d15b0d0cd7c9129d6f644446368deae391",
          "topic2": "0x000000000000000000000000d25943be09f968ba740e0782a34e710100defae9",
          "topic3": null
        }
      ],
      "decoded_call": {
        "signature": "transfer(address,uint256)",
        "label": "transfer",
        "type": "function",
        "params": [
          {
            "name": "_to",
            "value": "0x1CA455A55108874A95C84620dDA2566c54D17953",
            "type": "address"
          }
        ]
      },
      "from_address_entity": "Opensea",
      "from_address_entity_logo": "https://opensea.io/favicon.ico",
      "from_address_label": "Binance 1",
      "to_address_entity": "Beaver Build",
      "to_address_entity_logo": "https://beaverbuild.com/favicon.ico",
      "to_address": "0x003dde3494f30d861d063232c6a8c04394b686ff",
      "to_address_label": "Binance 2",
      "gas": "30000",
      "receipt_contract_address": null,
      "receipt_root": null
    }
  ],
  "cursor": "<string>",
  "page": "2",
  "page_size": "100"
}
```

--------------------------------

### Set Up Project Directory and Initialize with npm init -y

Source: https://docs.moralis.com/get-started/tutorials/data-api/tokens-and-markets/get-erc-20-token-balances-for-a-wallet

Initializes a new Node.js project in a dedicated directory named get-token-balances, creating a package.json file with default settings via npm init -y.

```bash
mkdir get-token-balances && cd get-token-balances
npm init -y

```

--------------------------------

### Set Up Project Directory

Source: https://docs.moralis.com/llms-full.txt

Initializes a new Node.js project in a directory named crypto-charts. Requires Node.js v18+ and a Moralis API key.

```bash
mkdir crypto-charts && cd crypto-charts
npm init -y
```

--------------------------------

### Ruby example for GET /history/logs

Source: https://docs.moralis.com/streams/api-reference/history/get-logs

Uses net/http to send a GET request with an x-api-key header. Prints the response body.

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.moralis-streams.com/history/logs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body
```

--------------------------------

### Initialize project

Source: https://docs.moralis.com/get-started/tutorials/data-api/nfts/get-nft-floor-prices

Creates a new directory and initializes a Node.js project with npm.

```bash
mkdir get-nft-floor-price && cd get-nft-floor-price
npm init -y

```

--------------------------------

### Example 200 response for get active chains

Source: https://docs.moralis.com/data-api/evm/wallet/chain-activity

Example 200 response for the GET /wallets/{address}/chains endpoint. It includes the wallet address and an array of active chains, each with the chain name, chain ID, and the first and last transaction details.

```json
{
  "address": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
  "active_chains": [
    {
      "chain": "eth",
      "chain_id": "0x1",
      "first_transaction": {
        "block_number": "123456789",
        "block_timestamp": "2022-08-23T20:58:31.000Z",
        "transaction_hash": "0x2d30ca6f024dbc1307ac8a1a44ca27de6f797ec22ef20627a1307243b0ab7d09"
      },
      "last_transaction": {
        "block_number": "123456789",
        "block_timestamp": "2022-08-23T20:58:31.000Z",
        "transaction_hash": "0x2d30ca6f024dbc1307ac8a1a44ca27de6f797ec22ef20627a1307243b0ab7d09"
      }
    }
  ]
}
```

--------------------------------

### Go example for token holder summary

Source: https://docs.moralis.com/data-api/evm/token/holders/token-holder-stats

Go example using net/http to fetch token holder summary. Replace {tokenAddress} and set your API key. Prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://deep-index.moralis.io/api/v2.2/erc20/{tokenAddress}/holders?chain=eth"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "test")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Go example

Source: https://docs.moralis.com/streams/api-reference/bitcoin/xpub/get-xpubs

Go example using net/http to fetch XPUBs. Requires an API key and replaces {id} with the stream ID.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.moralis-streams.com/streams/bitcoin/{id}/xpub"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### JavaScript fetch example

Source: https://docs.moralis.com/streams/api-reference/bitcoin/xpub/get-xpubs

JavaScript example using fetch to get XPUBs. Replace {id} and <api-key> with your stream ID and API key.

```javascript
const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.moralis-streams.com/streams/bitcoin/{id}/xpub', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

--------------------------------

### Set Up Node.js Project (bash)

Source: https://docs.moralis.com/get-started/tutorials/data-api/tokens-and-markets/build-a-dex-screener-clone

Commands to create and initialize a new Node.js project directory for the DEX token screener. Run in a terminal before adding the JavaScript code.

```bash
mkdir dex-screener && cd dex-screener
npm init -y

```

--------------------------------

### Java Unirest example for GET /history/logs

Source: https://docs.moralis.com/streams/api-reference/history/get-logs

Uses the Unirest library to make a GET request with an x-api-key header. Returns the response as a string.

```java
HttpResponse<String> response = Unirest.get("https://api.moralis-streams.com/history/logs")
  .header("x-api-key", "<api-key>")
  .asString();
```

--------------------------------

### Go request to get DeFi positions

Source: https://docs.moralis.com/data-api/evm/defi/wallet-positions

Go example using net/http to send a GET request. It reads the response body and prints it.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.moralis.com/v1/wallets/{walletAddress}/defi/positions?limit=25"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Api-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Example .env file

Source: https://docs.moralis.com/get-started/tutorials/auth-api/authenticate-users-with-meta-mask-using-angular

Shows the required environment variables for the server.

```plaintext
APP_DOMAIN=localhost
MORALIS_API_KEY=xxxx
ANGULAR_URL=http://localhost:4200
AUTH_SECRET=1234

```

--------------------------------

### Go example

Source: https://docs.moralis.com/data-api/evm/token/signals/top-traders

Go example using net/http to call the top-gainers endpoint. Replace {address} and set your API key.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://deep-index.moralis.io/api/v2.2/erc20/{address}/top-gainers?chain=eth"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "test")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Example response for Get multiple token metadata

Source: https://docs.moralis.com/data-api/solana/token/token-metadata-batch

Example response body for the Get multiple token metadata endpoint. Shows the fields returned for each token, including mint, standard, name, symbol, decimals, tokenStandard, totalSupply, marketCap, metaplex details, and spam indicators.

```json
[
  {
    "mint": "<string>",
    "standard": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "logo": "<string>",
    "decimals": "<string>",
    "tokenStandard": 123,
    "score": 123,
    "totalSupply": "<string>",
    "totalSupplyFormatted": "<string>",
    "fullyDilutedValue": "<string>",
    "marketCap": "<string>",
    "circulatingSupply": "<string>",
    "metaplex": {
      "metadataUri": "<string>",
      "masterEdition": true,
      "isMutable": true,
      "primarySaleHappened": 123,
      "sellerFeeBasisPoints": 123,
      "updateAuthority": "<string>"
    },
    "links": {},
    "description": "<string>",
    "isVerifiedContract": true,
    "possibleSpam": true
  }
]
```

--------------------------------

### Go example for Bitcoin transaction

Source: https://docs.moralis.com/data-api/bitcoin/blockchain/transaction

Go example using net/http to GET a Bitcoin transaction. Adds the X-Api-Key header and prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.moralis.com/v1/chains/{chainAlias}/transactions/{txHash}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Api-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Go example for token categories

Source: https://docs.moralis.com/data-api/evm/token/discovery/token-categories

Go example using net/http to fetch token categories. Requires an X-API-Key header. Prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://deep-index.moralis.io/api/v2.2/tokens/categories"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "test")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Go example to get a specific EVM stream

Source: https://docs.moralis.com/streams/api-reference/streams/get-stream-by-id

Uses the net/http package to send a GET request with an x-api-key header and prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.moralis-streams.com/streams/evm/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Ruby example for get stats by stream ID

Source: https://docs.moralis.com/streams/api-reference/stats/get-stats-by-stream

Uses Net::HTTP to send a GET request with an x-api-key header. Prints the response body.

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.moralis-streams.com/stats/{streamId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body
```
Tokens:
Raw