# Ordinals Marketplace

> This skill should be used when working with 1Sat Ordinals marketplace operations — listing ordinals for sale, purchasing listings, canceling listings, browsing available ordinals, or managing OrdLock marketplace scripts. Triggers on 'list ordinal', 'sell NFT', 'buy ordinal', 'purchase listing', 'cancel listing', 'marketplace', 'OrdLock', 'ordinal price', or 'browse ordinals'. Uses @1sat/actions ordinals module.

- Skill: `b-open-io/ordinals-marketplace` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add b-open-io/ordinals-marketplace`
- Raw SKILL.md: https://api.skillmd.com/api/skills/b-open-io/ordinals-marketplace/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: b-open-io (https://skillmd.com/u/b-open-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/b-open-io/ordinals-marketplace

---


# Ordinals Marketplace

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

## Actions (id-first)

| Action | Description |
|--------|-------------|
| `listOrdinals` | List wallet ordinals (metadata/tags default; optional BEEF) |
| `sendOrdinals` | Send ordinals (`id` per transfer, or pre-loaded row) |
| `sellOrdinal` | Put on market (`{ id, price, payAddress? }`) |
| `cancelOrdinalListing` | Cancel listing (`{ id }`) |
| `buyOrdinal` | Buy external listing (`{ outpoint, inputBEEF? }`) |
| `burnOrdinals` | Burn (`{ ids }` or pre-loaded rows) |


## 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

```typescript
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

```typescript
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

```typescript
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

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

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

## Cancel

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

await cancelOrdinalListing.execute(ctx, { id })
```

## Burn

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

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

## Tags

| Tag | Meaning |
|-----|---------|
| `id:{…}` | Tracking id |
| `ordlock` | Listed |
| `price:{n}` | List price (sats) |
| `type:{contentType}` | MIME |
| `origin:{outpoint}` | Origin |
| `name:{value}` | MAP name |

## Requirements

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