# DIGIRARE Marketplace API

> Live HTTP API for the DIGIRARE marketplace of curated Counterparty collectibles on Bitcoin mainnet: read order books, sign in with BIP-322, list, buy, and make offers. The API composes and verifies PSBTs; you sign locally. The public SDK is coming soon; use HTTP and openapi.json today.

## Essentials

- Live HTTP API prefix: https://api.digirare.com/v1 . Documentation: https://api.digirare.com/docs/ . Bitcoin mainnet. The public SDK is coming soon; use HTTP directly or generate a client from OpenAPI. Marketplace source code is currently private.
- Public reads need no API key. Account actions use a 24-hour address session: POST /v1/auth/challenge, sign the returned message, POST /v1/auth/verify, then send x-session-token. Sessions do not sign transactions.
- Success: {"result": ...}. Paged reads also include result_count and next_cursor. Errors: {"error": "...", "code": "..."}. Branch on code, not message text.
- Keys stay local. Review the PSBT and sign only the specified inputs with the specified sighash. Return signed PSBT hex; never send private keys.
- Trading signers: P2WPKH or P2TR. Detached delivery supports any Counterparty address family. A separate P2PKH, P2WPKH, or P2TR source may sign its own attach inputs.
- BTC values are integer satoshis; raw asset quantities are decimal strings. Canonical asset IDs identify assets; asset_longname is display metadata.
- Prices start at 5,000 sats. Asks are capped at 100 BTC; funded offers have no equivalent ask cap. The taker pays 2.5% rounded up, minimum 1,000 sats, plus the settlement network fee.
- Buy: POST /v1/fills/request -> review and sign -> POST /v1/fills/complete with the buyer session. Quotes reserve nothing. A 409 checkout_changed requires a fresh quote and signature. Delivery defaults to detached; attached delivery is limited to one acquired unit at the buyer address.
- List: POST /v1/listing-preflights -> follow next_action -> submit the signed listing. A prepared unit needs no attach transaction; otherwise sign and submit the attach first. Sign only listing.inputs_to_sign with SINGLE|ANYONECANPAY.
- Offers: exact_offer_v1 authorizes named asset outpoints. funded_policy_offer_v1 covers any qualifying prepared unit during its lifetime. Alternatives sharing funding_slot_id represent one possible purchase, not independent liquidity.
- Limits: quote/composition writes 20/minute per route/address, 120 per route/IP; signed completions 120/600; auth 60 per route/IP. Uncached reads share 300/1,800 address/IP budgets; recovery reads and account maintenance have separate budgets. See the limits guide for categories and exceptions.
- On 429, honor Retry-After. A timeout or 5xx does not prove a write failed: read saved operation status before retrying or signing another transaction.
- GET /v1/address/{address}/events requires the owner session. Poll the first page with overlap and deduplicate by event_id. GET /v1/events and GET /v1/analytics are public.
- Cancellation removes an order from marketplace execution; Bitcoin revocation requires spending its signed input. Read the workflow guide before releasing funds.

## Guides

- [Quickstart](https://api.digirare.com/docs/quickstart/): Make your first request, understand the response, and choose a trading workflow.
- [Market data](https://api.digirare.com/docs/guides/market-data/): Read collections, order books, activity, and analytics without authentication.
- [Authentication](https://api.digirare.com/docs/authentication/): Create a wallet session, send authenticated requests, and choose signing and delivery addresses.
- [Fees and prices](https://api.digirare.com/docs/fees-and-prices/): The taker pays 2.5% (minimum 1,000 sats); every price is at least 5,000 sats; everything is integer satoshis.
- [Listing](https://api.digirare.com/docs/guides/listing/): Prepare units, list prepared inventory, attach-and-list, reprice, and delist.
- [Buying](https://api.digirare.com/docs/guides/buying/): Buy available units, choose delivery, and handle changed or interrupted checkouts.
- [Offers](https://api.digirare.com/docs/guides/offers/): Exact-target offers over funding slots, and collection or trait offers (funded_policy_offer_v1) any holder can accept.
- [Events](https://api.digirare.com/docs/guides/events/): One owner feed of what happened to your listings, offers, and purchases, newest first.
- [Limits and errors](https://api.digirare.com/docs/guides/limits-and-errors/): Rate limits, request bounds, the typed error codes, and what is safe to retry.
- [Recovery](https://api.digirare.com/docs/guides/recovery/): What to check when a request times out, a wallet rejects, or a bot stops halfway.
- [SDK — coming soon](https://api.digirare.com/docs/guides/sdk/): The public SDK is coming soon. Integrate with the live HTTP API today.
- [Glossary](https://api.digirare.com/docs/glossary/): Asset UTXO, attach and detach, funding slot, collection offer, anchor, and the other terms the API uses.

## Reference

- [API reference](https://api.digirare.com/docs/reference/): every operation, rendered from openapi.json at build time
- [OpenAPI document](https://api.digirare.com/docs/openapi.json): the public HTTP contract

## Optional

- [llms-full.txt](https://api.digirare.com/docs/llms-full.txt): every guide inline plus the endpoint list