Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Satflow

Build transaction — LIST, CANCEL, BUY

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
typestring · enumRequiredPossible values:
userAddressstringRequiredExample: tb1qg5s9rdd9ddhacql3upd7ntzrexp3kn95v4hndm
inscriptionIdstringOptional
priceInSatsstringOptional
orderIdsstring[]Optional
orderTypestringOptional
inscriptionIdsstring[]Optional

Inscription IDs to buy

Responses
201Success
No content
post/api/satflow/build
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
typestring · enumRequiredPossible values:
userAddressstringRequiredExample: tb1qg5s9rdd9ddhacql3upd7ntzrexp3kn95v4hndm
signedPsbtstringOptional
intentIdstringRequired
signedChallengestringOptional
signedSecureListingPsbtsstring[]Optional
signedPaymentPrepPsbtsstring[]Optional
signedPurchasePsbtsstring[]Optional
signedTransferPsbtstringOptional
feeRatenumberOptional
Responses
201Success
No content
post/api/satflow/sign
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
inscriptionIdstringRequired

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

userAddressstringRequiredExample: tb1qg5s9rdd9ddhacql3upd7ntzrexp3kn95v4hndm
Responses
201Success
No content
post/api/satflow/buy/revert
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
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
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
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
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
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
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
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
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
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}
GET /api/satflow/status/{intentId} HTTP/1.1
Host: api.radfi.co
Accept: */*
200Success
No content
PreviousDownload Histories
NextWhich First

Last updated