Satflow

Build transaction — LIST, CANCEL, BUY

post

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

typestring · enumRequiredPossible values:

userAddressstringRequiredExample: tb1qg5s9rdd9ddhacql3upd7ntzrexp3kn95v4hndm

inscriptionIdstringOptional

priceInSatsstringOptional

orderIdsstring[]Optional

orderTypestringOptional

inscriptionIdsstring[]Optional

Inscription IDs to buy

Responses

201Success

post

/api/satflow/build

HTTPcURLJavaScriptPython

POST /api/satflow/build HTTP/1.1
Host: api.radfi.co
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 191

{
  "type": "satflow-list",
  "userAddress": "tb1qg5s9rdd9ddhacql3upd7ntzrexp3kn95v4hndm",
  "inscriptionId": "text",
  "priceInSats": "text",
  "orderIds": [
    "text"
  ],
  "orderType": "text",
  "inscriptionIds": [
    "text"
  ]
}

201Success

No content

Submit signed transaction to Satflow

post

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

typestring · enumRequiredPossible values:

userAddressstringRequiredExample: tb1qg5s9rdd9ddhacql3upd7ntzrexp3kn95v4hndm

signedPsbtstringOptional

intentIdstringRequired

signedChallengestringOptional

signedSecureListingPsbtsstring[]Optional

signedPaymentPrepPsbtsstring[]Optional

signedPurchasePsbtsstring[]Optional

signedTransferPsbtstringOptional

feeRatenumberOptional

Responses

201Success

post

/api/satflow/sign

HTTPcURLJavaScriptPython

POST /api/satflow/sign HTTP/1.1
Host: api.radfi.co
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 286

{
  "type": "satflow-list",
  "userAddress": "tb1qg5s9rdd9ddhacql3upd7ntzrexp3kn95v4hndm",
  "signedPsbt": "text",
  "intentId": "text",
  "signedChallenge": "text",
  "signedSecureListingPsbts": [
    "text"
  ],
  "signedPaymentPrepPsbts": [
    "text"
  ],
  "signedPurchasePsbts": [
    "text"
  ],
  "signedTransferPsbt": "text",
  "feeRate": 1
}

201Success

No content

Revert a pending BUY intent — rolls back UMS state for any sub-txids registered so far

post

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

inscriptionIdstringRequired

Inscription ID of the BUY intent to revert (FE tracks this, not the server-generated txId)

userAddressstringRequiredExample: tb1qg5s9rdd9ddhacql3upd7ntzrexp3kn95v4hndm

Responses

201Success

post

/api/satflow/buy/revert

HTTPcURLJavaScriptPython

POST /api/satflow/buy/revert HTTP/1.1
Host: api.radfi.co
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 83

{
  "inscriptionId": "text",
  "userAddress": "tb1qg5s9rdd9ddhacql3upd7ntzrexp3kn95v4hndm"
}

201Success

No content

Get inscription item details from Satflow

get

Query parameters

inscriptionIdstringOptional

inscriptionNumberstringOptional

metadatabooleanOptional

bidbooleanOptional

listingbooleanOptional

exclude_ordbooleanOptional

Responses

200Success

No content

get

/api/satflow/item

HTTPcURLJavaScriptPython

GET /api/satflow/item HTTP/1.1
Host: api.radfi.co
Accept: */*

200Success

No content

Get floor orders for collections from Satflow

get

Query parameters

collectionIdsstring[]Optional

Single value (?collectionIds=a), CSV (?collectionIds=a,b), or repeat-key (?collectionIds[]=a&collectionIds[]=b)

Responses

200Success

No content

get

/api/satflow/orders/floor

HTTPcURLJavaScriptPython

GET /api/satflow/orders/floor HTTP/1.1
Host: api.radfi.co
Accept: */*

200Success

No content

Get collection statistics from Satflow

get

Query parameters

collectionIdstringOptional

Responses

200Success

No content

get

/api/satflow/collection-stats

HTTPcURLJavaScriptPython

GET /api/satflow/collection-stats HTTP/1.1
Host: api.radfi.co
Accept: */*

200Success

No content

Get floor prices for multiple ordinals collections from Satflow

get

Query parameters

slugsstring[]Required

Single value (?slugs=a), CSV (?slugs=a,b), or repeat-key (?slugs[]=a&slugs[]=b)

Responses

200Success

No content

get

/api/satflow/collection-stats/floors

HTTPcURLJavaScriptPython

GET /api/satflow/collection-stats/floors?slugs=text HTTP/1.1
Host: api.radfi.co
Accept: */*

200Success

No content

Get activity listings from Satflow

get

Query parameters

collectionSlugstringOptional

groupstring · enumOptionalPossible values:

activebooleanOptional

pagenumberOptional

pageSizenumberOptional

externalbooleanOptional

timeRangestring · enumOptionalPossible values:

includeOnlyCollectionItemsbooleanOptional

sortBystring · enumOptionalPossible values:

sortDirectionstring · enumOptionalPossible values:

Responses

200Success

No content

get

/api/satflow/listings

HTTPcURLJavaScriptPython

GET /api/satflow/listings HTTP/1.1
Host: api.radfi.co
Accept: */*

200Success

No content

Get wallet contents from Satflow — ordinals and runes with listing/bid status

get

Query parameters

addressstringRequired

itemTypestring · enumOptionalPossible values:

collectionstringOptional

listedOnlybooleanOptional

bidsOnlybooleanOptional

cursornumberOptional

limitnumberOptional

Responses

200Success

No content

get

/api/satflow/wallet-contents

HTTPcURLJavaScriptPython

GET /api/satflow/wallet-contents?address=text HTTP/1.1
Host: api.radfi.co
Accept: */*

200Success

No content

Get trending collections from Satflow memflow

get

Query parameters

sortBystringOptional

sortDirectionstring · enumOptionalPossible values:

offsetnumberOptional

limitnumberOptional

Responses

200Success

No content

get

/api/satflow/collections/trending

HTTPcURLJavaScriptPython

GET /api/satflow/collections/trending HTTP/1.1
Host: api.radfi.co
Accept: */*

200Success

No content

Get inscription details for a collection (paginated, max 10 per page)

get

Query parameters

collection_idstringRequired

pagenumberOptional

Page number, 1-indexed (default 1)

pageSizenumberOptional

Items per page, max 10 — BE fans out 1 /item call per id (default 10)

Responses

200Success

No content

get

/api/satflow/collection/inscriptions

HTTPcURLJavaScriptPython

GET /api/satflow/collection/inscriptions?collection_id=text HTTP/1.1
Host: api.radfi.co
Accept: */*

200Success

No content

Get active listings for a collection (paginated, sorted by price)

get

Query parameters

collectionIdstringRequired

Satflow collection slug (e.g. "nodemonkes")

pagenumberOptional

Page number, 1-indexed (default 1)

pageSizenumberOptional

Items per page (1–20, default 20) — listings are enriched from a metadata cache; only uncached inscriptions trigger a /item call

sortDirectionstring · enumOptional

Sort by listing price (default asc)

Possible values:

Responses

200Success

No content

get

/api/satflow/collection/listings

HTTPcURLJavaScriptPython

GET /api/satflow/collection/listings?collectionId=text HTTP/1.1
Host: api.radfi.co
Accept: */*

200Success

No content

Get intent status by intent ID (Mongo _id)

get

Path parameters

intentIdstringRequired

Responses

200Success

No content

get

/api/satflow/status/{intentId}

HTTPcURLJavaScriptPython

GET /api/satflow/status/{intentId} HTTP/1.1
Host: api.radfi.co
Accept: */*

200Success

No content