Authentication

ApiKeyAuth

Security Scheme Type API Key
Header parameter name: X-API-Key

Collections

DEPRECATED. Please follow the guide for migration to the new Uniform API. CollectionsService provides the ability to get collection and owners statistics.

List of current owners by contractDeprecated

Get the list of current owner addresses by contract address.

Request
Security:
ApiKeyAuth
path Parameters
contractAddress
required
string

Contract address (or ENS name) that tracks NFTs.

query Parameters
limit
string <uint64>

How many rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

sortDirection
string

Sort direction (sort key = owned_count, default = descending).

Enum: "SORT_DIRECTION_ASC" "SORT_DIRECTION_DESC"
Responses
200

A successful response.

get/collections/v1beta1/current_owners/{contractAddress}
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/collections/v1beta1/current_owners/:contractAddress?limit=string&offset=string&sortDirection=SORT_DIRECTION_ASC' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "owner": [
    • {
      • "address": "string",
      • "ownedCount": "string"
      }
    ]
}

Owners count by contractDeprecated

Get owners count by contract address.

Request
Security:
ApiKeyAuth
path Parameters
contractAddress
required
string

Contract address (or ENS Name) that tracks NFTs.

query Parameters
duration
required
string

Time duration for the analysis.

  • DURATION_UNSPECIFIED: Unspecified value.
  • DURATION_1_DAY: 1 day.
  • DURATION_7_DAYS: 7 days.
  • DURATION_30_DAYS: 30 days.
  • DURATION_365_DAYS: 365 days.
Enum: "DURATION_1_DAY" "DURATION_7_DAYS" "DURATION_30_DAYS" "DURATION_365_DAYS"
timestampLt
string <date-time>

Final timestamp for the analysis.

Default is today at 00:00:00. Final timestamp is excluded from the result date, while start timestamp is included.

groupByPeriod
required
string

Aggregation period for the analysis.

Depending on the requested duration following minimal values are allowed:

  • duration = 1 day, minimum allowed value is 15 minutes;

  • duration = 7 days, minimum allowed value is 1 hour;

  • duration = 30 days, minimum allowed value is 1 day;

  • duration = 365 days, minimum allowed value is 1 day.

  • GROUP_BY_PERIOD_UNSPECIFIED: Undefined value.

  • GROUP_BY_PERIOD_15_MINUTES: 15 minutes.

  • GROUP_BY_PERIOD_1_HOUR: 1 hour.

  • GROUP_BY_PERIOD_1_DAY: 1 day.

Enum: "GROUP_BY_PERIOD_15_MINUTES" "GROUP_BY_PERIOD_1_HOUR" "GROUP_BY_PERIOD_1_DAY"
Responses
200

A successful response.

get/collections/v1beta1/owners_count/{contractAddress}
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/collections/v1beta1/owners_count/:contractAddress?duration=DURATION_1_DAY&timestampLt=2019-08-24T14%3A15%3A22Z&groupByPeriod=GROUP_BY_PERIOD_15_MINUTES' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "dataPoints": [
    • {
      • "timestamp": "2019-08-24T14:15:22Z",
      • "count": "string"
      }
    ]
}

Tokens supply by contractDeprecated

Get tokens supply summary by a contract address.

Request
Security:
ApiKeyAuth
path Parameters
contractAddress
required
string

Contract address (or ENS name) that tracks NFTs.

query Parameters
duration
required
string

Time duration for the analysis.

  • DURATION_UNSPECIFIED: Unspecified value.
  • DURATION_1_DAY: 1 day.
  • DURATION_7_DAYS: 7 days.
  • DURATION_30_DAYS: 30 days.
  • DURATION_365_DAYS: 365 days.
Enum: "DURATION_1_DAY" "DURATION_7_DAYS" "DURATION_30_DAYS" "DURATION_365_DAYS"
timestampLt
string <date-time>

Final timestamp for the analysis.

Default is today at 00:00:00. Final timestamp is excluded from the result date, while start timestamp is included.

groupByPeriod
required
string

Aggregation period for the analysis.

Depending on the requested duration following minimal values are allowed:

  • duration = 1 day, minimum allowed value is 15 minutes;

  • duration = 7 days, minimum allowed value is 1 hour;

  • duration = 30 days, minimum allowed value is 1 day;

  • duration = 365 days, minimum allowed value is 1 day.

  • GROUP_BY_PERIOD_UNSPECIFIED: Undefined value.

  • GROUP_BY_PERIOD_15_MINUTES: 15 minutes.

  • GROUP_BY_PERIOD_1_HOUR: 1 hour.

  • GROUP_BY_PERIOD_1_DAY: 1 day.

Enum: "GROUP_BY_PERIOD_15_MINUTES" "GROUP_BY_PERIOD_1_HOUR" "GROUP_BY_PERIOD_1_DAY"
Responses
200

A successful response.

get/collections/v1beta1/supply/{contractAddress}
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/collections/v1beta1/supply/:contractAddress?duration=DURATION_1_DAY&timestampLt=2019-08-24T14%3A15%3A22Z&groupByPeriod=GROUP_BY_PERIOD_15_MINUTES' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "dataPoints": [
    • {
      • "timestamp": "2019-08-24T14:15:22Z",
      • "minted": "string",
      • "burned": "string",
      • "totalMinted": "string",
      • "totalBurned": "string"
      }
    ]
}

Top collections by avg priceDeprecated

Get top collections by average price.

Request
Security:
ApiKeyAuth
query Parameters
limit
string <uint64>

How many rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

duration
required
string

Time duration for the analysis.

  • DURATION_UNSPECIFIED: Unspecified value.
  • DURATION_1_DAY: 1 day.
  • DURATION_7_DAYS: 7 days.
  • DURATION_30_DAYS: 30 days.
  • DURATION_365_DAYS: 365 days.
Enum: "DURATION_1_DAY" "DURATION_7_DAYS" "DURATION_30_DAYS" "DURATION_365_DAYS"
Responses
200

A successful response.

get/collections/v1beta1/top/by_avg_price
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/collections/v1beta1/top/by_avg_price?limit=string&offset=string&duration=DURATION_1_DAY' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "collections": [
    • {
      • "contractAddress": "string",
      • "avgPrice": "string",
      • "contractName": "string"
      }
    ]
}

Top collections by max priceDeprecated

Get top collections by maximum price.

Request
Security:
ApiKeyAuth
query Parameters
limit
string <uint64>

How many rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

duration
required
string

Time duration for the analysis.

  • DURATION_UNSPECIFIED: Unspecified value.
  • DURATION_1_DAY: 1 day.
  • DURATION_7_DAYS: 7 days.
  • DURATION_30_DAYS: 30 days.
  • DURATION_365_DAYS: 365 days.
Enum: "DURATION_1_DAY" "DURATION_7_DAYS" "DURATION_30_DAYS" "DURATION_365_DAYS"
Responses
200

A successful response.

get/collections/v1beta1/top/by_max_price
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/collections/v1beta1/top/by_max_price?limit=string&offset=string&duration=DURATION_1_DAY' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "collections": [
    • {
      • "contractAddress": "string",
      • "maxPrice": "string",
      • "contractName": "string"
      }
    ]
}

Top collections by sales countDeprecated

Get top collections by sales count.

Request
Security:
ApiKeyAuth
query Parameters
limit
string <uint64>

How many rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

duration
required
string

Time duration for the analysis.

  • DURATION_UNSPECIFIED: Unspecified value.
  • DURATION_1_DAY: 1 day.
  • DURATION_7_DAYS: 7 days.
  • DURATION_30_DAYS: 30 days.
  • DURATION_365_DAYS: 365 days.
Enum: "DURATION_1_DAY" "DURATION_7_DAYS" "DURATION_30_DAYS" "DURATION_365_DAYS"
Responses
200

A successful response.

get/collections/v1beta1/top/by_sales_count
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/collections/v1beta1/top/by_sales_count?limit=string&offset=string&duration=DURATION_1_DAY' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "collections": [
    • {
      • "contractAddress": "string",
      • "salesCount": "string",
      • "contractName": "string"
      }
    ]
}

Top collections by sales volumeDeprecated

Get top collections by sales volume.

Request
Security:
ApiKeyAuth
query Parameters
limit
string <uint64>

How many rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

duration
required
string

Time duration for the analysis.

  • DURATION_UNSPECIFIED: Unspecified value.
  • DURATION_1_DAY: 1 day.
  • DURATION_7_DAYS: 7 days.
  • DURATION_30_DAYS: 30 days.
  • DURATION_365_DAYS: 365 days.
Enum: "DURATION_1_DAY" "DURATION_7_DAYS" "DURATION_30_DAYS" "DURATION_365_DAYS"
Responses
200

A successful response.

get/collections/v1beta1/top/by_sales_volume
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/collections/v1beta1/top/by_sales_volume?limit=string&offset=string&duration=DURATION_1_DAY' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "collections": [
    • {
      • "contractAddress": "string",
      • "salesVolume": "string",
      • "contractName": "string"
      }
    ]
}

Traits SummaryDeprecated

Get aggregated traits information for a collection.

Request
Security:
ApiKeyAuth
path Parameters
contractAddress
required
string

Contract address of the collection.

query Parameters
limit
string <uint64>

How many rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

Responses
200

A successful response.

get/collections/v1beta1/traits/{contractAddress}/summary
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/collections/v1beta1/traits/:contractAddress/summary?limit=string&offset=string' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "traitSummaries": [
    • {
      • "name": "string",
      • "displayType": "DISPLAY_TYPE_PROPERTY",
      • "valueType": "VALUE_TYPE_NUMERIC",
      • "valueNumeric": {
        • "min": 0,
        • "max": 0
        },
      • "valueString": {
        • "value": "string",
        • "tokenCount": "string",
        • "traitPercentage": 0
        },
      • "valueDate": {
        • "min": "2019-08-24T14:15:22Z",
        • "max": "2019-08-24T14:15:22Z"
        }
      }
    ]
}

Contracts

DEPRECATED. Please follow the guide for migration to the new Uniform API. ContractsService provides the ability to get details about smart contracts.

All ContractsDeprecated

Returns a list of contracts ordered by the block mint timestamp.

Request
Security:
ApiKeyAuth
query Parameters
limit
string <uint64>

Quantity of rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

sortDirection
string

Sort direction (sort key = timestamp, default = ascending).

Enum: "SORT_DIRECTION_ASC" "SORT_DIRECTION_DESC"
blockTimestampGt
string <date-time>

Filter by minimal block timestamp, using "greater" comparison. This filter exludes contracts matching given block timestamp exactly. Useful to get updates only.

contractTypes
Array of strings

Filter by contract types.

  • TOKEN_TYPE_UNSPECIFIED: Unset is a system value (shouldn't be present in real data).
  • TOKEN_TYPE_UNKNOWN: Unknown represents undetected contract type.
  • TOKEN_TYPE_ERC20: ERC20 type (fungible tokens).
  • TOKEN_TYPE_ERC721: ERC721 type.
  • TOKEN_TYPE_ERC1155: ERC1155 type.
  • TOKEN_TYPE_ERC721_LEGACY: ERC721 legacy type.
  • TOKEN_TYPE_CRYPTOPUNKS: Cryptopunks contract type.
Items Enum: "TOKEN_TYPE_UNKNOWN" "TOKEN_TYPE_ERC20" "TOKEN_TYPE_ERC721" "TOKEN_TYPE_ERC1155" "TOKEN_TYPE_ERC721_LEGACY" "TOKEN_TYPE_CRYPTOPUNKS"
Responses
200

A successful response.

get/contracts/v1beta1/all
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/contracts/v1beta1/all?limit=string&offset=string&sortDirection=SORT_DIRECTION_ASC&blockTimestampGt=2019-08-24T14%3A15%3A22Z&contractTypes=TOKEN_TYPE_UNKNOWN' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "contracts": [
    • {
      • "type": "TOKEN_TYPE_UNKNOWN",
      • "mintEvent": {
        • "blockTimestamp": "2019-08-24T14:15:22Z",
        • "txHash": "string",
        • "minterAddress": "string"
        },
      • "name": "string",
      • "symbol": "string",
      • "decimals": 0,
      • "address": "string",
      • "types": [
        • "TOKEN_TYPE_UNKNOWN"
        ]
      }
    ]
}

Contract DetailsDeprecated

Returns full details about the given smart contract, including the decoded type and metadata, if defined by the contract.

Request
Security:
ApiKeyAuth
path Parameters
contractAddress
required
string

Contract address (or ENS name).

Responses
200

A successful response.

get/contracts/v1beta1/by_address/{contractAddress}
Request samples
curl -i -X GET \
  https://ethereum.rest.mnemonichq.com/contracts/v1beta1/by_address/:contractAddress \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "contract": {
    • "type": "TOKEN_TYPE_UNKNOWN",
    • "mintEvent": {
      • "blockTimestamp": "2019-08-24T14:15:22Z",
      • "txHash": "string",
      • "minterAddress": "string"
      },
    • "name": "string",
    • "symbol": "string",
    • "decimals": 0,
    • "address": "string",
    • "types": [
      • "TOKEN_TYPE_UNKNOWN"
      ]
    }
}

NFT Contract MetadataDeprecated

Returns collection level information (counts, total volumes), and collection metadata from on-chain and off-chain sources.

Request
Security:
ApiKeyAuth
path Parameters
contractAddress
required
string

Contract address (or ENS name).

Responses
200

A successful response.

get/contracts/v1beta1/nft/metadata/{contractAddress}
Request samples
curl -i -X GET \
  https://ethereum.rest.mnemonichq.com/contracts/v1beta1/nft/metadata/:contractAddress \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "types": [
    • "TOKEN_TYPE_UNKNOWN"
    ],
  • "name": "string",
  • "tokensCount": "string",
  • "ownersCount": "string",
  • "salesVolume": "string",
  • "metadata": [
    • {
      • "type": "TYPE_BANNER_IMAGE_URL",
      • "value": "string"
      }
    ]
}

ENS

DEPRECATED. Please follow the guide for migration to the new Uniform API. EnsService provides the ability to query ENS Names to wallet address mappings and vice-versa.

Entity by addressDeprecated

Returns the current ENS entity(s) corresponding to a given Ethereum address, if it exists.

Request
Security:
ApiKeyAuth
path Parameters
address
required
string

An Ethereum address.

Responses
200

A successful response.

get/ens/v1beta1/entity/by_address/{address}
Request samples
curl -i -X GET \
  https://ethereum.rest.mnemonichq.com/ens/v1beta1/entity/by_address/:address \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "entities": [
    • {
      • "name": "string",
      • "resolvedAddress": "string",
      • "validFromTimestamp": "2019-08-24T14:15:22Z",
      • "validTillTimestamp": "2019-08-24T14:15:22Z",
      • "parentName": "string",
      • "matchesReverseRecord": true
      }
    ]
}

Entity by nameDeprecated

Returns the current ENS entity corresponding to a given ENS Name, if it exists.

Request
Security:
ApiKeyAuth
path Parameters
name
required
string

An ENS name.

Responses
200

A successful response.

get/ens/v1beta1/entity/by_name/{name}
Request samples
curl -i -X GET \
  https://ethereum.rest.mnemonichq.com/ens/v1beta1/entity/by_name/:name \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "entity": {
    • "name": "string",
    • "resolvedAddress": "string",
    • "validFromTimestamp": "2019-08-24T14:15:22Z",
    • "validTillTimestamp": "2019-08-24T14:15:22Z",
    • "parentName": "string",
    • "matchesReverseRecord": true
    }
}

Historical Entities by AddressDeprecated

Returns all of the historical ENS entities corresponding to a given Ethereum address.

Request
Security:
ApiKeyAuth
path Parameters
address
required
string

An Ethereum address.

Responses
200

A successful response.

get/ens/v1beta1/historical/entity/by_address/{address}
Request samples
curl -i -X GET \
  https://ethereum.rest.mnemonichq.com/ens/v1beta1/historical/entity/by_address/:address \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "entities": [
    • {
      • "name": "string",
      • "resolvedAddress": "string",
      • "validFromTimestamp": "2019-08-24T14:15:22Z",
      • "validTillTimestamp": "2019-08-24T14:15:22Z"
      }
    ]
}

Historical Entities by nameDeprecated

Returns all of the historical ENS entities corresponding to a given ENS Name.

Request
Security:
ApiKeyAuth
path Parameters
name
required
string

An ENS name.

Responses
200

A successful response.

get/ens/v1beta1/historical/entity/by_name/{name}
Request samples
curl -i -X GET \
  https://ethereum.rest.mnemonichq.com/ens/v1beta1/historical/entity/by_name/:name \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "entities": [
    • {
      • "name": "string",
      • "resolvedAddress": "string",
      • "validFromTimestamp": "2019-08-24T14:15:22Z",
      • "validTillTimestamp": "2019-08-24T14:15:22Z"
      }
    ]
}

Marketplaces

DEPRECATED. Please follow the guide for migration to the new Uniform API. MarketplaceService provides the ability to get marketplace activity about NFTs from different marketplaces.

Collection/NFT FloorDeprecated

Get the current floor price of a collection/NFT.

Request
Security:
ApiKeyAuth
path Parameters
contractAddress
required
string

Contract Address (Or ENS Name) of the collection.

query Parameters
tokenId
string

Token ID (Optional).

marketplaceId
string

Filter to a specific marketplace (Optional).

  • MARKETPLACE_ID_UNSPECIFIED: Unspecified, also is a default value.
  • MARKETPLACE_ID_OPENSEA: OpenSea Marketplace.
  • MARKETPLACE_ID_LOOKSRARE: LooksRare Marketaplce.
  • MARKETPLACE_ID_CRYPTOPUNKS: CryptoPunks marketplace.
  • MARKETPLACE_ID_SUPERRARE: SupeRare Marketplace.
Enum: "MARKETPLACE_ID_OPENSEA" "MARKETPLACE_ID_LOOKSRARE" "MARKETPLACE_ID_CRYPTOPUNKS" "MARKETPLACE_ID_SUPERRARE"
Responses
200

A successful response.

get/ethereum/marketplaces/v1beta1/floors/{contractAddress}
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/ethereum/marketplaces/v1beta1/floors/:contractAddress?tokenId=string&marketplaceId=MARKETPLACE_ID_OPENSEA' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "price": {
    • "totalNative": "string",
    • "totalUsd": "string",
    • "erc20Address": "string",
    • "erc20Value": "string"
    }
}

NFT listingsDeprecated

Get a list of active NFT listings across multiple marketplaces.

Request
Security:
ApiKeyAuth
query Parameters
limit
string <uint64>

Quantity of rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

sortBy
string

Sort criteria/key (default = sort by creation timestamp).

  • SORT_BY_UNSPECIFIED: Unspecified, also is a default value.
  • SORT_BY_CREATION_TIMESTAMP: Sort by the creation timestamp.
  • SORT_BY_START_TIMESTAMP: Sort by the start timestamp.
  • SORT_BY_EXPIRATION_TIMESTAMP: Sort by the expiration timestamp.
  • SORT_BY_PRICE: Sort by the price
Enum: "SORT_BY_CREATION_TIMESTAMP" "SORT_BY_START_TIMESTAMP" "SORT_BY_EXPIRATION_TIMESTAMP" "SORT_BY_PRICE"
sortDirection
string

Sort direction (sort key, default = ascending).

Enum: "SORT_DIRECTION_ASC" "SORT_DIRECTION_DESC"
creationTimestampGt
string <date-time>

Filter by minimal listing creation timestamp, useful to get updates since last known listing. The filter uses "greater" comparison and excludes listings with given timestamp, this allows getting only new listings.

listingType
string

Filter by the type of the listing (default = any type).

  • LISTING_TYPE_UNSPECIFIED: Unspecified, is also a default value.
  • LISTING_TYPE_INDIVIDUAL_NFT: Individual NFT (a single NFT in the listing).
  • LISTING_TYPE_BUNDLE: Bundle (multiple NFTs in the same listing).
Enum: "LISTING_TYPE_INDIVIDUAL_NFT" "LISTING_TYPE_BUNDLE"
marketplaceId
string

Filter by specific marketplace. If not set, returns all marketplaces returns all marketplaces currently supported..

  • MARKETPLACE_ID_UNSPECIFIED: Unspecified, also is a default value.
  • MARKETPLACE_ID_OPENSEA: OpenSea Marketplace.
  • MARKETPLACE_ID_LOOKSRARE: LooksRare Marketaplce.
  • MARKETPLACE_ID_CRYPTOPUNKS: CryptoPunks marketplace.
  • MARKETPLACE_ID_SUPERRARE: SupeRare Marketplace.
Enum: "MARKETPLACE_ID_OPENSEA" "MARKETPLACE_ID_LOOKSRARE" "MARKETPLACE_ID_CRYPTOPUNKS" "MARKETPLACE_ID_SUPERRARE"
contractAddress
string

Filter by NFT contract address. The request must include either the contract address or the creator address.

tokenId
string

Filter by NFT token ID.

creatorAddress
string

Filter by the creator address or ENS name of the listing. The request must include either the contract address or the creator address.

Responses
200

A successful response.

get/ethereum/marketplaces/v1beta1/listings/active
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/ethereum/marketplaces/v1beta1/listings/active?limit=string&offset=string&sortBy=SORT_BY_CREATION_TIMESTAMP&sortDirection=SORT_DIRECTION_ASC&creationTimestampGt=2019-08-24T14%3A15%3A22Z&listingType=LISTING_TYPE_INDIVIDUAL_NFT&marketplaceId=MARKETPLACE_ID_OPENSEA&contractAddress=string&tokenId=string&creatorAddress=string' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "listings": [
    • {
      • "nft": [
        • {
          • "contractAddress": "string",
          • "tokenId": "string",
          • "quantity": "string",
          • "type": "TOKEN_TYPE_ERC721",
          • "metadata": {
            • "metadataUri": {
              • "uri": "string",
              • "mimeType": "string"
              },
            • "name": "string",
            • "description": "string",
            • "image": {
              • "uri": "string",
              • "uriOriginal": "string",
              • "mimeType": "string"
              }
            }
          }
        ],
      • "listingDetails": {
        • "marketplaceId": "MARKETPLACE_ID_OPENSEA",
        • "marketplacePermalink": "string",
        • "saleType": "SALE_TYPE_FIXED_PRICE",
        • "listingType": "LISTING_TYPE_INDIVIDUAL_NFT",
        • "price": {
          • "totalNative": "string",
          • "totalUsd": "string",
          • "erc20Address": "string",
          • "erc20Value": "string"
          },
        • "creatorAddress": "string",
        • "creationTimestamp": "2019-08-24T14:15:22Z",
        • "startTimestamp": "2019-08-24T14:15:22Z",
        • "expirationTimestamp": "2019-08-24T14:15:22Z"
        }
      }
    ]
}

NFT offersDeprecated

Get a list of active NFT offers across multiple marketplaces.

Request
Security:
ApiKeyAuth
query Parameters
limit
string <uint64>

Quantity of rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

sortBy
string

Sort criteria/key (default = sort by creation timestamp).

  • SORT_BY_UNSPECIFIED: Unspecified, also is a default value.
  • SORT_BY_CREATION_TIMESTAMP: Sort by the creation timestamp.
  • SORT_BY_START_TIMESTAMP: Sort by the start timestamp.
  • SORT_BY_EXPIRATION_TIMESTAMP: Sort by the expiration timestamp.
  • SORT_BY_PRICE: Sort by the price
Enum: "SORT_BY_CREATION_TIMESTAMP" "SORT_BY_START_TIMESTAMP" "SORT_BY_EXPIRATION_TIMESTAMP" "SORT_BY_PRICE"
sortDirection
string

Sort direction (sort key, default = ascending).

Enum: "SORT_DIRECTION_ASC" "SORT_DIRECTION_DESC"
creationTimestampGt
string <date-time>

Filter by minimal bid/offer creation timestamp, useful to get updates since last known offer. The filter uses "greater" comparison and excludes listings with given timestamp, this allows getting only new offers.

offerType
string

Filter by type of the offer (default = any type).

  • OFFER_TYPE_UNSPECIFIED: Unspecified, is also a default value.
  • OFFER_TYPE_OFFER_INDIVIDUAL_NFT: Regular offer.
  • OFFER_TYPE_BID_INDIVIDUAL_NFT: Offer made as a bid to an auction.
  • OFFER_TYPE_OFFER_BUNDLE: Regular offer.
  • OFFER_TYPE_BID_BUNDLE: Offer made as a bid to an auction.
  • OFFER_TYPE_COLLECTION_OFFER: Offer made to any token in the given collection.
  • OFFER_TYPE_TRAIT_OFFER: Offer made to any token in a given collection that has specific traits.
Enum: "OFFER_TYPE_OFFER_INDIVIDUAL_NFT" "OFFER_TYPE_BID_INDIVIDUAL_NFT" "OFFER_TYPE_OFFER_BUNDLE" "OFFER_TYPE_BID_BUNDLE" "OFFER_TYPE_COLLECTION_OFFER" "OFFER_TYPE_TRAIT_OFFER"
marketplaceId
string

Filter by specific marketplace. If not set, returns all marketplaces.

  • MARKETPLACE_ID_UNSPECIFIED: Unspecified, also is a default value.
  • MARKETPLACE_ID_OPENSEA: OpenSea Marketplace.
  • MARKETPLACE_ID_LOOKSRARE: LooksRare Marketaplce.
  • MARKETPLACE_ID_CRYPTOPUNKS: CryptoPunks marketplace.
  • MARKETPLACE_ID_SUPERRARE: SupeRare Marketplace.
Enum: "MARKETPLACE_ID_OPENSEA" "MARKETPLACE_ID_LOOKSRARE" "MARKETPLACE_ID_CRYPTOPUNKS" "MARKETPLACE_ID_SUPERRARE"
contractAddress
string

Filter by NFT contract address. The request must include either the contract_address, the creator address or the receiver address.

tokenId
string

Filter by NFT token ID.

creatorAddress
string

Filter by the offer/bid maker wallet address (or ENS name). The request must include either the contract_address, the creator address or the receiver address.

receiverAddress
string

Filter by the offer/bid receiver wallet address (or ENS name). The request must include either the contract_address, the creator address or the receiver address.

includeOwnedTokensInCollectionOffer
boolean

If set to true and a collection offer matches the parameters of the request, then the response will return an offer for each of the tokens that the collection offers matches from the wallet of the receiver_address. The value of this flag will be ignored if no receiver_address is passed in.

Responses
200

A successful response.

get/ethereum/marketplaces/v1beta1/offers/active
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/ethereum/marketplaces/v1beta1/offers/active?limit=string&offset=string&sortBy=SORT_BY_CREATION_TIMESTAMP&sortDirection=SORT_DIRECTION_ASC&creationTimestampGt=2019-08-24T14%3A15%3A22Z&offerType=OFFER_TYPE_OFFER_INDIVIDUAL_NFT&marketplaceId=MARKETPLACE_ID_OPENSEA&contractAddress=string&tokenId=string&creatorAddress=string&receiverAddress=string&includeOwnedTokensInCollectionOffer=true' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "offers": [
    • {
      • "nft": [
        • {
          • "contractAddress": "string",
          • "tokenId": "string",
          • "quantity": "string",
          • "type": "TOKEN_TYPE_ERC721",
          • "metadata": {
            • "metadataUri": {
              • "uri": "string",
              • "mimeType": "string"
              },
            • "name": "string",
            • "description": "string",
            • "image": {
              • "uri": "string",
              • "uriOriginal": "string",
              • "mimeType": "string"
              }
            }
          }
        ],
      • "offerDetails": {
        • "marketplaceId": "MARKETPLACE_ID_OPENSEA",
        • "marketplacePermalink": "string",
        • "offerType": "OFFER_TYPE_OFFER_INDIVIDUAL_NFT",
        • "price": {
          • "totalNative": "string",
          • "totalUsd": "string",
          • "erc20Address": "string",
          • "erc20Value": "string"
          },
        • "creatorAddress": "string",
        • "receiverAddress": "string",
        • "creationTimestamp": "2019-08-24T14:15:22Z",
        • "startTimestamp": "2019-08-24T14:15:22Z",
        • "expirationTimestamp": "2019-08-24T14:15:22Z"
        }
      }
    ]
}

Pricing

DEPRECATED. Please follow the guide for migration to the new Uniform API. PricingService provides the ability to get realtime pricing and trading information for the collection.

Prices by contractDeprecated

Get prices history by contract address. Note: Prices below 0.01 ETH will not be included in this data. Prices below this value often represent what are effectively transfers rather than real sales.

Request
Security:
ApiKeyAuth
path Parameters
contractAddress
required
string

Contract address (or ENS name) that tracks NFTs.

query Parameters
duration
required
string

Time duration for the analysis.

  • DURATION_UNSPECIFIED: Unspecified value.
  • DURATION_1_DAY: 1 day.
  • DURATION_7_DAYS: 7 days.
  • DURATION_30_DAYS: 30 days.
  • DURATION_365_DAYS: 365 days.
Enum: "DURATION_1_DAY" "DURATION_7_DAYS" "DURATION_30_DAYS" "DURATION_365_DAYS"
timestampLt
string <date-time>

Final timestamp for the analysis.

Default is today at 00:00:00. Final timestamp is excluded from the result date, while start timestamp is included.

groupByPeriod
required
string

Aggregation period for the analysis.

Depending on the requested duration following minimal values are allowed:

  • duration = 1 day, minimum allowed value is 15 minutes;

  • duration = 7 days, minimum allowed value is 1 hour;

  • duration = 30 days, minimum allowed value is 1 day;

  • duration = 365 days, minimum allowed value is 1 day.

  • GROUP_BY_PERIOD_UNSPECIFIED: Undefined value.

  • GROUP_BY_PERIOD_15_MINUTES: 15 minutes.

  • GROUP_BY_PERIOD_1_HOUR: 1 hour.

  • GROUP_BY_PERIOD_1_DAY: 1 day.

Enum: "GROUP_BY_PERIOD_15_MINUTES" "GROUP_BY_PERIOD_1_HOUR" "GROUP_BY_PERIOD_1_DAY"
Responses
200

A successful response.

get/pricing/v1beta1/prices/by_contract/{contractAddress}
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/pricing/v1beta1/prices/by_contract/:contractAddress?duration=DURATION_1_DAY&timestampLt=2019-08-24T14%3A15%3A22Z&groupByPeriod=GROUP_BY_PERIOD_15_MINUTES' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "dataPoints": [
    • {
      • "timestamp": "2019-08-24T14:15:22Z",
      • "min": "string",
      • "max": "string",
      • "avg": "string"
      }
    ]
}

Sales volume by contractDeprecated

Get sales volume and count by contract address. Note: Prices below 0.01 ETH will not be included in this data. Prices below this value often represent what are effectively transfers rather than real sales.

Request
Security:
ApiKeyAuth
path Parameters
contractAddress
required
string

Contract address (or ENS name) that tracks NFTs.

query Parameters
duration
required
string

Time duration for the analysis.

  • DURATION_UNSPECIFIED: Unspecified value.
  • DURATION_1_DAY: 1 day.
  • DURATION_7_DAYS: 7 days.
  • DURATION_30_DAYS: 30 days.
  • DURATION_365_DAYS: 365 days.
Enum: "DURATION_1_DAY" "DURATION_7_DAYS" "DURATION_30_DAYS" "DURATION_365_DAYS"
timestampLt
string <date-time>

Final timestamp for the analysis.

Default is today at 00:00:00. Final timestamp is excluded from the result date, while start timestamp is included.

groupByPeriod
required
string

Aggregation period for the analysis.

Depending on the requested duration following minimal values are allowed:

  • duration = 1 day, minimum allowed value is 15 minutes;

  • duration = 7 days, minimum allowed value is 1 hour;

  • duration = 30 days, minimum allowed value is 1 day;

  • duration = 365 days, minimum allowed value is 1 day.

  • GROUP_BY_PERIOD_UNSPECIFIED: Undefined value.

  • GROUP_BY_PERIOD_15_MINUTES: 15 minutes.

  • GROUP_BY_PERIOD_1_HOUR: 1 hour.

  • GROUP_BY_PERIOD_1_DAY: 1 day.

Enum: "GROUP_BY_PERIOD_15_MINUTES" "GROUP_BY_PERIOD_1_HOUR" "GROUP_BY_PERIOD_1_DAY"
Responses
200

A successful response.

get/pricing/v1beta1/volumes/by_contract/{contractAddress}
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/pricing/v1beta1/volumes/by_contract/:contractAddress?duration=DURATION_1_DAY&timestampLt=2019-08-24T14%3A15%3A22Z&groupByPeriod=GROUP_BY_PERIOD_15_MINUTES' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "dataPoints": [
    • {
      • "timestamp": "2019-08-24T14:15:22Z",
      • "count": "string",
      • "volume": "string"
      }
    ]
}

Tokens

DEPRECATED. Please follow the guide for migration to the new Uniform API. TokensService provides the ability to get the NFTs that match various criteria and details about specific NFTs.

NFTs by the ContractDeprecated

Get the list of NFTs tracked by a given contract.

Request
Security:
ApiKeyAuth
path Parameters
contractAddress
required
string

Contract address (or ENS name) that tracks the NFT.

query Parameters
limit
string <uint64>

Quantity of rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

sortDirection
string

Sort direction (sort key = timestamp, default = ascending).

Enum: "SORT_DIRECTION_ASC" "SORT_DIRECTION_DESC"
blockTimestampGt
string <date-time>

Filter by minimal block timestamp, using "greater" comparison. This filter exludes rows matching given timestamp exactly.

traits
Array of strings

Filter by token traits. For multiple filters with the same trait name, the values are OR'd (if string values). For different trait names, the filter returns values that have all the values.

The format of each trait filter will be the name of the trait followed by one of the allowed comparison operators (=, >=, <=) and the value of that trait to filter against. For numeric/date traits, users are allowed to pass in upto two filters (one >=, one <=) for filtering within a range.

Note: The = operator is available only for string traits, and the >=, <= comparison operators are available for only numeric and date traits.

Valid filters: 

{"color=red", "color=yellow", "experience>=5", "experience<=10", "birthday>=2022-09-30T15:33:50+00:00"}

For eg. for the above array of filters, the endpoint will return all tokens that have: (color = red OR color = yellow) AND (experience >= 1 and experience <= 5) AND birthday>=2022-09-30T15:33:50+00:00

Responses
200

A successful response.

get/tokens/v1beta1/by_contract/{contractAddress}
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/tokens/v1beta1/by_contract/:contractAddress?limit=string&offset=string&sortDirection=SORT_DIRECTION_ASC&blockTimestampGt=2019-08-24T14%3A15%3A22Z&traits=string' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "tokens": [
    • {
      • "contractAddress": "string",
      • "tokenId": "string",
      • "type": "TOKEN_TYPE_ERC721",
      • "metadata": {
        • "metadataUri": {
          • "uri": "string",
          • "mimeType": "string"
          },
        • "name": "string",
        • "description": "string",
        • "image": {
          • "uri": "string",
          • "uriOriginal": "string",
          • "mimeType": "string"
          }
        },
      • "mintEvent": {
        • "txHash": "string",
        • "logIndex": "string",
        • "blockTimestamp": "2019-08-24T14:15:22Z"
        }
      }
    ]
}

NFTs by the MinterDeprecated

Get the list of NFTs minted by a given address.

Request
Security:
ApiKeyAuth
path Parameters
minterAddress
required
string

Filter by minter address (or ENS name).

query Parameters
limit
string <uint64>

Quantity of rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

contractAddress
string

Filter by contract address (or ENS name).

tokenTypes
Array of strings

Filter by the token types.

  • TOKEN_TYPE_UNSPECIFIED: Unset is a system value (shouldn't be used in real data).
  • TOKEN_TYPE_ERC721: ERC721 type.
  • TOKEN_TYPE_ERC1155: ERC1155 type.
  • TOKEN_TYPE_ERC721_LEGACY: ERC721 legacy type.
  • TOKEN_TYPE_CRYPTOPUNKS: Cryptopunks type.
Items Enum: "TOKEN_TYPE_ERC721" "TOKEN_TYPE_ERC1155" "TOKEN_TYPE_ERC721_LEGACY" "TOKEN_TYPE_CRYPTOPUNKS"
blockTimestampGt
string <date-time>

Filter by minimal block timestamp, using "greater" comparison. This filter exludes rows matching given timestamp exactly.

Responses
200

A successful response.

get/tokens/v1beta1/by_minter/{minterAddress}
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/tokens/v1beta1/by_minter/:minterAddress?limit=string&offset=string&contractAddress=string&tokenTypes=TOKEN_TYPE_ERC721&blockTimestampGt=2019-08-24T14%3A15%3A22Z' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "tokens": [
    • {
      • "contractAddress": "string",
      • "tokenId": "string",
      • "type": "TOKEN_TYPE_ERC721",
      • "metadata": {
        • "metadataUri": {
          • "uri": "string",
          • "mimeType": "string"
          },
        • "name": "string",
        • "description": "string",
        • "image": {
          • "uri": "string",
          • "uriOriginal": "string",
          • "mimeType": "string"
          }
        },
      • "mintEvent": {
        • "txHash": "string",
        • "logIndex": "string",
        • "blockTimestamp": "2019-08-24T14:15:22Z"
        }
      }
    ]
}

NFTs by the OwnerDeprecated

Get the list of NFTs owned by a given address.

Request
Security:
ApiKeyAuth
path Parameters
ownerAddress
required
string

Filter by owner address (or ENS name).

query Parameters
limit
string <uint64>

Quantity of rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

contractAddress
string

Filter by contract address (or ENS name).

tokenTypes
Array of strings

Filter by the token types.

  • TOKEN_TYPE_UNSPECIFIED: Unset is a system value (shouldn't be used in real data).
  • TOKEN_TYPE_ERC721: ERC721 type.
  • TOKEN_TYPE_ERC1155: ERC1155 type.
  • TOKEN_TYPE_ERC721_LEGACY: ERC721 legacy type.
  • TOKEN_TYPE_CRYPTOPUNKS: Cryptopunks type.
Items Enum: "TOKEN_TYPE_ERC721" "TOKEN_TYPE_ERC1155" "TOKEN_TYPE_ERC721_LEGACY" "TOKEN_TYPE_CRYPTOPUNKS"
Responses
200

A successful response.

get/tokens/v1beta1/by_owner/{ownerAddress}
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/tokens/v1beta1/by_owner/:ownerAddress?limit=string&offset=string&contractAddress=string&tokenTypes=TOKEN_TYPE_ERC721' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "tokens": [
    • {
      • "contractAddress": "string",
      • "tokenId": "string",
      • "type": "TOKEN_TYPE_ERC721",
      • "metadata": {
        • "metadataUri": {
          • "uri": "string",
          • "mimeType": "string"
          },
        • "name": "string",
        • "description": "string",
        • "image": {
          • "uri": "string",
          • "uriOriginal": "string",
          • "mimeType": "string"
          }
        },
      • "quantity": "string"
      }
    ]
}

Token MetadataDeprecated

Get full metadata of a given NFT.

Request
Security:
ApiKeyAuth
path Parameters
contractAddress
required
string

Contract address (or ENS name) that tracks NFT.

tokenId
required
string

Token ID.

Responses
200

A successful response.

get/tokens/v1beta1/token/{contractAddress}/{tokenId}/metadata
Request samples
curl -i -X GET \
  https://ethereum.rest.mnemonichq.com/tokens/v1beta1/token/:contractAddress/:tokenId/metadata \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "metadata": {
    • "metadataUri": {
      • "uri": "string",
      • "mimeType": "string"
      },
    • "name": "string",
    • "description": "string",
    • "image": {
      • "uri": "string",
      • "uriOriginal": "string",
      • "mimeType": "string"
      },
    • "raw": "string",
    • "indexedAt": "2019-08-24T14:15:22Z",
    • "quantity": "string",
    • "ownerCount": "string"
    }
}

NFT OwnersDeprecated

Get the list of NFT owners including the quantity owned.

Request
Security:
ApiKeyAuth
path Parameters
contractAddress
required
string

Contract address (or ENS name) that tracks NFT.

tokenId
required
string

Token ID.

query Parameters
limit
string <uint64>

Quantity of rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

Responses
200

A successful response.

get/tokens/v1beta1/token/{contractAddress}/{tokenId}/owners
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/tokens/v1beta1/token/:contractAddress/:tokenId/owners?limit=string&offset=string' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "owners": [
    • {
      • "address": "string",
      • "quantity": "string"
      }
    ]
}

Token TraitsDeprecated

Get all token traits of a given NFT.

Request
Security:
ApiKeyAuth
path Parameters
contractAddress
required
string

Contract address (or ENS name) that tracks NFT.

tokenId
required
string

Token ID.

query Parameters
limit
string <uint64>

How many trait rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

Responses
200

A successful response.

get/tokens/v1beta1/token/{contractAddress}/{tokenId}/traits
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/tokens/v1beta1/token/:contractAddress/:tokenId/traits?limit=string&offset=string' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "traits": [
    • {
      • "name": "string",
      • "displayType": "DISPLAY_TYPE_PROPERTY",
      • "valueType": "VALUE_TYPE_NUMERIC",
      • "valueNumeric": {
        • "value": 0,
        • "min": 0,
        • "max": 0
        },
      • "valueString": {
        • "value": "string",
        • "tokenCount": "string",
        • "traitPercentage": 0
        },
      • "valueDate": {
        • "value": "2019-08-24T14:15:22Z",
        • "min": "2019-08-24T14:15:22Z",
        • "max": "2019-08-24T14:15:22Z"
        }
      }
    ]
}

Transfers Insights

DEPRECATED. Please follow the guide for migration to the new Uniform API. Transfers Insights endpoints allows to get transfer events by various criteria. The service provides NFT transfers with price attribution per token transfered, which is especially important in multi-token transactions. In addition the service also provides full transfers breakout by transactions.

Transfers by Tx HashDeprecated

Get list of NFT, ETH and ERC20 transfers by the transaction hash (for NFT-related transactions only).

Request
Security:
ApiKeyAuth
path Parameters
txHash
required
string

Transaction hash.

Responses
200

A successful response.

get/transfers/v1beta1/all/by_tx_hash/{txHash}
Request samples
curl -i -X GET \
  https://ethereum.rest.mnemonichq.com/transfers/v1beta1/all/by_tx_hash/:txHash \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "nftTransfers": [
    • {
      • "blockchainEvent": {
        • "txHash": "string",
        • "logIndex": "string",
        • "seqIndex": "string",
        • "blockNumber": "string",
        • "blockTimestamp": "2019-08-24T14:15:22Z"
        },
      • "contractAddress": "string",
      • "tokenId": "string",
      • "tokenType": "TOKEN_TYPE_ERC721",
      • "transferType": "TRANSFER_TYPE_MINT",
      • "quantity": "string",
      • "sender": {
        • "address": "string",
        • "type": "TYPE_OWNER"
        },
      • "senderReceived": {
        • "totalEth": "string",
        • "totalUsd": "string",
        • "ethTransfersTotal": "string",
        • "erc20TransfersTotal": "string",
        • "attributedBy": "ATTRIBUTED_BY_ZERO_QUANTITY_TX",
        • "erc20Totals": [
          • {
            • "contractAddress": "string",
            • "totalNormalized": "string"
            }
          ]
        },
      • "recipient": {
        • "address": "string",
        • "type": "TYPE_OWNER"
        },
      • "recipientPaid": {
        • "totalEth": "string",
        • "totalUsd": "string",
        • "ethTransfersTotal": "string",
        • "erc20TransfersTotal": "string",
        • "attributedBy": "ATTRIBUTED_BY_ZERO_QUANTITY_TX",
        • "erc20Totals": [
          • {
            • "contractAddress": "string",
            • "totalNormalized": "string"
            }
          ]
        },
      • "labels": [
        • "LABEL_MINT"
        ]
      }
    ],
  • "ethTransfers": [
    • {
      • "fromAddress": "string",
      • "toAddress": "string",
      • "valueRaw": "string",
      • "valueNormalized": "string"
      }
    ],
  • "erc20Transfers": [
    • {
      • "fromAddress": "string",
      • "toAddress": "string",
      • "contractAddress": "string",
      • "valueRaw": "string",
      • "valueNormalized": "string",
      • "valueEth": "string"
      }
    ]
}

NFT TransfersDeprecated

Get list of the NFT transfers by various criteria.

Request
Security:
ApiKeyAuth
query Parameters
limit
string <uint64>

Quantity of rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

sortDirection
string

Sort direction (sort key = timestamp, default = ascending).

Enum: "SORT_DIRECTION_ASC" "SORT_DIRECTION_DESC"
blockTimestampGt
string <date-time>

Filter by minimal block timestamp, useful to get updates since last known transfer. The filter uses "greater" comparison and excludes transfers with given timestamp, this allows getting only new transfers.

contractAddress
string

Filter by NFT contract address (or ENS name).

tokenId
string

Filter by NFT Token ID.

transferTypes
Array of strings

DEPRECATED. Filter by transfer types (any of).

  • TRANSFER_TYPE_UNSPECIFIED: Undefined (should not be present in real data).
  • TRANSFER_TYPE_MINT: Mint.

Transfer is considered to be a mint, when sender address is 0x0000000000000000000000000000000000000000.

  • TRANSFER_TYPE_BURN: Burn.

Transfer is considered to be a burn, when recepient is 0x0000000000000000000000000000000000000000 or 0x000000000000000000000000000000000000dead.

  • TRANSFER_TYPE_REGULAR: Regular transfer.

Transfer is considered to be regular, when it is neither a burn nor mint. Another special case is when it is mint and burn at the same time.

Items Enum: "TRANSFER_TYPE_MINT" "TRANSFER_TYPE_BURN" "TRANSFER_TYPE_REGULAR"
tokenTypes
Array of strings

Filter by token types (any of).

  • TOKEN_TYPE_UNSPECIFIED: Unset is a system value (shouldn't be used in real data).
  • TOKEN_TYPE_ERC721: ERC721 type.
  • TOKEN_TYPE_ERC1155: ERC1155 type.
  • TOKEN_TYPE_ERC721_LEGACY: ERC721 legacy type.
  • TOKEN_TYPE_CRYPTOPUNKS: Cryptopunks type.
Items Enum: "TOKEN_TYPE_ERC721" "TOKEN_TYPE_ERC1155" "TOKEN_TYPE_ERC721_LEGACY" "TOKEN_TYPE_CRYPTOPUNKS"
senderAddress
string

Filter by sender address (or ENS name).

recipientAddress
string

Filter by recipient address (or ENS name).

labelsAny
Array of strings

Filter by labels - multiple label types can be selected. Labels that include "MARKETPLACE", indicates the specific marketplace where a transaction occurred.

  • LABEL_UNSPECIFIED: Undefined (should not be present in real data).
  • LABEL_MINT: Transfer is labeled a mint when sender address is 0x0000000000000000000000000000000000000000 or 0x000000000000000000000000000000000000dead.
  • LABEL_BURN: Transfer is labeled a burn when recipient is 0x0000000000000000000000000000000000000000 or 0x000000000000000000000000000000000000dead.
  • LABEL_SALE: Transfer is labeled a sale when it is neither a burn nor a mint and seller has incoming ETH or ERC-20 transfers inside the same transaction. Also, total value of all incoming and outgoing seller ETH and ERC-20 transfers should be greater than zero.
  • LABEL_TRANSFER: Transfer is labeled a transfer when it is neither a burn, mint, or sale.
  • LABEL_SWAP: Transfer is labeled a swap when:
    • there are no mints and burns inside the transaction;
    • there is at least one user who received and sent different tokens;
  • LABEL_BUNDLE: Transfer is labeled a bundle when:
    • there are no mints and burns inside the transaction;
    • at least two different tokens were transferred;
    • it is not a swap;
Items Enum: "LABEL_MINT" "LABEL_BURN" "LABEL_SALE" "LABEL_TRANSFER" "LABEL_SWAP" "LABEL_BUNDLE" "LABEL_MARKETPLACE_OPENSEA" "LABEL_MARKETPLACE_X2Y2" "LABEL_MARKETPLACE_GEMSWAP" "LABEL_MARKETPLACE_RARIBLE" "LABEL_MARKETPLACE_LOOKSRARE" "LABEL_MARKETPLACE_SUPERRARE" "LABEL_MARKETPLACE_CRYPTOPUNKS" "LABEL_MARKETPLACE_ARTBLOCKS"
Responses
200

A successful response.

get/transfers/v1beta1/nft
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/transfers/v1beta1/nft?limit=string&offset=string&sortDirection=SORT_DIRECTION_ASC&blockTimestampGt=2019-08-24T14%3A15%3A22Z&contractAddress=string&tokenId=string&transferTypes=TRANSFER_TYPE_MINT&tokenTypes=TOKEN_TYPE_ERC721&senderAddress=string&recipientAddress=string&labelsAny=LABEL_MINT' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "nftTransfers": [
    • {
      • "blockchainEvent": {
        • "txHash": "string",
        • "logIndex": "string",
        • "seqIndex": "string",
        • "blockNumber": "string",
        • "blockTimestamp": "2019-08-24T14:15:22Z"
        },
      • "contractAddress": "string",
      • "tokenId": "string",
      • "tokenType": "TOKEN_TYPE_ERC721",
      • "transferType": "TRANSFER_TYPE_MINT",
      • "quantity": "string",
      • "sender": {
        • "address": "string",
        • "type": "TYPE_OWNER"
        },
      • "senderReceived": {
        • "totalEth": "string",
        • "totalUsd": "string",
        • "ethTransfersTotal": "string",
        • "erc20TransfersTotal": "string",
        • "attributedBy": "ATTRIBUTED_BY_ZERO_QUANTITY_TX",
        • "erc20Totals": [
          • {
            • "contractAddress": "string",
            • "totalNormalized": "string"
            }
          ]
        },
      • "recipient": {
        • "address": "string",
        • "type": "TYPE_OWNER"
        },
      • "recipientPaid": {
        • "totalEth": "string",
        • "totalUsd": "string",
        • "ethTransfersTotal": "string",
        • "erc20TransfersTotal": "string",
        • "attributedBy": "ATTRIBUTED_BY_ZERO_QUANTITY_TX",
        • "erc20Totals": [
          • {
            • "contractAddress": "string",
            • "totalNormalized": "string"
            }
          ]
        },
      • "labels": [
        • "LABEL_MINT"
        ]
      }
    ]
}

Blockchain

DEPRECATED. Please follow the guide for migration to the new Uniform API. BlockchainService provides the ability to query basic primitives of the Ethereum blockchain (such as blocks, transactions, logs, etc).

Block by NumberDeprecated

Returns the block corresponding to a given block number.

Request
Security:
ApiKeyAuth
path Parameters
blockNumber
required
string

A block number.

Responses
200

A successful response.

get/blockchain/v1beta1/blocks/by_number/{blockNumber}
Request samples
curl -i -X GET \
  https://ethereum.rest.mnemonichq.com/blockchain/v1beta1/blocks/by_number/:blockNumber \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "block": {
    • "number": "string",
    • "hash": "string",
    • "parentHash": "string",
    • "timestamp": "2019-08-24T14:15:22Z",
    • "size": "string",
    • "gasUsed": "string",
    • "gasLimit": "string",
    • "baseFeePerGas": "string",
    • "miner": "string",
    • "nonce": "string"
    }
}

Logs by Tx HashDeprecated

Returns in a paginated manner the list of logs corresponding to a given transaction hash.

Request
Security:
ApiKeyAuth
path Parameters
transactionHash
required
string

A transaction hash.

query Parameters
limit
string <uint64>

Quantity of rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

Responses
200

A successful response.

get/blockchain/v1beta1/logs/by_transaction_hash/{transactionHash}
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/blockchain/v1beta1/logs/by_transaction_hash/:transactionHash?limit=string&offset=string' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "logs": [
    • {
      • "transactionHash": "string",
      • "index": "string",
      • "address": "string",
      • "removed": true,
      • "topic0": "string",
      • "topic1": "string",
      • "topic2": "string",
      • "topic3": "string",
      • "data": "string",
      • "timestamp": "2019-08-24T14:15:22Z"
      }
    ]
}

Transaction ReceiptDeprecated

Returns the receipt corresponding to the transaction with a given hash.

Request
Security:
ApiKeyAuth
path Parameters
transactionHash
required
string

A transaction hash.

Responses
200

A successful response.

get/blockchain/v1beta1/transaction_receipts/by_hash/{transactionHash}
Request samples
curl -i -X GET \
  https://ethereum.rest.mnemonichq.com/blockchain/v1beta1/transaction_receipts/by_hash/:transactionHash \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "transactionReceipt": {
    • "transactionHash": "string",
    • "status": "string",
    • "postState": "string",
    • "gasUsed": "string",
    • "cumulativeGasUsed": "string",
    • "contractAddress": "string",
    • "transactionIndex": 0
    }
}

Transaction by HashDeprecated

Returns the transaction corresponding to a given hash.

Request
Security:
ApiKeyAuth
path Parameters
transactionHash
required
string

A transaction hash.

Responses
200

A successful response.

get/blockchain/v1beta1/transactions/by_hash/{transactionHash}
Request samples
curl -i -X GET \
  https://ethereum.rest.mnemonichq.com/blockchain/v1beta1/transactions/by_hash/:transactionHash \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "transaction": {
    • "hash": "string",
    • "blockNumber": "string",
    • "fromAddress": "string",
    • "toAddress": "string",
    • "value": "string",
    • "data": "string",
    • "type": 0,
    • "nonce": "string",
    • "gasLimit": "string",
    • "gasPrice": "string",
    • "gasFeeCap": "string",
    • "gasTipCap": "string"
    }
}

Wallet Intelligence

DEPRECATED. Please follow the guide for migration to the new Uniform API. WalletsService provides the ability to get a list of NFTs or Transfers where a specific Wallet is involved.

Collections by WalletDeprecated

List collections owned by a given Wallet.

Request
Security:
ApiKeyAuth
path Parameters
walletAddress
required
string

Filter by wallet address (or ENS name).

query Parameters
limit
string <uint64>

Quantity of rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

sortField
string

Field, to sort results by.

  • SORT_FIELD_UNSPECIFIED: Sort field not specified.
  • SORT_FIELD_COLLECTION_ADDRESS: Sort by collection address.
  • SORT_FIELD_COLLECTION_NAME: Sort by collection name.
  • SORT_FIELD_LAST_RECEIVED_AT: Sort by the time when the latest token is received.
Enum: "SORT_FIELD_COLLECTION_ADDRESS" "SORT_FIELD_COLLECTION_NAME" "SORT_FIELD_LAST_RECEIVED_AT"
sortDirection
string

Sort direction (default is ascending).

Enum: "SORT_DIRECTION_ASC" "SORT_DIRECTION_DESC"
Responses
200

A successful response.

get/wallets/v1beta1/{walletAddress}/collections
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/wallets/v1beta1/:walletAddress/collections?limit=string&offset=string&sortField=SORT_FIELD_COLLECTION_ADDRESS&sortDirection=SORT_DIRECTION_ASC' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "collections": [
    • {
      • "contractAddress": "string",
      • "tokensCount": "string",
      • "tokensQuantity": "string",
      • "lastReceivedAt": "2019-08-24T14:15:22Z"
      }
    ]
}

NFT TransfersDeprecated

Get list of the NFT transfers by the specified wallet.

Request
Security:
ApiKeyAuth
path Parameters
walletAddress
required
string

Filter by wallet address (or ENS name).

query Parameters
limit
string <uint64>

Quantity of rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

sortDirection
string

Sort direction (sort key = timestamp, default = ascending).

Enum: "SORT_DIRECTION_ASC" "SORT_DIRECTION_DESC"
blockTimestampGt
string <date-time>

Filter by minimal block timestamp, useful to get updates since last known transfer. The filter uses "greater" comparison and excludes transfers with given timestamp, this allows getting only new transfers.

contractAddress
string

Filter by NFT contract address (or ENS name).

tokenId
string

Filter by NFT Token ID.

labelsAny
Array of strings

Filter by labels - multiple label types can be selected. Labels that include "MARKETPLACE", indicates the specific marketplace where a transaction occurred.

  • LABEL_UNSPECIFIED: Undefined (should not be present in real data).
  • LABEL_MINT: Transfer is labeled a mint when sender address is 0x0000000000000000000000000000000000000000 or 0x000000000000000000000000000000000000dead.
  • LABEL_BURN: Transfer is labeled a burn when recipient is 0x0000000000000000000000000000000000000000 or 0x000000000000000000000000000000000000dead.
  • LABEL_SALE: Transfer is labeled a sale when it is neither a burn nor a mint and seller has incoming ETH or ERC-20 transfers inside the same transaction. Also, total value of all incoming and outgoing seller ETH and ERC-20 transfers should be greater than zero.
  • LABEL_TRANSFER: Transfer is labeled a transfer when it is neither a burn, mint, or sale.
  • LABEL_SWAP: Transfer is labeled a swap when:
    • there are no mints and burns inside the transaction;
    • there is at least one user who received and sent different tokens;
  • LABEL_BUNDLE: Transfer is labeled a bundle when:
    • there are no mints and burns inside the transaction;
    • at least two different tokens were transferred;
    • it is not a swap;
Items Enum: "LABEL_MINT" "LABEL_BURN" "LABEL_SALE" "LABEL_TRANSFER" "LABEL_SWAP" "LABEL_BUNDLE" "LABEL_MARKETPLACE_OPENSEA" "LABEL_MARKETPLACE_X2Y2" "LABEL_MARKETPLACE_GEMSWAP" "LABEL_MARKETPLACE_RARIBLE" "LABEL_MARKETPLACE_LOOKSRARE" "LABEL_MARKETPLACE_SUPERRARE" "LABEL_MARKETPLACE_CRYPTOPUNKS" "LABEL_MARKETPLACE_ARTBLOCKS"
tokenIsSpam
string

Spam filter.

  • SPAM_UNSPECIFIED: Return all tokens (default).
  • SPAM_EXCLUDE: Exclude spam.
  • SPAM_ONLY: Return only spam.
Enum: "SPAM_EXCLUDE" "SPAM_ONLY"
party
string

Filter by whether the wallet address is the sender, recipient, or any of them.

  • PARTY_UNSPECIFIED: Specified wallet can be or sender or recipient.
  • PARTY_SENDER: Specified wallet is a sender.
  • PARTY_RECIPIENT: Specified wallet is a recipient.
Enum: "PARTY_SENDER" "PARTY_RECIPIENT"
Responses
200

A successful response.

get/wallets/v1beta1/{walletAddress}/nft_transfers
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/wallets/v1beta1/:walletAddress/nft_transfers?limit=string&offset=string&sortDirection=SORT_DIRECTION_ASC&blockTimestampGt=2019-08-24T14%3A15%3A22Z&contractAddress=string&tokenId=string&labelsAny=LABEL_MINT&tokenIsSpam=SPAM_EXCLUDE&party=PARTY_SENDER' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "nftTransfers": [
    • {
      • "blockchainEvent": {
        • "txHash": "string",
        • "logIndex": "string",
        • "seqIndex": "string",
        • "blockNumber": "string",
        • "blockTimestamp": "2019-08-24T14:15:22Z"
        },
      • "contractAddress": "string",
      • "tokenId": "string",
      • "quantity": "string",
      • "sender": {
        • "address": "string",
        • "type": "TYPE_OWNER"
        },
      • "senderReceived": {
        • "totalEth": "string",
        • "totalUsd": "string",
        • "ethTransfersTotal": "string",
        • "erc20TransfersTotal": "string",
        • "attributedBy": "ATTRIBUTED_BY_ZERO_QUANTITY_TX",
        • "erc20Totals": [
          • {
            • "contractAddress": "string",
            • "totalNormalized": "string"
            }
          ]
        },
      • "recipient": {
        • "address": "string",
        • "type": "TYPE_OWNER"
        },
      • "recipientPaid": {
        • "totalEth": "string",
        • "totalUsd": "string",
        • "ethTransfersTotal": "string",
        • "erc20TransfersTotal": "string",
        • "attributedBy": "ATTRIBUTED_BY_ZERO_QUANTITY_TX",
        • "erc20Totals": [
          • {
            • "contractAddress": "string",
            • "totalNormalized": "string"
            }
          ]
        },
      • "labels": [
        • "LABEL_MINT"
        ],
      • "tokenIsSpam": true
      }
    ]
}

NFTs by WalletDeprecated

Get list of the NFTs owned by the specified wallet.

Request
Security:
ApiKeyAuth
path Parameters
walletAddress
required
string

Filter by wallet address (or ENS name).

query Parameters
limit
string <uint64>

Quantity of rows to return (default = 20, maximum = 500).

offset
string <uint64>

Offset to start return from (for pagination, default = 0).

contractAddress
string

Filter by contract address (or ENS name).

spam
string

Spam filter.

  • SPAM_UNSPECIFIED: Return all tokens (default).
  • SPAM_EXCLUDE: Exclude spam.
  • SPAM_ONLY: Return only spam.
Enum: "SPAM_EXCLUDE" "SPAM_ONLY"
Responses
200

A successful response.

get/wallets/v1beta1/{walletAddress}/nfts
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/wallets/v1beta1/:walletAddress/nfts?limit=string&offset=string&contractAddress=string&spam=SPAM_EXCLUDE' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "tokens": [
    • {
      • "contractAddress": "string",
      • "tokenId": "string",
      • "metadata": {
        • "metadataUri": {
          • "uri": "string",
          • "mimeType": "string"
          },
        • "name": "string",
        • "description": "string",
        • "image": {
          • "uri": "string",
          • "uriOriginal": "string",
          • "mimeType": "string"
          }
        },
      • "quantity": "string",
      • "spam": true
      }
    ]
}

Report Not SpamDeprecated

Report that a collection or token was inaccurately flagged as spam.

Request
Security:
ApiKeyAuth
path Parameters
walletAddress
required
string

The wallet address of the user who reported inaccuracy.

contractAddress
required
string

Contract address that tracks NFT.

query Parameters
tokenId
string

Token ID of the NFT.

feedback
string

User feedback or explanations.

Responses
200

A successful response.

get/wallets/v1beta1/{walletAddress}/report_not_spam/{contractAddress}
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/wallets/v1beta1/:walletAddress/report_not_spam/:contractAddress?tokenId=string&feedback=string' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{ }

Report SpamDeprecated

Report a collection or token as spam.

Request
Security:
ApiKeyAuth
path Parameters
walletAddress
required
string

The wallet address of the user who reported inaccuracy.

contractAddress
required
string

Contract address that tracks NFT.

query Parameters
tokenId
string

Token ID of the NFT.

feedback
string

User feedback or explanations.

Responses
200

A successful response.

get/wallets/v1beta1/{walletAddress}/report_spam/{contractAddress}
Request samples
curl -i -X GET \
  'https://ethereum.rest.mnemonichq.com/wallets/v1beta1/:walletAddress/report_spam/:contractAddress?tokenId=string&feedback=string' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'
Response samples
application/json
{ }