๐Ÿ“กAPI Overview

Overview

The Molecule Protocol provides programmatic APIs for building applications, integrations, and automated workflows on top of decentralized science infrastructure. These APIs enable developers to query project data, mint IP-NFTs, tokenize intellectual property, and manage research datarooms.

API Areas

๐Ÿ“Š Data API

Query and browse IP-NFTs, IP Tokens (IPTs), and market data across the Molecule ecosystem.

Purpose:

  • Browse all IP-NFTs and IPTs on the platform

  • Query metadata, ownership, and project details

  • Access trading data and market metrics

  • Build marketplace UIs and token screeners

Authentication: API Key required

View Data API Documentation โ†’


๐Ÿ” Tokenization API

Create IP-NFTs from research projects and tokenize them into fungible IP Tokens (IPTs).

Purpose:

  • Mint new IP-NFTs with legal agreements

  • Upload artwork and metadata to IPFS

  • Tokenize IP-NFTs into tradeable ERC-20 tokens

  • Manage the complete on-chain minting workflow

Authentication: API Key required

View Tokenization API Documentation โ†’


๐Ÿ“ Labs API (Programmatic File Upload)

Upload files to project datarooms for secure, decentralized research data storage.

Purpose:

  • Automate file uploads to Labs datarooms

  • Integrate with data pipelines and CI/CD

  • Batch upload research data

  • Manage file versions and metadata

Authentication: API Key + Service Token required

View Labs API Documentation โ†’


Authentication

Obtaining API Access

All Molecule APIs require authentication with an API key. To request access:

  1. Contact the Molecule team with your use case

  2. You'll receive:

    • API Key - Required for all APIs

    • Service Token - Additional token for Labs API (if needed)

Authentication Headers

API
Required Headers
Example

Data API

x-api-key

x-api-key: YOUR_API_KEY

Tokenization API

x-api-key

x-api-key: YOUR_API_KEY

Labs API

x-api-key X-Service-Token

x-api-key: YOUR_API_KEY X-Service-Token: YOUR_SERVICE_TOKEN

Why Labs API needs two tokens:

  • API Key: General API authentication

  • Service Token: Identifies which specific lab/dataroom you have access to


API Endpoints

All APIs use the same GraphQL endpoint:


Quick Start Guide

1. Get API Access

Contact the Molecule team via Discord to obtain your API key.

2. Choose Your API

If you want to...
Use this API

Browse IP-NFTs and IPTs

Check market prices and trading data

Mint a new IP-NFT

Create IP Tokens from an IP-NFT

Upload files to a Lab dataroom

3. Make Your First Request

Example (Data API):


Getting Support

If you encounter any issues or have questions about the APIs:

  • Discord: Join our Discord community for support

  • Documentation: Check the specific API documentation pages linked above

  • Contact: Reach out to the Molecule development team


Additional Resources


Last updated: December 2024

Last updated