Create Text Inscription Order

Use this endpoint to create an inscription order that will inscribe some text string.

The /textorder endpoint has a rate limit of maximum 2 requests every 10 seconds.

Create Text Order

POST https://api.ordinalsbot.com/textorder

Request Body

Name	Type	Description
texts*	Array	An array of strings to be inscribed
receiveAddress	String	Bitcoin address to receive the inscriptions for the whole order
fee	Number	Miner fee that will be paid while inscribing the ordinals in sats/byte. (default=2 sats/byte)
referral	String	Referral code to earn up to 15% of the order service fee.

200: OK

{
    status: 'ok',
    ..., // input parameters
    charge: {
        ...
        "id": "815xxx-xxx-xxx-xxx79",
        "address": "3P...Vu",
        "amount": 1218725,
        "lightning_invoice": {
            "expires_at": 1675786558,
            "payreq": "lnbc1218...7qz9v"
        },
        "created_at": 1677176476,
    },
    chainFee: 718725 // in satoshis
    serviceFee: 100000, // in satoshis
    orderType: 'bulk',
    createdAt: 1675785959855, // timestamp in ms,
}

500: Internal Server Error

{
    status: 'error',
    error: 'error reason'
}