Ordinals Marketplace

Ordinals Marketplace

List, buy, send, and cancel ordinals with @1sat/actions (OrdLock).

Actions (id-first)

BEEF rules

• Wallet-owned spend: pass id only — action loads row + BEEF from the 1sat basket.
• External (buy): outpoint + inputBEEF if set; else services fetch; else error.

List

import { listOrdinals, createContext } from '@1sat/actions'

const ctx = createContext(wallet, { services })
const { outputs } = await listOrdinals.execute(ctx, { limit: 100 })

for (const o of outputs) {
  const id = o.tags?.find((t) => t.startsWith('id:'))?.slice(3)
  console.log(id, o.outpoint, o.tags)
}

Send

import { sendOrdinals } from '@1sat/actions'

await sendOrdinals.execute(ctx, {
  transfers: [{ id, counterparty: '02abc...' }],
})

await sendOrdinals.execute(ctx, {
  transfers: [{ id, address: '1Recipient...' }],
})

Self-sends carry tags and stay in the 1sat basket (no resolveOrdinalTags for owned filing).

Sell

import { sellOrdinal } from '@1sat/actions'

// payAddress optional — default P1SAT keyID `1sat 0`
await sellOrdinal.execute(ctx, { id, price: 100_000 })

Adds ordlock + price:{n} tags; keeps the 1sat basket.

Buy

import { buyOrdinal } from '@1sat/actions'

await buyOrdinal.execute(ctx, {
  outpoint: 'txid_0',
  // inputBEEF?: number[]
  marketplaceAddress: '1Market...', // optional
  marketplaceRate: 0.02,
})

Cancel

import { cancelOrdinalListing } from '@1sat/actions'

await cancelOrdinalListing.execute(ctx, { id })

Burn

import { burnOrdinals } from '@1sat/actions'

await burnOrdinals.execute(ctx, { ids: [id] })

Tags

Requirements

bun add @1sat/actions @1sat/wallet @bsv/sdk