Airdrop

The airdrop consists of two steps:

1. PSBT construction

2. Order creation & broadcast

1. PSBT Construction

POST https://api.ordinalsbot.com/runes/airdrop

Receives the airdrop data and returns the PSBT to be signed

Headers

Body

Name	Type	Description
runeName*	String	Rune name with spacers
perAddressAmount*	Number	Amount to distribute to each address
runeSenderAddress*	String	Bitcoin address containing the necessary rune amount
btcSenderAddress*	String	Bitcoin address containing the necessary btc amount for network fees and postage
receiverAddresses*	Array	Array of addresses to receive the airdrop (max 2000 addresses)
feeRate*	Number	Fee rate in sats/vB

Response

200: OK

{
    "psbts": 
        [
            "cHNidP8BAHECAAAAAfPQ0OTWpSxwRJK...",
            "cHNidP8BAHECAAAAAfPQ0OTWpSxwRJK..."
        ]
}

500: Internal Server Error

{
    "status": "error",
    "error": "error reason"
}

400: Bad Request

2. Order creation & broadcast

POST https://api.ordinalsbot.com/runes/airdrop-psbt

Receives the signed PSBTs, creates an order and broadcasts the transaction

Body

Name	Type	Description
psbts	Array	Array of signed PSBTs in base64 to broadcast

Response

200: OK

{
    "runeName": "RuneName",
    "psbts": [
        "cHNidP8BAHECAAAAAfPQ0OTWpSxwRJK..."
    ],
    "orderType": "rune-airdrop",
    "id": "76d1a25b-1e56-4476-8a98-d248f1ab5f95",
    "status": "ok",
    "state": "queued",
    "createdAt": {
        ".sv": "timestamp"
    }
}

500: Internal Server Error

{
    "status": "error",
    "error": "error reason"
}

400: Bad Request

{
  "error": "Invalid request"
}