canonical: https://jentic.com/apis/nmkr.io/nmkr

# NMKR Studio Api (Mainnet)

NMKR Studio is a Cardano-native NFT minting and management platform exposing 92 endpoints across project setup, NFT lifecycle, sales, payouts, auctions, and on-chain reporting. Agents and apps can create projects, upload media, define NFTs and metadata, configure sale conditions and discounts, generate payment addresses for random or specific NFT sales, and reconcile customer transactions. Wallet utilities cover address validation, asset listing, and Cardano token registry lookups. The API uses bearer JWT auth and runs against Cardano mainnet at studio-api.nmkr.io.

## For AI agents

Mint, configure, and sell Cardano NFTs end-to-end - projects, NFTs, sale conditions, payment addresses, payouts, and on-chain reporting via NMKR Studio.

## Scope

Does not handle non-Cardano chains, custodial wallet creation for end users, or fiat payments - use for Cardano NFT minting, sales, and project management on NMKR Studio only.

## Capabilities

- Create and manage NMKR projects, including payout wallets and split addresses, via `/v2/CreateProject` and `/v2/AddPayoutWallet`
- Upload, duplicate, block, and delete NFTs in a project through the `/v2/DeleteNft`, `/v2/DuplicateNft`, and `/v2/BlockUnblockNft` endpoints
- Generate payment addresses for random or specific NFT sales via `/v2/GetPaymentAddressForRandomNftSale` and `/v2/GetPaymentAddressForSpecificNftSale`
- Run auctions on the platform with `/v2/CreateAuction`, `/v2/GetAuctionState`, and `/v2/DeleteAuction`
- Inspect Cardano wallets and token holdings via `/v2/CheckAddress`, `/v2/GetAllAssetsInWallet`, and `/v2/GetAmountOfSpecificTokenInWallet`
- Reconcile sales, refunds, and payouts using `/v2/GetCustomerTransactions`, `/v2/GetRefunds`, and `/v2/GetProjectTransactions`

## Use cases

### NFT Drop Operations

NFT studios running scheduled drops on Cardano need to provision projects, upload assets, generate sale-specific payment addresses, and monitor mint counts in real time. NMKR's project, NFT, and payment-address endpoints cover the full drop lifecycle so an operations agent can spin up a collection, configure pricing and discount logic, and emit per-buyer payment addresses without manual Studio clicks. Settlement and refund tracking close the loop on each transaction.

Example prompt: Call `/v2/CreateProject` for a new collection, then `/v2/GetPaymentAddressForRandomNftSale` with the projectuid and countnft to issue a buyer payment address

### Marketplace and Wallet Insights

Aggregator apps and portfolio dashboards need a structured view of Cardano wallet contents and NMKR-listed NFTs. The `/v2/GetAllAssetsInWallet`, `/v2/GetActiveDirectsaleListings`, and `/v2/GetCardanoTokenRegistryInformation` endpoints expose wallet holdings, live listings, and registry metadata. This enables an agent to render a buyer's NFT inventory, surface active marketplace listings tied to a stake address, and link assets to their issuing policies.

Example prompt: Call `/v2/GetAllAssetsInWallet` with a Cardano payment address, then call `/v2/GetCardanoTokenRegistryInformation` for each policyid+tokenname pair to enrich the inventory

### Auction Management

Creators running timed auctions on NMKR need to create auction listings, monitor bid state, and tear down completed auctions. The `/v2/CreateAuction`, `/v2/GetAllAuctions`, `/v2/GetAuctionState`, and `/v2/DeleteAuction` endpoints provide the full lifecycle so a workflow can post a new auction, poll its state on a schedule, and clean up listings post-settlement. All operations are scoped per customerid for multi-tenant studios.

Example prompt: Call `/v2/CreateAuction/{customerid}` with the auction body, then `/v2/GetAuctionState/{auctionuid}` on a 1-minute interval until settled

### AI Agent Cardano Integration

An agent helping creators manage Cardano-native operations can use Jentic to discover the right NMKR endpoint without parsing 92 paths manually. A search for 'mint a Cardano NFT' surfaces the relevant project and NFT operations, the agent loads the input schema, and Jentic injects the JWT bearer at execute time. Mint coupon balances and project transactions can be polled in the same flow.

Example prompt: Use Jentic to call `/v2/GetMintCouponBalance` to verify mint capacity, then `/v2/CreateProject` and `/v2/GetPaymentAddressForSpecificNftSale` to issue a sale address

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/v2/CreateProject` | Create a new NMKR NFT project |
| GET | `/v2/GetPaymentAddressForRandomNftSale/{projectuid}/{countnft}` | Generate a payment address for a random NFT sale |
| GET | `/v2/GetPaymentAddressForSpecificNftSale/{nftuid}/{tokencount}/{price}` | Generate a payment address for a specific NFT and quantity |
| GET | `/v2/GetNfts/{projectuid}/{state}/{count}/{page}` | List NFTs in a project filtered by state with pagination |
| GET | `/v2/GetAllAssetsInWallet/{address}` | List all native assets held by a Cardano wallet address |
| GET | `/v2/GetProjectTransactions/{projectuid}` | Retrieve transactions for a given project |
| POST | `/v2/CreateAuction/{customerid}` | Create a new NFT auction listing |
| GET | `/v2/GetMintCouponBalance` | Check remaining mint coupon balance for the account |

## Key resources

- **Projects** — Create, configure, duplicate, and delete NFT projects
- **NFTs** — Manage NFT lifecycle including upload, block, duplicate, and delete operations
- **Sales and Payment Addresses** — Generate per-buyer payment addresses for random or specific NFT sales with discount logic
- **Auctions** — Create, query, and manage timed NFT auctions
- **Wallets** — Validate addresses, list wallet holdings, and inspect token quantities
- **Transactions and Payouts** — Reconcile customer transactions, refunds, and project payout wallets

## Why Jentic

- **Setup:** Wiring NMKR Studio by hand means handling its bearer auth, building requests against its host (https://studio-api.nmkr.io), and threading project and NFT ids through each path yourself. Through Jentic you install once, import the NMKR Studio API from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** NMKR puts the project uid in the URL path (`/v2/GetNfts/{projectuid}/...` and `/v2/GetProjectTransactions/{projectuid}`), so a rule can pin your agent to one project: it can read that project's NFTs and transactions and nothing else. You choose the operations it may call, so ones like creating a project or an auction are not included unless you add them.
- **Credential handling:** Your NMKR token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'get NFTs for a project' or 'get a payment address for an NFT sale', and Jentic returns the matching NMKR operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Blockfrost API** — Blockfrost provides low-level Cardano chain queries that complement NMKR's higher-level minting and sale operations.
- **Alchemy API** — Alchemy offers comparable NFT minting and indexing tooling on EVM chains rather than Cardano.
- **Blockchain.com API** — Blockchain.com exposes broad on-chain data and wallet operations across multiple networks.

## FAQ

### What authentication does the NMKR Studio API use?

NMKR Studio uses bearer JWT authentication. Pass an API key or access token issued from the NMKR dashboard in the Authorization header as 'Bearer <token>'. Through Jentic the token is held in the vault and injected at call time.

### Can I generate Cardano payment addresses for NFT sales with the NMKR Studio API?

Yes. Use `/v2/GetPaymentAddressForRandomNftSale/{projectuid}/{countnft}` for random drops or `/v2/GetPaymentAddressForSpecificNftSale/{nftuid}/{tokencount}/{price}` for a fixed NFT and quantity. Both return a buyer-specific Cardano address and reservation window.

### What are the rate limits for the NMKR Studio API?

The OpenAPI spec does not declare specific rate limits. NMKR enforces tier-based quotas tracked via the mint coupon balance returned by `/v2/GetMintCouponBalance.` Jentic surfaces 429 responses with backoff.

### How do I create an NMKR project through Jentic?

Run pip install jentic, search Jentic for 'create an nmkr nft project', load the `/v2/CreateProject` operation, supply the project body, and execute. Jentic attaches the bearer JWT and returns the new projectuid for downstream NFT calls.

### Can I check what NFTs a Cardano wallet holds with the NMKR Studio API?

Yes. Call `/v2/GetAllAssetsInWallet/{address}` to list every native asset held at a Cardano payment address, including policy id and token name. Combine with `/v2/GetCardanoTokenRegistryInformation` for human-readable metadata.

### Does the NMKR Studio API support running auctions?

Yes. The auction lifecycle is covered by `/v2/CreateAuction/{customerid}`, `/v2/GetAllAuctions/{customerid}`, `/v2/GetAuctionState/{auctionuid}`, and `/v2/DeleteAuction/{auctionuid}.` Poll auction state to detect settlement events.

### Can I limit what my agent is allowed to do with the NMKR Studio API?

Yes. Because you run Jentic One yourself, your own rules decide which NMKR Studio operations and credentials the agent can use. Since NMKR puts the project uid in the URL path, you can pin the agent to a single project so it only reads that project's NFTs and transactions through operations like `/v2/GetNfts/{projectuid}` and `/v2/GetProjectTransactions/{projectuid}.` State-changing calls such as `/v2/CreateProject` or `/v2/CreateAuction` stay out of reach unless you explicitly add them, and your NMKR token is held by your instance and never enters the agent's prompt.