Messari's API follows a versioning scheme to ensure stability and backward compatibility while allowing for continuous improvements.


Base URL and Versioning Format

All API endpoints follow the structure -- https://api.messari.io/<slug>/v1/<endpoint>

  • <slug> represents the specific service being accessed (e.g., marketdata, ai, news, etc.)
  • /v1/ denotes the API version
  • <endpoint> refers to the specific resource or operation being requested

Versioning Strategy

Messari adheres to a semantic versioning approach for API updates:

  • Breaking Changes: Any changes that alter existing functionality in a non-backward-compatible way will result in a version bump (e.g., from v1 to v2).
  • Non-Breaking Changes: Additions such as new endpoints, optional parameters, or enhancements to existing functionality will be introduced within the current version (v1).

Deprecation and Change Management

  • Older versions of the API will remain accessible for a defined period after a new version is introduced.
  • Deprecation notices will be provided in advance, along with migration guides.
  • All changes, including enhancements and deprecations, will be documented in the API Changelog.

For the latest updates, refer to the Messari API Changelog.


Welcome to Messari's API Documentation. Before you proceed, please take a moment to review and understand that your use of this API is subject to and governed by our Terms of Use and Privacy Policy. By accessing and using this API, you agree to comply with the terms and conditions outlined in the Terms of Use and Privacy Policy. The Messari API is intended to be used for internal purposes and uses only. If you are interested in redistributing any data from our API, please reach out to sales@messari.io. Messari reserves the right to modify, update, or revive the API Documentation at any time without notice.