Getting started with Mnemonic

Integrating your product with Mnemonic is so easy, it shouldn't take more than 10 minutes.

Get an API key

Mnemonic is currently in beta, in order to sign up and get access please follow instructions on this page. We want to hear from you about your project and how Mnemonic can help you reach your goals.

Once signed up you will receive your API key, which you can use to start sending requests and building your application.

See examples of how to use your API key to start making requests.

Make first request

The simplest way to start interacting with Mnemonic APIs is using REST protocol or even your favourite command-line.

Here is an example you can run from your terminal to retrieve NFTs owned by the specified wallet address:

Using REST

curlpython
Copy
Copied
$ curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/tokens/v1beta1/by_owner/0xBA19BA5233b49794c33f01654e99A60E579E6f29?limit=5' \
  -H 'X-API-Key: <API KEY>'
Copy
Copied
import requests # requires `pip install requests`

result = requests.get(
    'https://ethereum.rest.mnemonichq.com/tokens/v1beta1/by_owner/0xBA19BA5233b49794c33f01654e99A60E579E6f29?limit=5',
    headers={'x-api-key': 'YOUR_API_KEY_HERE'}
).json()

Using gRPC / Protobuf

The easiest way to test gRPC/Protobuf APIs is to use grpcurl command.

Make sure you checked out the latest Protobuf definitions for Mnemonic APIs from our public Buf repository.

Result

Copy
Copied
{
    "tokens": [
        {
            "contractAddress": "0x049aba7510f45ba5b64ea9e658e342f904db358d",
            "tokenId": "64268186300517518774359924364521286346181336600402047053325184828879466641056",
            "type": "TOKEN_TYPE_ERC721",
            "metadataUri": {
                "uri": "https://metadata.unstoppabledomains.com/metadata/64268186300517518774359924364521286346181336600402047053325184828879466641056",
                "mimeType": "application/json"
            },
            "name": "modernfinance.wallet",
            "description": "A CNS or UNS blockchain domain. Use it to resolve your cryptocurrency addresses and decentralized websites.",
            "image": {
                "uri": "https://storage.googleapis.com/dot-crypto-metadata-api/images/unstoppabledomains.svg",
                "mimeType": "image/svg+xml"
            },
            "quantity": "1"
        },
        {
            "contractAddress": "0x059edd72cd353df5106d2b9cc5ab83a52287ac3a",
            "tokenId": "2205",
            "type": "TOKEN_TYPE_ERC721",
            "metadataUri": {
                "uri": "https://api.artblocks.io/token/2205",
                "mimeType": "application/json"
            },
            "name": "Chromie Squiggle #2205",
            "description": "Simple and easily identifiable, each squiggle embodies the soul of the Art Blocks platform. Consider each my personal signature as an artist, developer, and tinkerer. Public minting of the Chromie Squiggle is permanently paused. They are now reserved for manual distribution to collectors and community members over a longer period of time. Please visit OpenSea to explore Squiggles available on the secondary market. ",
            "image": {
                "uri": "https://media.artblocks.io/2205.png",
            },
            "quantity": "1"
        },
        {
            "contractAddress": "0x059edd72cd353df5106d2b9cc5ab83a52287ac3a",
            "tokenId": "4429",
            "type": "TOKEN_TYPE_ERC721",
            "metadataUri": {
                "uri": "https://api.artblocks.io/token/4429",
                "mimeType": "application/json"
            },
            "name": "Chromie Squiggle #4429",
            "description": "Simple and easily identifiable, each squiggle embodies the soul of the Art Blocks platform. Consider each my personal signature as an artist, developer, and tinkerer. Public minting of the Chromie Squiggle is permanently paused. They are now reserved for manual distribution to collectors and community members over a longer period of time. Please visit OpenSea to explore Squiggles available on the secondary market. ",
            "image": {
                "uri": "https://media.artblocks.io/4429.png",
            },
            "quantity": "1"
        },
        {
            "contractAddress": "0x059edd72cd353df5106d2b9cc5ab83a52287ac3a",
            "tokenId": "4463",
            "type": "TOKEN_TYPE_ERC721",
            "metadataUri": {
                "uri": "https://api.artblocks.io/token/4463",
                "mimeType": "application/json"
            },
            "name": "Chromie Squiggle #4463",
            "description": "Simple and easily identifiable, each squiggle embodies the soul of the Art Blocks platform. Consider each my personal signature as an artist, developer, and tinkerer. Public minting of the Chromie Squiggle is permanently paused. They are now reserved for manual distribution to collectors and community members over a longer period of time. Please visit OpenSea to explore Squiggles available on the secondary market. ",
            "image": {
                "uri": "https://media.artblocks.io/4463.png",
            },
            "quantity": "1"
        },
        {
            "contractAddress": "0x059edd72cd353df5106d2b9cc5ab83a52287ac3a",
            "tokenId": "5195",
            "type": "TOKEN_TYPE_ERC721",
            "metadataUri": {
                "uri": "https://api.artblocks.io/token/5195",
                "mimeType": "application/json"
            },
            "name": "Chromie Squiggle #5195",
            "description": "Simple and easily identifiable, each squiggle embodies the soul of the Art Blocks platform. Consider each my personal signature as an artist, developer, and tinkerer. Public minting of the Chromie Squiggle is permanently paused. They are now reserved for manual distribution to collectors and community members over a longer period of time. Please visit OpenSea to explore Squiggles available on the secondary market.",
            "image": {
                "uri": "https://media.artblocks.io/5195.png",
            },
            "quantity": "1"
        }
    ]
}

Nest steps

There's a lot you can build with Mnemonic API as well: you can obtain fresh pricing information about any collection, surface mooning collections by looking at top collections by volume, find out who the current owners, and much more!