Search Order

Search an order by orderId

get

It's recommended to query the latest status every 10 seconds.

amount = outputValue*count + minerFee + serviceFee + devFee

Authorizations

Path parameters

orderIdstringRequired

Responses

200

Successful operation

application/json

401

Invalid API Key

get

HTTPcURLJavaScriptPython

GET /v2/inscribe/order/{orderId} HTTP/1.1
Host: open-api-fractal.unisat.io
Authorization: Bearer JWT
Accept: */*

{
  "code": 1,
  "msg": "OK",
  "data": {
    "orderId": "",
    "status": "pending",
    "payAddress": "",
    "receiveAddress": "",
    "amount": 3000,
    "paidAmount": 1,
    "outputValue": 1,
    "feeRate": 1,
    "minerFee": 1,
    "serviceFee": 1,
    "devFee": 1,
    "files": [
      {
        "filename": "10000.sats",
        "inscriptionId": "",
        "status": "pending"
      }
    ],
    "count": 1,
    "pendingCount": 1,
    "unconfirmedCount": 0,
    "confirmedCount": 0,
    "createTime": 1693439128100,
    "refundTxid": "",
    "refundAmount": 1,
    "refundFeeRate": 1
  }
}

enum OrderStatus {
    // when create order
    pending = 'pending',
    
    // pay not enough, need pay more
    payment_notenough = 'payment_notenough',
    
    // pay over, need choose continue or refund
    payment_overpay = 'payment_overpay',
    
    // there is an inscription in payment transaction, need refund
    payment_withinscription = 'payment_withinscription',
    
    // in some case, payment transaction need be confirmed
    payment_waitconfirmed = 'payment_waitconfirmed',
    
    // payment success
    payment_success = 'payment_success',
    
    // ready to inscribe
    ready = 'ready',
    inscribing = 'inscribing',
    minted = 'minted',
    closed = 'closed',
    refunded = 'refunded',
    cancel = 'cancel',
}


enum InscriptionStatus {
  pending = 'pending',
  unconfirmed = 'unconfirmed',
  confirmed = 'confirmed'
}