The OrdinalsBot API is Powering the Ordinals Ecosystem

OrdinalsBot
6 min readAug 25, 2023

--

Our API is powering inscription of the most prominent and innovative projects in the space. In this article we explore what our API can be used for, some use cases, and how you can get started.

Why OrdinalsBot API Is Your Project’s Best Partner?

While we have made the process incredibly easy on our website, we understand that projects might want to embed the inscription process into their user experiences and products. Therefore, we have created our API service. With the API, you can create, manage, and track inscription orders, pay with Lightning or on-chain Bitcoin, and receive inscriptions on specified addresses.

Whether you’re looking to store files, texts, or images securely on the blockchain, the OrdinalsBot API provides seamless access to these features. Our API allows to inscribe up to a 10,000 files per order, efficiently optimise images for size, and tailor fees to match your preferences.

But why use our API?

  • Our API service provides a scalable, proven, and robust infrastructure that has processed hundreds of thousands of inscriptions.
  • We have a built-in payments flow that supports accepting payments for inscriptions in both lightning and on-chain bitcoin.
  • Additionally, we offer support for inscribing onto rare sats from our inventory.
  • You’ll earn a percentage of the service fee (currently 15%), a percentage of the rare sats fee (currently 15%), and you’ll have the option to add an additional fee as well.
  • Our dedicated support team is ready to assist with any queries during the API on-boarding process and throughout its usage.
  • Setting it up is a breeze, and it has become even more seamless with the launch of our SDK.

You can learn more here: Harness the Power of Bitcoin with the OrdinalsBot Inscription API

Diverse Inscription Possibilities

With the API, you can create, manage, and track inscription orders, pay with Lightning or on-chain Bitcoin, and receive inscriptions on specified addresses. Whether you’re looking to store files, texts, or images securely on the blockchain, the OrdinalsBot API provides seamless access to these features. Our API allows to inscribe up to a 10,000 files per order, efficiently optimise images for size, and tailor fees to match your preferences.

  • Multi-layered Artwork NFTs: Construct intricate HTML collections with multiple artwork layers via the /collectioncreate endpoint, resulting in unique pieces.
  • Text Inscription App: Develop an app enabling text inscription onto the Bitcoin blockchain for quotes, poetry, contracts, and more.
  • On-Demand Inscription: Utilize the /collectioncreate endpoint to create collections for users to inscribe files at their convenience.
  • Searchable Blockchain Database: Integrate image and text search endpoints for authenticity verification of inscribed content.
  • BRC-20 Transfers: The API can handle BRC-20 transfers, enhancing your project’s potential. Just inscribe a JSON file using our API, send it to the token owner’s address, and when they pass it to another address, the BRC-20 balance transfers smoothly.

These are just a few ideas to get your creative gears spinning. Given the versatility of our Inscription API, the sky’s truly the limit for what you can build!

Real-world Use Cases Powered by OrdinalsBot API

ALEX specializes in developing top-tier financial applications on the Bitcoin platform. They empower the creation of exceptional financial apps on Bitcoin using their suite of advanced tools. ALEX partnered with OrdinalsBot to improve their UX around the BRC20 trading activities. Their users can inscribe and transfer BRC20 tokens seamlessly with help of APIs from OrdinalsBot.

Testimonial:
OrdinalsBot is a reliable and dependable partner that allows us to focus on improving the user trading experience. They not only provide a top-notch API service on BRC20 inscription, but also listen to and address quickly our requirements.”

Hiro Wallet is the most popular and trusted wallet for apps built on Bitcoin. Hiro Wallet provides everything you need to securely manage your tokens and collectibles. Hiro Wallet uses the OrdinalsBot API to enable users to send and receive BRC-20 inscriptions.

Testimonial:
The API is well-documented and easy to implement. It helped us integrate new Ordinals features very quickly, without the infrastructure or overhead of needing to build or maintain our own inscription service.”

The Bitcoin Maximalists project crafts AI-generated personalities for daily Bitcoin market data, converting market conditions into distinctive NFT personalities. However, enabling users to mint NFTs for specific days while incorporating AI personalities posed challenges with traditional platforms.

By leveraging the OrdinalsBot API, the project seamlessly integrated AI-generated traits into NFT minting, allowing users to inscribe NFTs for chosen days. This innovative approach improved user engagement and personalized NFT narratives, overcoming previous limitations and enhancing the Bitcoin Maximalists project’s uniqueness.

Testimonial:
Working with the team at OrdinalsBot has been nothing short of epic. The technology is moving so fast and OrdinalsBot is doing a great job at not only staying ahead of the curve, but they’re also bringing the developers with them. The developer tools that OrdinalsBot provides to community is unmatched.”

On Use Cases:
If we think about use cases, the killer use case right now is using OrdinalsBot API to customize our inscription experience. We hope people love it. We’re offering the dual mint, where user’s can mint a Stacks NFT and Inscribe their NFT. The OrdinalsBot API makes this possible.”

Ordinal Cubes is a permissionless art project, anyone can create an on-chain gallery, displaying existing images from the Bitcoin blockchain. The images are visualised as a 3D cube, which looks cool and holds the viewer’s attention for a longer time. The created ordinals use recursive inscriptions heavily, so the cost of an inscription for each cube is very affordable.

Testimonial:
I didn’t want to create an art collection where all works are already known at the beginning. Therefore, it was my goal that all parameters for the mint can be entered by the collector — inspired by fx(params). But the effort involved in running a dedicated instance of ord is high, and I wanted to invest my energy in an engaging website instead. Using the OrdinalsBot API, it took me only a week to go from the initial idea to a first version of the website. This is awesome.”

On Choosing OrdinalsBot:
“We looked at all the API providers for inscriptions. With each solution, We felt something was missing, so we reached out. The team at OrdinalsBot responded quickly and friendly, and they even implemented our request directly. That won us over. We’ve been satisfied ever since.”

Starting Your Journey with Us

The easiest way to get started with the OrdinalsBot API, visit docs.ordinalsbot.com. This is your go-to guide for understanding how the API works and what it can do. It covers everything you need to know about generating inscription orders, making payments using Lightning or onchain Bitcoin, and receiving inscriptions at your chosen address.

With just a few lines of code, you can now harness the power of the OrdinalsBot SDK. This incredible tool enables you to seamlessly inscribe a wide range of content onto the Bitcoin blockchain. From files to texts and beyond, the possibilities are endless.The OrdinalsBot SDK is readily available for your convenience, allowing you to import it effortlessly into your project.

Here’s your guide to using the OrdinalsBot SDK:

  • Import the SDK: Begin your journey by importing the OrdinalsBot SDK from here.
  • Project Integration: Seamlessly integrate the power of the OrdinalsBot SDK into your project. Import it directly from this link, and elevate your project with ease.
  • Feedback and Support: If you encounter any issues or have feature requests, share them on our dedicated platform here.

Have questions about how to make the most of our API? Interested in sharing your thoughts or suggesting new features? We’re here, eager to listen. Your ideas matter. We are looking forward to see the amazing things you will build using our API.

Stay in touch…

  1. Join the OrdinalsBot Discord here: https://discord.ordinalsbot.com
  2. Follow us here: https://twitter.com/ordinalsbot
  3. Inscribe something here: https://ordinalsbot.com
  4. Launch your collection here: https://ordinalsbot.com/launchpad

--

--

OrdinalsBot

We make it easy to inscribe ordinals. Like, really easy. It's as simple as uploading a file. Try it out: http://ordinalsbot.com