com.market0x/marketplace is an MCP server published by com.market0x, hosted at www.market0x.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 13 tools, including list_micro_markets, get_listings, get_listing_details, get_recent_trades, prepare_purchase.
Buy, sell and bid on vote-escrow NFTs and .base.eth names. Non-custodial, settles on Seaport.
1,043 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the markets this marketplace facilitates (asset, chain, currencies, fee).
No parameters.
{
"name": "list_micro_markets",
"description": "List the markets this marketplace facilitates (asset, chain, currencies, fee).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| kind | string | one of ["listing","dutch_auction","offer"] |
| limit | number | |
| marketId * | string | market id, e.g. 'vehydx' |
| nameContains | string | case-insensitive substring match on the listing's label (the name on name markets, e.g. 'alice'; 'veAERO #123' elsewhere) |
| minDiscountPct | number | only return orders at >= this discount %. IGNORED on markets whose asset has no priced underlying, where there is nothing to compare the ask against — the response says so in `note` rather than returning an empty market. |
{
"name": "get_listings",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"marketId"
],
"properties": {
"kind": {
"enum": [
"listing",
"dutch_auction",
"offer"
],
"type": "string"
},
"limit": {
"type": "number",
"maximum": 100,
"minimum": 1
},
"marketId": {
"type": "string",
"description": "market id, e.g. 'vehydx'"
},
"nameContains": {
"type": "string",
"maxLength": 64,
"description": "case-insensitive substring match on the listing's label (the name on name markets, e.g. 'alice'; 'veAERO #123' elsewhere)"
},
"minDiscountPct": {
"type": "number",
"description": "only return orders at >= this discount %. IGNORED on markets whose asset has no priced underlying, where there is nothing to compare the ask against — the response says so in `note` rather than returning an empty market."
}
}
}
}Full detail for one order including a FRESH live-contents snapshot (principal, claimable rewards, voting/earning power, as_of_block).
| Parameter | Type | Description |
|---|---|---|
| orderHash * | string |
{
"name": "get_listing_details",
"description": "Full detail for one order including a FRESH live-contents snapshot (principal, claimable rewards, voting/earning power, as_of_block).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"orderHash"
],
"properties": {
"orderHash": {
"type": "string"
}
}
}
}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).
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| marketId * | string |
{
"name": "get_recent_trades",
"description": "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).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"marketId"
],
"properties": {
"limit": {
"type": "number",
"maximum": 100,
"minimum": 1
},
"marketId": {
"type": "string"
}
}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| orderHash * | string |
{
"name": "prepare_purchase",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"orderHash"
],
"properties": {
"orderHash": {
"type": "string"
}
}
}
}Prepare a BID/offer on a position: returns the Seaport order to sign (EIP-712), the currency approval needed, and how to submit it. The agent reads its Seaport counter, signs, and POSTs the signed order — settlement stays on Seaport. The buyer wallet must hold the offer's outlay (price + its fee share) when it submits; an unfunded offer is rejected (insufficient_balance), and one that later loses its funds or allowance is hidden from the book until they return.
| Parameter | Type | Description |
|---|---|---|
| name | string | name markets only, e.g. 'alice' or 'alice.base.eth' — tokenId is derived |
| buyer * | string | 0x address that will sign and fund the offer |
| tokenId | string | required for token markets (e.g. vehydx) |
| marketId * | string | |
| offerAmount * | string | human amount the seller nets, e.g. '750' — must be positive |
| durationDays | number | |
| currencySymbol * | string | one of the market's settlementCurrencies (see list_micro_markets). A symbol resolves per market, so the same symbol can name different contracts: 'AERO' is the NEW Aero token (0x3f5b…a4Ee) on saero and the legacy Aerodrome token (0x9401…8631) on veaero. Check the address in list_micro_markets. |
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. Never signs or holds keys.
| Parameter | Type | Description |
|---|---|---|
| ask | string | listing: price the seller nets — must be positive |
| kind * | string | one of ["listing","dutch_auction"] |
| name | string | name markets only, e.g. 'alice' or 'alice.base.eth' — tokenId is derived |
| endAsk | string | dutch_auction: floor price (must be below the start) |
| seller * | string | |
| tokenId | string | required for token markets (e.g. vehydx) |
| marketId * | string | |
| startAsk | string | dutch_auction: starting (high) price |
| durationDays | number | |
| currencySymbol * | string | one of the market's settlementCurrencies (see list_micro_markets). A symbol resolves per market, so the same symbol can name different contracts: 'AERO' is the NEW Aero token (0x3f5b…a4Ee) on saero and the legacy Aerodrome token (0x9401…8631) on veaero. Check the address in list_micro_markets. |
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.
| Parameter | Type | Description |
|---|---|---|
| orderHash * | string |
{
"name": "prepare_cancel",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"orderHash"
],
"properties": {
"orderHash": {
"type": "string"
}
}
}
}List orders created by an address (its listings, auctions, offers). Status is reconciled by the background worker — treat as advisory until checked at fill.
| Parameter | Type | Description |
|---|---|---|
| status | string | one of ["active","filled","cancelled","expired"] |
| offerer * | string |
{
"name": "get_orders",
"description": "List orders created by an address (its listings, auctions, offers). Status is reconciled by the background worker — treat as advisory until checked at fill.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"offerer"
],
"properties": {
"status": {
"enum": [
"active",
"filled",
"cancelled",
"expired"
],
"type": "string"
},
"offerer": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
}
}
}
}List the positions an address owns in a market, with listability (voted/attached positions can't transfer).
| Parameter | Type | Description |
|---|---|---|
| owner * | string | |
| marketId * | string |
{
"name": "get_owned_positions",
"description": "List the positions an address owns in a market, with listability (voted/attached positions can't transfer).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"marketId",
"owner"
],
"properties": {
"owner": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"marketId": {
"type": "string"
}
}
}
}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))).
| Parameter | Type | Description |
|---|---|---|
| events * | array | |
| wallet * | string | |
| chainId * | integer | chain the wallet signs on; it is part of the signed message |
| channel * | string | one of ["webhook","inapp"] |
| signature | string | EIP-191 signature of the canonical message; omit to receive the message to sign |
| timestamp * | number | unix seconds; must be within 10 minutes of now |
| webhookUrl | string | https URL; required for the webhook channel |
| savedSearch | object |
List a wallet's notification subscriptions (webhook URLs redacted to origin).
| Parameter | Type | Description |
|---|---|---|
| wallet * | string |
{
"name": "list_subscriptions",
"description": "List a wallet's notification subscriptions (webhook URLs redacted to origin).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"wallet"
],
"properties": {
"wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
}
}
}
}Delete a notification subscription. Two-step like subscribe_notifications: call without `signature` to get the message to sign. `chainId` is signed over and verified on that chain. Signed messages are single-use.
| Parameter | Type | Description |
|---|---|---|
| wallet * | string | |
| chainId * | integer | chain the wallet signs on; it is part of the signed message |
| signature | string | |
| timestamp * | number | |
| subscriptionId * | string |
{
"name": "unsubscribe_notifications",
"description": "Delete a notification subscription. Two-step like subscribe_notifications: call without `signature` to get the message to sign. `chainId` is signed over and verified on that chain. Signed messages are single-use.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"wallet",
"chainId",
"subscriptionId",
"timestamp"
],
"properties": {
"wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"chainId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "chain the wallet signs on; it is part of the signed message"
},
"signature": {
"type": "string"
},
"timestamp": {
"type": "number"
},
"subscriptionId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
}
}
}Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "prepare_offer",
"description": "Prepare a BID/offer on a position: returns the Seaport order to sign (EIP-712), the currency approval needed, and how to submit it. The agent reads its Seaport counter, signs, and POSTs the signed order — settlement stays on Seaport. The buyer wallet must hold the offer's outlay (price + its fee share) when it submits; an unfunded offer is rejected (insufficient_balance), and one that later loses its funds or allowance is hidden from the book until they return.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"marketId",
"currencySymbol",
"offerAmount",
"buyer"
],
"properties": {
"name": {
"type": "string",
"description": "name markets only, e.g. 'alice' or 'alice.base.eth' — tokenId is derived"
},
"buyer": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "0x address that will sign and fund the offer"
},
"tokenId": {
"type": "string",
"description": "required for token markets (e.g. vehydx)"
},
"marketId": {
"type": "string"
},
"offerAmount": {
"type": "string",
"pattern": "^\\d+(\\.\\d+)?$",
"description": "human amount the seller nets, e.g. '750' — must be positive"
},
"durationDays": {
"type": "number",
"maximum": 90,
"minimum": 1
},
"currencySymbol": {
"enum": [
"USDC",
"WETH",
"HYDX",
"AERO",
"USDT",
"THE",
"KITTEN",
"NEST",
"USDG",
"UP"
],
"type": "string",
"description": "one of the market's settlementCurrencies (see list_micro_markets). A symbol resolves per market, so the same symbol can name different contracts: 'AERO' is the NEW Aero token (0x3f5b…a4Ee) on saero and the legacy Aerodrome token (0x9401…8631) on veaero. Check the address in list_micro_markets."
}
}
}
}{
"name": "prepare_listing",
"description": "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. Never signs or holds keys.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"marketId",
"kind",
"currencySymbol",
"seller"
],
"properties": {
"ask": {
"type": "string",
"pattern": "^\\d+(\\.\\d+)?$",
"description": "listing: price the seller nets — must be positive"
},
"kind": {
"enum": [
"listing",
"dutch_auction"
],
"type": "string"
},
"name": {
"type": "string",
"description": "name markets only, e.g. 'alice' or 'alice.base.eth' — tokenId is derived"
},
"endAsk": {
"type": "string",
"pattern": "^\\d+(\\.\\d+)?$",
"description": "dutch_auction: floor price (must be below the start)"
},
"seller": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"tokenId": {
"type": "string",
"description": "required for token markets (e.g. vehydx)"
},
"marketId": {
"type": "string"
},
"startAsk": {
"type": "string",
"pattern": "^\\d+(\\.\\d+)?$",
"description": "dutch_auction: starting (high) price"
},
"durationDays": {
"type": "number",
"maximum": 90,
"minimum": 1
},
"currencySymbol": {
"enum": [
"USDC",
"WETH",
"HYDX",
"AERO",
"USDT",
"THE",
"KITTEN",
"NEST",
"USDG",
"UP"
],
"type": "string",
"description": "one of the market's settlementCurrencies (see list_micro_markets). A symbol resolves per market, so the same symbol can name different contracts: 'AERO' is the NEW Aero token (0x3f5b…a4Ee) on saero and the legacy Aerodrome token (0x9401…8631) on veaero. Check the address in list_micro_markets."
}
}
}
}{
"name": "subscribe_notifications",
"description": "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))).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"wallet",
"chainId",
"channel",
"events",
"timestamp"
],
"properties": {
"events": {
"type": "array",
"items": {
"enum": [
"order_filled",
"offer_received",
"saved_search"
],
"type": "string"
}
},
"wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"chainId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "chain the wallet signs on; it is part of the signed message"
},
"channel": {
"enum": [
"webhook",
"inapp"
],
"type": "string"
},
"signature": {
"type": "string",
"description": "EIP-191 signature of the canonical message; omit to receive the message to sign"
},
"timestamp": {
"type": "number",
"description": "unix seconds; must be within 10 minutes of now"
},
"webhookUrl": {
"type": "string",
"format": "uri",
"description": "https URL; required for the webhook channel"
},
"savedSearch": {
"type": "object",
"required": [
"marketId"
],
"properties": {
"kind": {
"enum": [
"listing",
"dutch_auction"
],
"type": "string"
},
"marketId": {
"type": "string"
},
"nameContains": {
"type": "string",
"maxLength": 64,
"description": "name markets: substring match on listed names"
}
}
}
}
}
}