Connection check
verified live · 20h ago
carbonmark-marketplace
Buy, sell and bid on vote-escrow NFTs and .base.eth names. Non-custodial, settles on Seaport.
Tools
15
GitHub stars
—
Installs / wk
—
Licence
—
Transport
streamable-http
Last checked
20h ago
Tools & capabilities
15 toolsRead from the running server on 20h ago.
get_listing_details
orderHash*
Full detail for one order including a FRESH live-contents snapshot (principal, claimable rewards, voting/earning power, as_of_block). Full detail for one order including a FRESH live-contents snapshot (principal, claimable rewards, voting/earning power, as_of_block).
get_listings
kindlimitmarketId*nameContainsminDiscountPct
Active listings/auctions for a market. Each row carries the ask and the position's underlying contents priced at current market (published formula: /docs#data-sources), plus discou… Active listings/auctions for a market. Each row carries the ask and the position's underlying contents priced at current market (published formula: /docs#data-sources), plus discountPct (the difference between them). Sorted by discount percentage, descending.
get_orders
statusofferer*
List orders created by an address (its listings, auctions, offers). Status is reconciled by the background worker — treat as advisory until checked at fill. List orders created by an address (its listings, auctions, offers). Status is reconciled by the background worker — treat as advisory until checked at fill.
get_owned_positions
owner*marketId*
List the positions an address owns in a market, with listability (voted/attached positions can't transfer). List the positions an address owns in a market, with listability (voted/attached positions can't transfer).
get_recent_trades
limitmarketId*
Recently settled sales for a market. `amount` is the EXACT settled total (incl. fee) from the on-chain fill where the indexer recorded it, with `settledAt` the block time and `exac… Recently settled sales for a market. `amount` is the EXACT settled total (incl. fee) from the on-chain fill where the indexer recorded it, with `settledAt` the block time and `exact: true`; otherwise it falls back to the listed ask with `exact: false` (a decayed Dutch auction settles BELOW its listed amount, so treat inexact rows as an upper bound).
list_micro_markets
List the markets this marketplace facilitates (asset, chain, currencies, fee). List the markets this marketplace facilitates (asset, chain, currencies, fee).
list_subscriptions
wallet*
List a wallet's notification subscriptions (webhook URLs redacted to origin). List a wallet's notification subscriptions (webhook URLs redacted to origin).
prepare_cancel
orderHash*
Prepare the on-chain Seaport cancel transaction for an active order. Only the order's offerer can execute it (Seaport enforces msg.sender == offerer), so the calldata is safe to re… Prepare the on-chain Seaport cancel transaction for an active order. Only the order's offerer can execute it (Seaport enforces msg.sender == offerer), so the calldata is safe to return. After it confirms, POST { txHash } to the confirm endpoint to update the book.
prepare_finalize
name*owner*marketId*setPrimary
Prepare the post-purchase FINALIZE transactions for a Basename you now own: reclaim management rights, set the resolver, and point the name at your address (optionally set it as yo… Prepare the post-purchase FINALIZE transactions for a Basename you now own: reclaim management rights, set the resolver, and point the name at your address (optionally set it as your primary name). A sale transfers the NFT but NOT the ENS registry management — until reclaim runs, the PREVIOUS owner can still change the name's resolver and records. Run this straight after a fill. Returns ordered calldata; the agent's own wallet signs and submits, and every call is msg.sender-enforced on-chain so the package is only usable by the owner.
prepare_listing
askkind*nameendAskseller*tokenId
+4
Prepare a SELL listing or Dutch auction. Verifies the seller OWNS the position and it's transferable (not voted/attached), builds the Seaport order with the Interface fee injected… Prepare a SELL listing or Dutch auction. Verifies the seller OWNS the position and it's transferable (not voted/attached), builds the Seaport order with the Interface fee injected by the server, and returns the one-time NFT approval + EIP-712 typed data to sign. Name markets (basenames) take `name` instead of tokenId. Never signs or holds keys.
prepare_offer
namebuyer*tokenIdmarketId*offerAmount*durationDays
+1
Prepare a BID/offer on a position: returns the Seaport order to sign (EIP-712), the currency approval needed, and how to submit it. Name markets (basenames) take `name` instead of… Prepare a BID/offer on a position: returns the Seaport order to sign (EIP-712), the currency approval needed, and how to submit it. Name markets (basenames) take `name` instead of tokenId — any REGISTERED name is biddable, listed or not. The agent reads its Seaport counter, signs, and POSTs the signed order — settlement stays on Seaport.
prepare_purchase
orderHash*
Prepare the non-custodial transaction package to BUY a listing (or accept an offer): ordered approvals + Seaport fulfillOrder calldata + a fresh contents snapshot. prepared.summary… Prepare the non-custodial transaction package to BUY a listing (or accept an offer): ordered approvals + Seaport fulfillOrder calldata + a fresh contents snapshot. prepared.summary quotes the CURRENT price (Dutch auctions interpolate, asOf says when); the approval grants approveBaseUnits — slightly above the quote on a decaying order, never above maxTotalBaseUnits — and Seaport charges the exact interpolated amount at fill. On auctions, prepared.cleanup is an optional post-settlement tx that zeroes the residual allowance. The agent's own wallet signs and submits — this never signs or holds keys.
search_names
qlimitoffsettraitsclasseslengths
+1
Search the Basenames REGISTRY — every registered name, listed or not — by substring, length, character class and trait, with each row's owner, expiry and (when for sale) its order… Search the Basenames REGISTRY — every registered name, listed or not — by substring, length, character class and trait, with each row's owner, expiry and (when for sale) its order hash. This is the discovery surface for `prepare_offer`, which can bid on any registered name whether or not it is listed; without it an agent has no way to learn a name exists. Name markets only.
subscribe_notifications
events*wallet*chainId*channel*signaturetimestamp*
+2
Subscribe a wallet to push notifications (order_filled / offer_received / saved_search) via an HMAC-signed webhook — the agent-native alternative to polling. Two-step: call WITHOUT… Subscribe a wallet to push notifications (order_filled / offer_received / saved_search) via an HMAC-signed webhook — the agent-native alternative to polling. Two-step: call WITHOUT `signature` to get the exact message to sign (EIP-191 personal_sign), then call again WITH the signature. `chainId` is signed over and the signature is verified on THAT chain, so pass the chain the wallet actually signs on (smart-wallet signatures do not validate cross-chain). Each signed message is SINGLE-USE: resending the same body returns 409 replayed_signature — retry with a fresh timestamp and a new signature. The response includes the webhook HMAC secret ONCE (verify x-market0x-signature = hex(HMAC-SHA256(rawBody, secret))).
unsubscribe_notifications
wallet*chainId*signaturetimestamp*subscriptionId*