Search Entities Mainnet Only Premium Endpoint

💡Premium Endpoint

To use this API, you will need an API key associated with a Moralis account on the Pro plan or higher.

GEThttps://deep-index.moralis.io/api/v2.2/entities/search

Search for entities, addresses and categories

QUERY PARAMS

querystringrequired

The search query

limitnumber

The desired page size of the result.

Responses

200Returns the search results.

400Bad Request

404Not Found

429Too Many Requests

500Internal Server Error

API KEY

cURL

curl --request GET \
     --url 'https://deep-index.moralis.io/api/v2.2/entities/search?query=uniswap&limit=25' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' 

Node.js

// Node.js v18+ has native fetch support
// No additional dependencies required

const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
};

fetch('https://deep-index.moralis.io/api/v2.2/entities/search?query=uniswap&limit=25', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Python

# Dependencies to install:
# $ python -m pip install requests

import requests

url = "https://deep-index.moralis.io/api/v2.2/entities/search?query=uniswap&limit=25"

headers = {
  "Accept": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

Go

package main

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

func main() {

  url := "https://deep-index.moralis.io/api/v2.2/entities/search?query=uniswap&limit=25"

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

  req.Header.Add("Accept", "application/json")
  req.Header.Add("X-API-Key", "YOUR_API_KEY")

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

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

  fmt.Println(res)
  fmt.Println(string(body))

}

PHP

<?php
// Dependencies to install:
// $ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://deep-index.moralis.io/api/v2.2/entities/search?query=uniswap&limit=25', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

200 Returns the search results.

{
  "page": 1,
  "page_size": 100,
  "result": [
    {
      "entities": [
        {
          "name": "Uniswap",
          "id": "uniswap",
          "logo": "https://uniswap.io/favicon.ico",
          "bio": "Uniswap is a decentralized finance protocol that is used to exchange cryptocurrencies.",
          "description": "Uniswap is a decentralized finance protocol that is used to exchange cryptocurrencies.",
          "website": "https://uniswap.io",
          "twitter": "https://twitter.com/uniswap",
          "type": "exchange"
        }
      ],
      "addresses": [
        {
          "address": "0x54f1acac26b10cdffc8a43904713aa0ad67a33f9",
          "chain": "0x1",
          "is_multi_chain": "false",
          "primary_label": "Uniswap: V3 Pool",
          "entity": [
            {
              "name": "Uniswap",
              "id": "uniswap"
            }
          ]
        }
      ]
    }
  ]
}