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
- [Wallet Intelligence API] New
Get Collections by Wallet
endpoint has been released on Polygon.
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
- [Wallet Intelligence API] New
Get Collections by Wallet
endpoint has been released on Ethereum.
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 thesenderReceived
andrecipientPaid
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.
- The ENS Entity By Name and Entity By Address endpoints now return a new boolean field
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)
- New
2022-09-27
- New labels introduced on Transfer Insights endpoint Ethereum:
- indicates the type of transaction:
BUNDLE
andSWAP
; - indicates the specific marketplaces involved, starts with the prefix
MARKETPLACE_
. - New
attributedBy
field introduced tosenderReceived
andrecipientPaid
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
- [NEW] Owners count by contract endpoint has been released for Polygon
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
-
Collections API and Pricing API aggregative endpoints now allow to group data by 15 minutes chunks. Full list of improved methods include:
- Collections API / Owners count by contract
- Collections API / Token supply by contract
- Pricing API / Prices by contract
- Pricing API / Sales volume by contract
2022-07-07
Top collections by X
endpoints now returncontract_name
in addition to the address. Contract name (a.k.a collection name) is derived from thename()
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 theGetTransfersBy*
responses. Read more in the Advanced Transfers documentation.nft_transfers_quantity
field in theGetTransfersBy*
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 theGetContractDetails
response and request to enable filtering by multiple types to support polymorphic contracts.type
field in theGetContractDetails
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 theMintEvent
of theGetTokensByContract
andGetTokensByMinter
endpoints is soft-deprecated in favor oftx_hash
,log_index
andblock_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 theGetTokensByMinter
, 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.