API Changelog

The API changelog lists all changes to the Mnemonic API.

2023-02-01

The [Uniform API] has been released! This new API is aimed to fully replace existing Ethereum and Polygon endpoints and bring them to a consistent structure. Within the Uniform API the blockchain is selected by just switching between different hostnames, while all API endpoint URLs stay the same regardless of which blockchain you are querying.

To simplify your migration to the Uniform API, we have prepared an extensive migration guide, which will help you map the existing, soon-to-be deprecated Ethereum and Polygon APIs to the new Uniform API

2022-12-09

[Marketplaces API] has been released on both Ethereum and Polygon:

  • GetActiveListings Returns the list of active NFT listings across multiple marketplaces.
  • GetActiveOffers Returns the list of active NFT offers across multiple marketplaces.
  • GetFloorPrice Returns the current floor price of a collection/NFT.

2022-12-01

2022-11-27

  • Information about ERC20 tokens used was added to the Get NFT Transfers endpoint for both Ethereum and Polygon.
  • NFTs by the Owner data lag was reduced to approximately one minute to provide more real-time data for both Ethereum and Polygon.

2022-11-18

[Wallet Intelligence API] Has been released on Polygon along with spam detection capabilities:

  • GetNfts Returns NFTs owned by a given address with spam labels in the response. In addition it allows for spam filtering and reporting;
  • ReportSpam Use to report a collection or token as spam;
  • ReportNotSpam Use to report that a collection or token was inaccurately flagged as spam.

2022-11-15

[Contracts API] We've made the following changes to GetNFTContractMetadata on Ethereum:

  • Banner Image URL and Collection Image URL are now served through Mnemonic's CDN.

2022-11-11

2022-11-02

[Wallet Intelligence API] We've released new endpoints on Ethereum:

  • GetNftTransfers Retrieves a list of NFT transfers connected to a specific wallet;
  • ReportSpam Use to report a collection or token as spam;
  • ReportNotSpam Use to report that a collection or token was inaccurately flagged as spam.

2022-10-31

  • [Tokens API] GetTokenMetadata endpoint returns a token quantity (could be greater than 1 for ERC-1155s) and the number of wallets that own the token.

2022-10-21

  • [Wallet Intelligence API] Has been released, with the GetNfts endpoint which returns NFTs owned by a given address with spam labels in the response. In addition it has spam filtering capabilities on Ethereum.

2022-10-13

  • New labels introduced on the Transfer Insights endpoint on Polygon:
  • indicating the type of transaction: BUNDLE and SWAP;
  • indicating the specific marketplaces involved, starts with the prefix "MARKETPLACE".
  • New attributedBy field introduced to the senderReceived and recipientPaid sections on the Transfer Insights endpoint on Polygon, explaining how the price was attributed.

2022-10-05

  • ENS Lookup:

    • The ENS Entity By Name and Entity By Address endpoints now return a new boolean field matchesReverseRecord which is set to true when the ENS Entity matches the reverse record set for an address.

2022-10-04

  • [NEW] Token Traits release:

    • New GetTokenTraits endpoint that allows fetching the Traits defined in the tokens Metadata (released on both Ethereum and Polygon
    • New CollectionTraits endpoint that allows getting trait summaries on a collection level (released on both Ethereum and Polygon)
    • NFTs By Contract allows filtering by Traits (released on both Ethereum and Polygon)

2022-09-27

  • New labels introduced on Transfer Insights endpoint Ethereum:
  • indicates the type of transaction: BUNDLE and SWAP;
  • indicates the specific marketplaces involved, starts with the prefix MARKETPLACE_.
  • New attributedBy field introduced to senderReceived and recipientPaid sections on Transfer Insights endpoint Ethereum, explaining how the price was attributed.

2022-09-07

  • [Image Caching] We now support caching. Our Ethereum endpoints that return NFT images return cached images in the URI field (when available) in addition to the original URI.

2022-08-31

  • [NEW] Transfer Insights endpoints now allow filtering by transaction type label (mint, burn, sale, transfer). In addition, these endpoints now return a list of the transaction type labels associated with the transfer for both Ethereum and Polygon. With this update, we have soft-deprecated the transferType attribute on the Transfer Insights endpoints

2022-08-12

2022-07-26

  • [NEW] Transfer Insights endpoints have been released for both Ethereum and Polygon. Check our migration guide with comparison of Transfer Insights to the old Transfers endpoints.
  • Along with this release, we have soft-deprecated old Transfer endpoints. We remain committed to our promise of backwards-compatibility and will continue supporting the deprecated endpoints until all clients fully migrated.

2022-07-11

2022-07-07

  • Top collections by X endpoints now return contract_name in addition to the address. Contract name (a.k.a collection name) is derived from the name() method of each contract on the blockchain.

2022-06-20

  • [NEW] Polygon APIs are released.

2022-05-16

  • Transfer responses now contain all fungible transfers from the same transaction, which enables a more accurate NFT price estimation.
  • eth_transfers is introduced in the GetTransfersBy* responses. Read more in the Advanced Transfers documentation.
  • nft_transfers_quantity field in the GetTransfersBy* responses is soft-deprecated in favor of a more detailed breakdown of all transfers within the same transaction. Read more in the Advanced Transfers documentation.

2022-04-7

  • types field is added in the GetContractDetails response and request to enable filtering by multiple types to support polymorphic contracts.
  • type field in the GetContractDetails response is soft-deprecated in favor of polymorphic contracts implementing multiple types.

2022-03-17

  • [NEW] Collection Analytics and Pricing APIs are released. Read more at https://www.mnemonichq.com/blog/mnemonic-ga-launch.
  • block_number field in the MintEvent of the GetTokensByContract and GetTokensByMinter endpoints is soft-deprecated in favor of tx_hash, log_index and block_timestamp.

2022-02-15

  • Added new endpoint GetTokensByMinter. This endpoint simplifies the search for the creator of a specific collection.
  • Added block_timestamp_gt filter in the GetTokensByMinter, which allows filtering by minimal block timestamp, using "greater" comparison. This filter exludes rows matching given timestamp exactly.

2021-11-27

  • [NEW] The initial release of the v1beta1 Ethereum API.
  • The API includes Transfers, Tokens, Contracts, Blockchain services.
  • New buf repo is available for protobuf/gRPC usage at https://buf.build/mnemonic/mnemonicapis.