SIBIDZ MCP
An official MCP server for SIBIDZ that enables AI agents to interact with its peer-to-peer collectible card auction marketplace. It provides tools for browsing items, inspecting offers, placing bids, managing accounts, and handling credits, facilitating automated trading and research within user-defined limits.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
Complete sign-in and enter any email code only on SIBIDZ, then approve the displayed application and account.Keep access and refresh tokens in the client, out of chat and logs.
MCP endpoint (Streamable HTTP)
https://sibidz.io/mcpWhat you can do with it
- Search for specific collectible cards
- Inspect auction terms and offers
- Place bids on items with permission
- Manage account status and credits
Source and maintenance
Vendor evidenceRegistry 8.12.5
Protocol and capabilities
- Server
- sibidz 8.12.8
- MCP protocol
- 2025-06-18
- Tools
- 9 advertised
- Resources
- 9 advertised
- Resource templates
- 8 advertised
- Prompts
- Not advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
},
"resources": {
"subscribe": true,
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
9 advertised
account — Manage your SIBIDZ account
Advertised destructiveOpen-world
Read setup status and manage account details or agreements. Sign in only on SIBIDZ during OAuth. Paid actions require request_id and max_fee. See auction://reference.
account input schema
{
"type": "object",
"$defs": {
"bio": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
]
},
"line": {
"anyOf": [
{
"$ref": "#/$defs/legal_name"
},
{
"type": "null"
}
]
},
"name": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"unit": {
"anyOf": [
{
"$ref": "#/$defs/unit_2"
},
{
"$ref": "#/$defs/unit_3"
}
]
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254
},
"method": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"sha256": {
"type": "string",
"maxLength": 64,
"minLength": 64
},
"unit_2": {
"type": "string",
"pattern": "^(?:(?:A(?:[EMU]D|[FZ]N|LL|OA|RS|WG)|B(?:AM|[BHMNSZ]D|DT|IF|O[BV]|RL|[TY]N|WP)|C(?:AD|DF|H[EFW]|L[FP]|NY|O[PU]|RC|UP|VE|ZK)|D(?:JF|KK|OP|ZD)|E(?:GP|RN|TB|UR)|F(?:JD|KP)|G(?:[BI]P|EL|HS|[MY]D|NF|TQ)|H(?:KD|NL|TG|UF)|I(?:[DNR]R|LS|QD|SK)|J(?:[MO]D|PY)|K(?:[EG]S|HR|MF|[PR]W|[WY]D|ZT)|L(?:AK|BP|KR|[RY]D|SL)|M(?:[AK]D|DL|GA|[MW]K|NT|OP|RU|[UVY]R|X[NV]|ZN)|N(?:[AZ]D|GN|IO|OK|PR)|OMR|P(?:AB|[EL]N|GK|HP|KR|YG)|QAR|R(?:ON|SD|UB|WF)|S(?:[AC]R|[BGR]D|DG|EK|[HSY]P|LE|OS|TN|VC|ZL)|T(?:HB|[JZ]S|MT|[NTW]D|OP|RY)|U(?:AH|GX|S[DN]|Y[IUW]|ZS)|V(?:E[DS]|ND|UV)|WST|X(?:A[DF]|C[DG]|[OP]F)|YER|Z(?:AR|MW|WG)))(?![\\s\\S])"
},
"unit_3": {
"type": "string",
"pattern": "^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}\\/[-a-z0-9]{3,8}:[-.%a-zA-Z0-9]{1,128}$"
},
"account": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"max_fee": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,19})$"
},
"version": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"avatar_id": {
"enum": [
"orbit",
"moon",
"spark",
"comet",
"prism",
"leaf",
"wave",
"peak",
"sun",
"planet",
"diamond",
"spiral"
]
},
"legal_name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"request_id": {
"type": "string",
"format": "uuid",
"pattern": "^([\\da-fA-F]{8}-[\\da-fA-F]{4}-[1-8][\\da-fA-F]{3}-[89abAB][\\da-fA-F]{3}-[\\da-fA-F]{12}|0{8}-0{4}-0{4}-0{4}-0{12}|f{8}-f{4}-f{4}-f{4}-f{12})$"
},
"website_url": {
"anyOf": [
{
"type": "string",
"format": "uri",
"maxLength": 2048
},
{
"type": "null"
}
]
},
"instructions": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"origin_regions": {
"type": "array",
"items": {
"type": "object",
"required": [
"country"
],
"properties": {
"city": {
"$ref": "#/$defs/method"
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"subdivision": {
"$ref": "#/$defs/method"
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"funding_accounts": {
"type": "object",
"properties": {
"grant_account_id": {
"type": "string",
"format": "uuid"
},
"normal_account_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}
},
"oneOf": [
{
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"enum": [
"status"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
}
},
"additionalProperties": false
},
{
"type": "object",
"oneOf": [
{
"required": [
"version",
"sha256",
"principal",
"authorized",
"electronic_consent",
"public_history_consent",
"age_18_or_over"
],
"properties": {
"step": {
"enum": [
"agreement"
]
},
"entry_id": false,
"settlement": false,
"application": false,
"settlement_account_id": false
}
},
{
"required": [
"application"
],
"properties": {
"step": {
"enum": [
"seller_application"
]
}
},
"propertyNames": {
"enum": [
"action",
"step",
"request_id",
"application",
"funding_accounts",
"max_fee"
]
}
},
{
"required": [
"settlement"
],
"properties": {
"step": {
"enum": [
"settlement"
]
}
},
"propertyNames": {
"enum": [
"settlement_account_id",
"settlement",
"action",
"step",
"request_id",
"funding_accounts",
"max_fee"
]
}
},
{
"required": [
"entry_id"
],
"properties": {
"step": {
"enum": [
"contact_withdrawal"
]
}
},
"propertyNames": {
"enum": [
"entry_id",
"action",
"step",
"request_id",
"funding_accounts",
"max_fee"
]
}
}
],
"required": [
"action",
"step",
"request_id"
],
"properties": {
"step": {},
"action": {
"enum": [
"continue"
]
},
"sha256": {
"$ref": "#/$defs/sha256"
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"version": {
"$ref": "#/$defs/version"
},
"entry_id": {
"$ref": "#/$defs/request_id"
},
"principal": {
"type": "object",
"required": [
"legal_name"
],
"properties": {
"country": {
"type": "string"
},
"legal_name": {
"$ref": "#/$defs/legal_name"
}
},
"additionalProperties": false
},
"authorized": {
"enum": [
true
]
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"settlement": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"label",
"unit",
"decimals",
"method",
"recipient",
"account"
],
"properties": {
"kind": {
"enum": [
"direct"
]
},
"unit": {
"$ref": "#/$defs/unit"
},
"label": {
"$ref": "#/$defs/version"
},
"method": {
"$ref": "#/$defs/method"
},
"account": {
"$ref": "#/$defs/account"
},
"decimals": {
"type": "integer",
"maximum": 255,
"minimum": 0
},
"recipient": {
"$ref": "#/$defs/legal_name"
},
"instructions": {
"$ref": "#/$defs/instructions"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"label",
"unit",
"method",
"country",
"recipient",
"account"
],
"properties": {
"kind": {
"enum": [
"fiat"
]
},
"unit": {
"$ref": "#/$defs/unit_2"
},
"label": {
"$ref": "#/$defs/version"
},
"method": {
"enum": [
"bank_transfer",
"payment_service"
]
},
"account": {
"$ref": "#/$defs/account"
},
"country": {
"type": "string"
},
"recipient": {
"$ref": "#/$defs/legal_name"
},
"instructions": {
"$ref": "#/$defs/instructions"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"label",
"unit",
"network",
"symbol",
"decimals",
"recipient",
"account"
],
"properties": {
"dti": {
"type": "string",
"pattern": "^[1-9B-DF-HJ-NP-TV-XZ][0-9B-DF-HJ-NP-TV-XZ]{8}$"
},
"kind": {
"enum": [
"crypto"
]
},
"memo": {
"$ref": "#/$defs/account"
},
"unit": {
"$ref": "#/$defs/unit_3"
},
"label": {
"$ref": "#/$defs/version"
},
"symbol": {
"type": "string",
"maxLength": 24,
"minLength": 1
},
"account": {
"$ref": "#/$defs/account"
},
"network": {
"type": "string",
"pattern": "^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$"
},
"decimals": {
"type": "integer",
"maximum": 255,
"minimum": 0
},
"recipient": {
"$ref": "#/$defs/legal_name"
},
"instructions": {
"$ref": "#/$defs/instructions"
}
},
"additionalProperties": false
}
]
},
"application": {
"type": "object",
"properties": {
"origin_regions": {
"$ref": "#/$defs/origin_regions"
},
"what_they_sell": {
"type": "string",
"maxLength": 4000,
"minLength": 1
},
"fulfilment_regions": {
"$ref": "#/$defs/origin_regions"
}
},
"minProperties": 3,
"additionalProperties": false
},
"age_18_or_over": {
"enum": [
true
]
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"electronic_consent": {
"enum": [
true
]
},
"settlement_account_id": {
"$ref": "#/$defs/request_id"
},
"public_history_consent": {
"enum": [
true
]
}
},
"additionalProperties": false
},
{
"oneOf": [
{
"type": "object",
"required": [
"request_id",
"expected_handle",
"expected_acceptance_id",
"action",
"kind"
],
"properties": {
"bio": {
"$ref": "#/$defs/bio"
},
"kind": {
"enum": [
"details"
]
},
"action": {
"enum": [
"update"
]
},
"handle": {
"type": "string",
"pattern": "^@?[A-Za-z0-9_-]{3,32}$"
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"agreement": {
"type": "object",
"properties": {
"sha256": {
"$ref": "#/$defs/sha256"
},
"version": {
"$ref": "#/$defs/version"
},
"principal": {
"type": "object",
"required": [
"legal_name"
],
"properties": {
"country": {
"type": "string"
},
"legal_name": {
"$ref": "#/$defs/legal_name"
}
},
"additionalProperties": false
},
"authorized": {
"enum": [
true
]
},
"age_18_or_over": {
"enum": [
true
]
},
"electronic_consent": {
"enum": [
true
]
},
"public_history_consent": {
"enum": [
true
]
}
},
"minProperties": 7,
"additionalProperties": false
},
"avatar_id": {
"$ref": "#/$defs/avatar_id"
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"website_url": {
"$ref": "#/$defs/website_url"
},
"expected_handle": {
"type": "string",
"pattern": "^@?[A-Za-z0-9_-]{3,32}$"
},
"expected_profile": {
"type": "object",
"properties": {
"bio": {
"$ref": "#/$defs/bio"
},
"avatar_id": {
"$ref": "#/$defs/avatar_id"
},
"website_url": {
"$ref": "#/$defs/website_url"
}
},
"minProperties": 3,
"additionalProperties": false
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"required_change_id": {
"$ref": "#/$defs/request_id"
},
"expected_acceptance_id": {
"anyOf": [
{
"$ref": "#/$defs/request_id"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"kind",
"request_id"
],
"properties": {
"x": {
"$ref": "#/$defs/line"
},
"bio": {
"$ref": "#/$defs/bio"
},
"kind": {
"enum": [
"profile"
]
},
"line": {
"$ref": "#/$defs/line"
},
"name": {
"$ref": "#/$defs/method"
},
"action": {
"enum": [
"update"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"telegram": {
"$ref": "#/$defs/line"
},
"whatsapp": {
"$ref": "#/$defs/line"
},
"avatar_id": {
"$ref": "#/$defs/avatar_id"
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"website_url": {
"$ref": "#/$defs/website_url"
},
"paypal_email": {
"anyOf": [
{
"$ref": "#/$defs/email"
},
{
"type": "null"
}
]
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"paypal_gs_consent": {
"enum": [
true
]
},
"required_change_id": {
"$ref": "#/$defs/request_id"
}
},
"additionalProperties": false
},
{
"type": "object",
"oneOf": [
{
"required": [
"name",
"max_price"
],
"properties": {
"operation": {
"enum": [
"save"
]
}
}
},
{
"required": [
"wanted_id",
"expected_revision"
],
"properties": {
"operation": {
"enum": [
"delete"
]
}
},
"propertyNames": {
"enum": [
"request_id",
"wanted_id",
"expected_revision",
"action",
"kind",
"operation",
"funding_accounts",
"max_fee"
]
}
}
],
"required": [
"request_id",
"action",
"kind",
"operation"
],
"properties": {
"set": {
"$ref": "#/$defs/name"
},
"kind": {
"enum": [
"wanted"
]
},
"name": {
"$ref": "#/$defs/name"
},
"action": {
"enum": [
"update"
]
},
"grader": {
"$ref": "#/$defs/name"
},
"number": {
"$ref": "#/$defs/name"
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"currency": {
"$ref": "#/$defs/unit"
},
"language": {
"$ref": "#/$defs/name"
},
"max_price": {
"type": "string",
"pattern": "^(0|[1-9]\\d{0,19})(\\.\\d{1,255})?$"
},
"min_grade": {
"type": "string",
"pattern": "^(0|[1-9]\\d{0,19})(\\.\\d{1,255})?$"
},
"operation": {},
"wanted_id": {
"$ref": "#/$defs/request_id"
},
"expires_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
{
"type": "null"
}
]
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"expected_revision": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}
]
},
{
"type": "object",
"required": [
"action",
"request_id",
"email",
"consent"
],
"properties": {
"email": {
"$ref": "#/$defs/email"
},
"action": {
"enum": [
"invite"
]
},
"consent": {
"enum": [
true
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
}
},
"additionalProperties": false
},
{
"type": "object",
"oneOf": [
{
"properties": {
"view": {
"enum": [
"account",
"referrals"
]
},
"run_id": false,
"auction_id": false,
"submission_id": false
}
},
{
"required": [
"submission_id"
],
"properties": {
"view": {
"enum": [
"submission"
]
},
"run_id": false,
"auction_id": false
}
},
{
"required": [
"auction_id",
"run_id"
],
"properties": {
"view": {
"enum": [
"catalogue"
]
},
"submission_id": false
}
}
],
"required": [
"action",
"view"
],
"properties": {
"view": {},
"action": {
"enum": [
"link"
]
},
"run_id": {
"$ref": "#/$defs/request_id"
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"auction_id": {
"$ref": "#/$defs/request_id"
},
"submission_id": {
"$ref": "#/$defs/request_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
}
},
"additionalProperties": false
}
]
}account annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}browse — Find items and read marketplace records
Read exact records or search. Paid searches and private pages require request_id and max_fee; public reads are free. Use detail=full for terms. See auction://reference.
browse input schema
{
"type": "object",
"$defs": {
"q": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"uri": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"after": {
"type": "string",
"maxLength": 512
},
"route": {
"anyOf": [
{
"enum": [
"btc",
"algo",
"usdc",
"sibidz",
"usdt_ethereum",
"usdt_tron"
]
},
{
"type": "string",
"pattern": "^asset_[a-z0-9][a-z0-9_]{0,55}$"
}
]
},
"choice": {
"anyOf": [
{
"$ref": "#/$defs/q"
},
{
"type": "object",
"properties": {
"op": {
"enum": [
"eq",
"gt",
"gte",
"lt",
"lte"
]
},
"value": {
"$ref": "#/$defs/q"
}
},
"minProperties": 2,
"additionalProperties": false
}
]
},
"after_2": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,18})$"
},
"min_price": {
"type": "string",
"pattern": "^(0|[1-9]\\d{0,19})(\\.\\d{1,255})?$"
},
"located_in": {
"type": "object",
"required": [
"country"
],
"properties": {
"city": {
"$ref": "#/$defs/subdivision"
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"subdivision": {
"$ref": "#/$defs/subdivision"
}
},
"additionalProperties": false
},
"request_id": {
"type": "string",
"format": "uuid",
"pattern": "^([\\da-fA-F]{8}-[\\da-fA-F]{4}-[1-8][\\da-fA-F]{3}-[89abAB][\\da-fA-F]{3}-[\\da-fA-F]{12}|0{8}-0{4}-0{4}-0{4}-0{12}|f{8}-f{4}-f{4}-f{4}-f{12})$"
},
"subdivision": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"anyOf": [
{
"required": [
"query",
"request_id"
],
"properties": {
"ref": false,
"cursor": false,
"detail": false
}
},
{
"required": [
"ref"
],
"properties": {
"query": false
}
}
],
"properties": {
"ref": {
"anyOf": [
{
"$ref": "#/$defs/uri"
},
{
"type": "object",
"oneOf": [
{
"properties": {
"kind": {
"enum": [
"item_conversation"
]
},
"after": {
"$ref": "#/$defs/after_2"
},
"entry_id": {
"$ref": "#/$defs/request_id"
},
"conversation_id": {
"$ref": "#/$defs/request_id"
}
},
"propertyNames": {
"enum": [
"conversation_id",
"entry_id",
"after",
"offer_cursor",
"offer_limit",
"kind"
]
}
},
{
"properties": {
"kind": {
"enum": [
"item_conversations"
]
},
"cursor": {
"type": "string",
"maxLength": 1000
}
},
"propertyNames": {
"enum": [
"cursor",
"kind"
]
}
},
{
"required": [
"receipt"
],
"properties": {
"kind": {
"enum": [
"receipt"
]
}
},
"maxProperties": 2
},
{
"required": [
"uri"
],
"properties": {
"kind": {
"enum": [
"progress"
]
}
},
"maxProperties": 2
},
{
"properties": {
"kind": {
"enum": [
"profile",
"balances",
"referrals",
"payment_options",
"payment_terms",
"financial_principal",
"prices",
"currencies",
"avatars",
"wanted_demand",
"won"
]
}
},
"maxProperties": 1
},
{
"properties": {
"kind": {
"enum": [
"conversations"
]
},
"cursor": {
"type": "string",
"maxLength": 300
}
},
"propertyNames": {
"enum": [
"cursor",
"kind"
]
}
},
{
"required": [
"conversation_id"
],
"properties": {
"kind": {
"enum": [
"conversation"
]
},
"cursor": {
"type": "string",
"maxLength": 300
},
"conversation_id": {
"$ref": "#/$defs/request_id"
}
},
"propertyNames": {
"enum": [
"cursor",
"kind",
"conversation_id"
]
}
},
{
"properties": {
"kind": {
"enum": [
"messages"
]
},
"after": {
"$ref": "#/$defs/after_2"
}
},
"propertyNames": {
"enum": [
"kind",
"after"
]
}
},
{
"properties": {
"kind": {
"enum": [
"statement"
]
},
"cursor": {
"type": "string",
"maxLength": 16000
}
},
"propertyNames": {
"enum": [
"account_id",
"cursor",
"ccy",
"kind"
]
}
},
{
"required": [
"coming_soon_id"
],
"properties": {
"kind": {
"enum": [
"coming_soon"
]
}
},
"maxProperties": 2
},
{
"properties": {
"q": {
"type": "string",
"maxLength": 200
},
"kind": {
"enum": [
"coming_soon_items"
]
}
},
"propertyNames": {
"enum": [
"kind",
"q",
"seller_id"
]
}
},
{
"required": [
"lot_id"
],
"properties": {
"kind": {
"enum": [
"lot"
]
}
},
"maxProperties": 2
},
{
"required": [
"auction_id"
],
"properties": {
"kind": {
"enum": [
"auction"
]
}
},
"propertyNames": {
"enum": [
"kind",
"auction_id",
"run_id"
]
}
},
{
"required": [
"entry_id"
],
"properties": {
"kind": {
"enum": [
"entry",
"sale",
"maximum_bid"
]
},
"entry_id": {
"$ref": "#/$defs/request_id"
}
},
"maxProperties": 2
},
{
"required": [
"offer_id"
],
"properties": {
"kind": {
"enum": [
"offer"
]
}
},
"maxProperties": 2
},
{
"properties": {
"kind": {
"enum": [
"offers"
]
},
"status": {
"enum": [
"open",
"accepted",
"declined",
"withdrawn",
"countered",
"expired",
"unavailable"
]
},
"entry_id": {
"$ref": "#/$defs/request_id"
}
},
"propertyNames": {
"enum": [
"kind",
"direction",
"status",
"entry_id"
]
}
},
{
"required": [
"submission_id"
],
"properties": {
"kind": {
"enum": [
"submission"
]
}
},
"maxProperties": 2
},
{
"required": [
"task_id"
],
"properties": {
"kind": {
"enum": [
"moderation"
]
}
},
"maxProperties": 2
},
{
"properties": {
"kind": {
"enum": [
"rewards"
]
}
},
"maxProperties": 1
},
{
"required": [
"operation_id"
],
"properties": {
"kind": {
"enum": [
"operation"
]
},
"operation_id": {
"$ref": "#/$defs/request_id"
}
},
"propertyNames": {
"enum": [
"kind",
"operation_id",
"refund_after"
]
}
},
{
"properties": {
"kind": {
"enum": [
"fiat_options"
]
}
},
"maxProperties": 1
},
{
"properties": {
"kind": {
"enum": [
"fiat_payments"
]
}
},
"maxProperties": 1
},
{
"required": [
"route"
],
"properties": {
"kind": {
"enum": [
"deposit_address"
]
},
"route": {
"$ref": "#/$defs/route"
}
},
"maxProperties": 2
},
{
"properties": {
"kind": {
"enum": [
"deposits"
]
},
"route": {
"$ref": "#/$defs/route"
}
},
"propertyNames": {
"enum": [
"kind",
"route"
]
}
},
{
"required": [
"deposit_id"
],
"properties": {
"kind": {
"enum": [
"deposit"
]
}
},
"maxProperties": 2
},
{
"required": [
"target"
],
"properties": {
"kind": {
"enum": [
"history"
]
}
},
"maxProperties": 2
},
{
"required": [
"auction_id"
],
"properties": {
"kind": {
"enum": [
"runs"
]
},
"after": {
"$ref": "#/$defs/after"
}
},
"propertyNames": {
"enum": [
"kind",
"auction_id",
"after"
]
}
},
{
"required": [
"operation_id"
],
"properties": {
"kind": {
"enum": [
"evidence"
]
},
"after": {
"$ref": "#/$defs/after_2"
},
"operation_id": {
"$ref": "#/$defs/request_id"
}
},
"propertyNames": {
"enum": [
"after",
"kind",
"operation_id"
]
}
},
{
"properties": {
"kind": {
"enum": [
"guide"
]
}
},
"propertyNames": {
"enum": [
"kind",
"document"
]
}
},
{
"properties": {
"kind": {
"enum": [
"sale_contact"
]
},
"entry_id": {
"$ref": "#/$defs/request_id"
}
},
"propertyNames": {
"enum": [
"kind",
"entry_id"
]
}
},
{
"properties": {
"kind": {
"enum": [
"agreement"
]
}
},
"propertyNames": {
"enum": [
"kind",
"version"
]
}
},
{
"required": [
"profile_id"
],
"properties": {
"kind": {
"enum": [
"participant"
]
},
"cursor": {
"type": "string",
"maxLength": 1024
}
},
"propertyNames": {
"enum": [
"kind",
"profile_id",
"cursor"
]
}
},
{
"properties": {
"kind": {
"enum": [
"wanted"
]
}
},
"propertyNames": {
"enum": [
"kind",
"wanted_id"
]
}
},
{
"properties": {
"q": {
"$ref": "#/$defs/q"
},
"kind": {
"enum": [
"listings"
]
},
"status": {
"enum": [
"draft",
"pending_submission",
"listed",
"sold",
"unsold",
"withdrawn"
]
}
},
"propertyNames": {
"enum": [
"q",
"status",
"missing_purchase_price",
"min_days_listed",
"sort",
"kind"
]
}
},
{
"properties": {
"kind": {
"enum": [
"submissions"
]
},
"cursor": {
"type": "string",
"maxLength": 2000,
"minLength": 1
}
},
"propertyNames": {
"enum": [
"auction_id",
"run_id",
"cursor",
"kind"
]
}
}
],
"required": [
"kind"
],
"properties": {
"q": {},
"ccy": {
"type": "string",
"maxLength": 16,
"minLength": 1
},
"uri": {
"$ref": "#/$defs/uri"
},
"kind": {},
"sort": {
"enum": [
"newest",
"oldest_listed"
]
},
"after": {},
"route": {},
"cursor": {},
"lot_id": {
"$ref": "#/$defs/request_id"
},
"run_id": {
"$ref": "#/$defs/request_id"
},
"status": {},
"target": {
"anyOf": [
{
"type": "object",
"required": [
"lot_id"
],
"properties": {
"after": {
"type": "string",
"pattern": "^[0-9]+$"
},
"before": {
"type": "string",
"pattern": "^[0-9]+$"
},
"lot_id": {
"$ref": "#/$defs/request_id"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"auction_id"
],
"properties": {
"after": {
"$ref": "#/$defs/after"
},
"run_id": {
"$ref": "#/$defs/request_id"
},
"auction_id": {
"$ref": "#/$defs/request_id"
},
"results_after": {
"$ref": "#/$defs/after"
}
},
"additionalProperties": false
}
]
},
"receipt": {
"type": "object",
"properties": {
"operation": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"request_id": {
"$ref": "#/$defs/request_id"
}
},
"minProperties": 2,
"additionalProperties": false
},
"task_id": {
"$ref": "#/$defs/request_id"
},
"version": {
"type": "string",
"maxLength": 80
},
"document": {
"enum": [
"guide",
"reference",
"spec",
"errors",
"examples",
"sale_contact",
"prices",
"trust"
]
},
"entry_id": {},
"offer_id": {
"$ref": "#/$defs/request_id"
},
"direction": {
"enum": [
"sent",
"received"
]
},
"seller_id": {
"type": "string",
"maxLength": 100
},
"wanted_id": {
"$ref": "#/$defs/request_id"
},
"account_id": {
"$ref": "#/$defs/request_id"
},
"auction_id": {
"$ref": "#/$defs/request_id"
},
"deposit_id": {
"$ref": "#/$defs/request_id"
},
"profile_id": {
"anyOf": [
{
"$ref": "#/$defs/request_id"
},
{
"enum": [
"RK3474PDZG32O4ESK7NTCNLQU25PAMCFGVDZWT3MSVBHYXH7CGSQSMHJ3U"
]
}
]
},
"offer_limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"offer_cursor": {
"type": "string",
"maxLength": 1000
},
"operation_id": {},
"refund_after": {
"$ref": "#/$defs/request_id"
},
"submission_id": {
"$ref": "#/$defs/request_id"
},
"coming_soon_id": {
"$ref": "#/$defs/request_id"
},
"conversation_id": {},
"min_days_listed": {
"type": "integer",
"maximum": 365000,
"minimum": 0
},
"missing_purchase_price": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"query": {
"anyOf": [
{
"$ref": "#/$defs/q"
},
{
"type": "object",
"properties": {
"q": {
"type": "string",
"maxLength": 200
},
"city": {
"type": "string",
"maxLength": 120
},
"mode": {
"enum": [
"single",
"series"
]
},
"sort": {
"enum": [
"closing_soonest",
"price_asc",
"price_desc",
"newest"
]
},
"unit": {
"anyOf": [
{
"type": "string",
"pattern": "^(?:(?:A(?:[EMU]D|[FZ]N|LL|OA|RS|WG)|B(?:AM|[BHMNSZ]D|DT|IF|O[BV]|RL|[TY]N|WP)|C(?:AD|DF|H[EFW]|L[FP]|NY|O[PU]|RC|UP|VE|ZK)|D(?:JF|KK|OP|ZD)|E(?:GP|RN|TB|UR)|F(?:JD|KP)|G(?:[BI]P|EL|HS|[MY]D|NF|TQ)|H(?:KD|NL|TG|UF)|I(?:[DNR]R|LS|QD|SK)|J(?:[MO]D|PY)|K(?:[EG]S|HR|MF|[PR]W|[WY]D|ZT)|L(?:AK|BP|KR|[RY]D|SL)|M(?:[AK]D|DL|GA|[MW]K|NT|OP|RU|[UVY]R|X[NV]|ZN)|N(?:[AZ]D|GN|IO|OK|PR)|OMR|P(?:AB|[EL]N|GK|HP|KR|YG)|QAR|R(?:ON|SD|UB|WF)|S(?:[AC]R|[BGR]D|DG|EK|[HSY]P|LE|OS|TN|VC|ZL)|T(?:HB|[JZ]S|MT|[NTW]D|OP|RY)|U(?:AH|GX|S[DN]|Y[IUW]|ZS)|V(?:E[DS]|ND|UV)|WST|X(?:A[DF]|C[DG]|[OP]F)|YER|Z(?:AR|MW|WG)))(?![\\s\\S])"
},
{
"type": "string",
"pattern": "^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}\\/[-a-z0-9]{3,8}:[-.%a-zA-Z0-9]{1,128}$"
}
]
},
"phase": {
"enum": [
"active",
"queued",
"scheduled",
"open",
"closed",
"withdrawn",
"all"
]
},
"scope": {
"enum": [
"lots",
"auctions"
]
},
"cursor": {
"type": "string",
"maxLength": 2048
},
"lot_id": {
"$ref": "#/$defs/request_id"
},
"run_id": {
"$ref": "#/$defs/request_id"
},
"status": {
"enum": [
"open",
"upcoming",
"closed"
]
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"category": {
"type": "string",
"maxLength": 120
},
"max_price": {
"$ref": "#/$defs/min_price"
},
"min_price": {
"$ref": "#/$defs/min_price"
},
"sale_type": {
"enum": [
"auction",
"multi",
"buy_now",
"coming_soon"
]
},
"attributes": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/choice"
}
},
"auction_id": {
"$ref": "#/$defs/request_id"
},
"deliver_to": {
"$ref": "#/$defs/located_in"
},
"located_in": {
"$ref": "#/$defs/located_in"
},
"payment_method": {
"enum": [
"paypal_gs",
"bank_transfer",
"payment_service",
"crypto"
]
},
"closing_within_minutes": {
"type": "integer",
"maximum": 20160,
"minimum": 1
}
},
"additionalProperties": false
}
]
},
"cursor": {
"type": "string",
"maxLength": 16384
},
"detail": {
"enum": [
"summary",
"full"
]
},
"max_fee": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,19})$"
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"funding_accounts": {
"type": "object",
"properties": {
"grant_account_id": {
"type": "string",
"format": "uuid"
},
"normal_account_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}browse annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}sell — Prepare listings and manage selling
Advertised destructiveOpen-world
Prepare private listings, then approve exact publication, edits or withdrawal. Paid stages require request_id and max_fee; preparation never publishes. See auction://reference.
sell input schema
{
"type": "object",
"$defs": {
"unit": {
"anyOf": [
{
"$ref": "#/$defs/currency"
},
{
"$ref": "#/$defs/unit_2"
}
]
},
"brief": {
"type": "string",
"maxLength": 4000
},
"local": {
"oneOf": [
{
"type": "object",
"properties": {
"amount": {
"$ref": "#/$defs/amount_2"
},
"status": {
"enum": [
"estimate"
]
},
"currency": {
"$ref": "#/$defs/currency"
}
},
"minProperties": 3,
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"enum": [
"unavailable",
"not_applicable"
]
}
},
"minProperties": 1,
"additionalProperties": false
}
]
},
"price": {
"$ref": "#/$defs/amount"
},
"setup": {
"type": "object",
"properties": {
"agreement": {
"type": "object",
"properties": {
"sha256": {
"$ref": "#/$defs/expected_terms_hash"
},
"version": {
"$ref": "#/$defs/version"
},
"principal": {
"type": "object",
"required": [
"legal_name"
],
"properties": {
"country": {
"type": "string"
},
"legal_name": {
"$ref": "#/$defs/legal_name"
}
},
"additionalProperties": false
},
"authorized": {
"enum": [
true
]
},
"age_18_or_over": {
"enum": [
true
]
},
"electronic_consent": {
"enum": [
true
]
},
"public_history_consent": {
"enum": [
true
]
}
},
"minProperties": 7,
"additionalProperties": false
},
"receiving": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"label",
"unit",
"decimals",
"method",
"recipient",
"account"
],
"properties": {
"kind": {
"enum": [
"direct"
]
},
"unit": {
"$ref": "#/$defs/unit"
},
"label": {
"$ref": "#/$defs/version"
},
"method": {
"$ref": "#/$defs/title"
},
"account": {
"$ref": "#/$defs/account"
},
"decimals": {
"type": "integer",
"maximum": 255,
"minimum": 0
},
"recipient": {
"$ref": "#/$defs/legal_name"
},
"instructions": {
"$ref": "#/$defs/description"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"label",
"unit",
"method",
"country",
"recipient",
"account"
],
"properties": {
"kind": {
"enum": [
"fiat"
]
},
"unit": {
"$ref": "#/$defs/currency"
},
"label": {
"$ref": "#/$defs/version"
},
"method": {
"enum": [
"bank_transfer",
"payment_service"
]
},
"account": {
"$ref": "#/$defs/account"
},
"country": {
"type": "string"
},
"recipient": {
"$ref": "#/$defs/legal_name"
},
"instructions": {
"$ref": "#/$defs/description"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"label",
"unit",
"network",
"symbol",
"decimals",
"recipient",
"account"
],
"properties": {
"dti": {
"type": "string",
"pattern": "^[1-9B-DF-HJ-NP-TV-XZ][0-9B-DF-HJ-NP-TV-XZ]{8}$"
},
"kind": {
"enum": [
"crypto"
]
},
"memo": {
"$ref": "#/$defs/account"
},
"unit": {
"$ref": "#/$defs/unit_2"
},
"label": {
"$ref": "#/$defs/version"
},
"symbol": {
"type": "string",
"maxLength": 24,
"minLength": 1
},
"account": {
"$ref": "#/$defs/account"
},
"network": {
"type": "string",
"pattern": "^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$"
},
"decimals": {
"type": "integer",
"maximum": 255,
"minimum": 0
},
"recipient": {
"$ref": "#/$defs/legal_name"
},
"instructions": {
"$ref": "#/$defs/description"
}
},
"additionalProperties": false
}
]
},
"seller_application": {
"type": "object",
"properties": {
"origin_regions": {
"$ref": "#/$defs/origin_regions"
},
"what_they_sell": {
"type": "string",
"maxLength": 4000,
"minLength": 1
},
"fulfilment_regions": {
"$ref": "#/$defs/origin_regions"
}
},
"minProperties": 3,
"additionalProperties": false
}
},
"additionalProperties": false
},
"title": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"amount": {
"$ref": "#/$defs/amount_2"
},
"choice": {
"anyOf": [
{
"$ref": "#/$defs/legal_name"
},
{
"type": "object",
"properties": {
"op": {
"enum": [
"eq",
"gt",
"gte",
"lt",
"lte"
]
},
"value": {
"$ref": "#/$defs/legal_name"
}
},
"minProperties": 2,
"additionalProperties": false
}
]
},
"lot_id": {
"type": "string",
"format": "uuid",
"pattern": "^([\\da-fA-F]{8}-[\\da-fA-F]{4}-[1-8][\\da-fA-F]{3}-[89abAB][\\da-fA-F]{3}-[\\da-fA-F]{12}|0{8}-0{4}-0{4}-0{4}-0{12}|f{8}-f{4}-f{4}-f{4}-f{12})$"
},
"photos": {
"type": "array",
"items": {
"type": "object",
"required": [
"photo_id"
],
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"sha256": {
"type": "string"
},
"caption": {
"$ref": "#/$defs/caption"
},
"photo_id": {
"$ref": "#/$defs/lot_id"
},
"byte_size": {
"type": "number"
}
},
"additionalProperties": false
},
"maxItems": 6
},
"reason": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"unit_2": {
"type": "string",
"pattern": "^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}\\/[-a-z0-9]{3,8}:[-.%a-zA-Z0-9]{1,128}$"
},
"account": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"caption": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"listing": {
"type": "object",
"oneOf": [
{
"properties": {
"terms": {
"type": "object",
"required": [
"shipping_estimates",
"title",
"description",
"fulfilment",
"category",
"quantity_unit",
"photos",
"condition",
"location",
"fulfilment_options"
],
"properties": {
"title": {
"$ref": "#/$defs/title"
},
"photos": {
"$ref": "#/$defs/photos"
},
"category": {
"enum": [
"food",
"electronics",
"home",
"clothing",
"vehicles",
"equipment",
"collectibles",
"other"
]
},
"location": {
"$ref": "#/$defs/location"
},
"condition": {
"type": "object",
"properties": {
"grade": {
"enum": [
"new",
"used",
"refurbished",
"for_parts",
"not_applicable"
]
},
"notes": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
},
"minProperties": 2,
"additionalProperties": false
},
"attributes": {
"$ref": "#/$defs/attributes"
},
"fulfilment": {
"$ref": "#/$defs/description"
},
"description": {
"$ref": "#/$defs/description"
},
"quantity_unit": {
"enum": [
"item",
"kg",
"litre",
"box",
"crate"
]
},
"fulfilment_options": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"properties": {
"method": {
"enum": [
"pickup"
]
},
"destinations": false
}
},
{
"required": [
"destinations"
],
"properties": {
"method": {
"enum": [
"delivery"
]
}
}
}
],
"required": [
"method",
"pricing"
],
"properties": {
"method": {},
"pricing": {
"$ref": "#/$defs/pricing"
},
"destinations": {
"$ref": "#/$defs/destinations"
}
},
"additionalProperties": false
},
"maxItems": 8,
"minItems": 1
},
"shipping_estimates": {
"$ref": "#/$defs/shipping_estimates"
}
},
"additionalProperties": false
},
"schema": {
"enum": [
"goods.lot.v2"
]
}
}
},
{
"properties": {
"terms": {
"type": "object",
"required": [
"shipping_estimates",
"title",
"description",
"fulfilment",
"category",
"quantity_unit",
"photos",
"location",
"fulfilment_options"
],
"properties": {
"title": {
"$ref": "#/$defs/title"
},
"photos": {
"$ref": "#/$defs/photos"
},
"category": {
"enum": [
"services"
]
},
"location": {
"$ref": "#/$defs/location"
},
"attributes": {
"$ref": "#/$defs/attributes"
},
"fulfilment": {
"$ref": "#/$defs/description"
},
"description": {
"$ref": "#/$defs/description"
},
"quantity_unit": {
"enum": [
"hour",
"task"
]
},
"fulfilment_options": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"required": [
"destinations"
],
"properties": {
"method": {
"enum": [
"on_site"
]
}
}
},
{
"properties": {
"method": {
"enum": [
"remote"
]
},
"destinations": false
}
}
],
"required": [
"method",
"pricing"
],
"properties": {
"method": {},
"pricing": {
"$ref": "#/$defs/pricing"
},
"destinations": {
"$ref": "#/$defs/destinations"
}
},
"additionalProperties": false
},
"maxItems": 8,
"minItems": 1
},
"shipping_estimates": {
"$ref": "#/$defs/shipping_estimates"
}
},
"additionalProperties": false
},
"schema": {
"enum": [
"service.lot.v2"
]
}
}
}
],
"properties": {
"terms": {},
"schema": {},
"quantity": {
"$ref": "#/$defs/price"
},
"origin_regions": {
"$ref": "#/$defs/origin_regions"
},
"fulfilment_regions": {
"$ref": "#/$defs/origin_regions"
}
},
"minProperties": 5,
"additionalProperties": false
},
"max_fee": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,19})$"
},
"pricing": {
"type": "object",
"oneOf": [
{
"required": [
"amount"
],
"properties": {
"type": {
"enum": [
"fixed"
]
}
}
},
{
"properties": {
"type": {
"enum": [
"quote"
]
},
"amount": false
}
}
],
"required": [
"type"
],
"properties": {
"type": {},
"amount": {
"$ref": "#/$defs/amount_2"
}
},
"additionalProperties": false
},
"title_2": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"version": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"amount_2": {
"type": "string",
"pattern": "^(0|[1-9]\\d{0,19})(\\.\\d{1,255})?$"
},
"currency": {
"type": "string",
"pattern": "^(?:(?:A(?:[EMU]D|[FZ]N|LL|OA|RS|WG)|B(?:AM|[BHMNSZ]D|DT|IF|O[BV]|RL|[TY]N|WP)|C(?:AD|DF|H[EFW]|L[FP]|NY|O[PU]|RC|UP|VE|ZK)|D(?:JF|KK|OP|ZD)|E(?:GP|RN|TB|UR)|F(?:JD|KP)|G(?:[BI]P|EL|HS|[MY]D|NF|TQ)|H(?:KD|NL|TG|UF)|I(?:[DNR]R|LS|QD|SK)|J(?:[MO]D|PY)|K(?:[EG]S|HR|MF|[PR]W|[WY]D|ZT)|L(?:AK|BP|KR|[RY]D|SL)|M(?:[AK]D|DL|GA|[MW]K|NT|OP|RU|[UVY]R|X[NV]|ZN)|N(?:[AZ]D|GN|IO|OK|PR)|OMR|P(?:AB|[EL]N|GK|HP|KR|YG)|QAR|R(?:ON|SD|UB|WF)|S(?:[AC]R|[BGR]D|DG|EK|[HSY]P|LE|OS|TN|VC|ZL)|T(?:HB|[JZ]S|MT|[NTW]D|OP|RY)|U(?:AH|GX|S[DN]|Y[IUW]|ZS)|V(?:E[DS]|ND|UV)|WST|X(?:A[DF]|C[DG]|[OP]F)|YER|Z(?:AR|MW|WG)))(?![\\s\\S])"
},
"location": {
"type": "object",
"properties": {
"city": {
"$ref": "#/$defs/title"
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2
}
},
"minProperties": 2,
"additionalProperties": false
},
"photos_2": {
"type": "array",
"items": {
"type": "object",
"required": [
"source"
],
"properties": {
"source": {
"type": "object",
"oneOf": [
{
"type": "object",
"properties": {
"action": {
"enum": [
"upload"
]
},
"mime_type": {
"enum": [
"image/jpeg",
"image/png",
"image/webp"
]
},
"data_base64": {
"type": "string",
"maxLength": 6990508,
"minLength": 4
}
},
"minProperties": 3,
"additionalProperties": false
},
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"action": {
"enum": [
"import"
]
}
},
"minProperties": 2,
"additionalProperties": false
}
]
},
"caption": {
"$ref": "#/$defs/caption"
}
},
"additionalProperties": false
},
"maxItems": 6
},
"catalogue": {
"oneOf": [
{
"type": "object",
"properties": {
"catalogue": {
"type": "object",
"required": [
"title",
"starts_at"
],
"properties": {
"brief": {
"$ref": "#/$defs/brief"
},
"title": {
"$ref": "#/$defs/title_2"
},
"max_lots": {
"$ref": "#/$defs/pending_cap"
},
"starts_at": {
"$ref": "#/$defs/starts_at"
},
"attributes": {
"type": "object",
"properties": {
"ordering": {
"enum": [
"submission",
"popularity",
"manual"
]
},
"soft_close": {
"$ref": "#/$defs/soft_close"
},
"reserve_mode": {
"enum": [
"sealed"
]
}
},
"additionalProperties": false
},
"gate_rules": {
"$ref": "#/$defs/gate_rules"
},
"description": {
"type": "string",
"maxLength": 2000
},
"listing_fee": {
"$ref": "#/$defs/preparation_budget"
},
"pending_cap": {
"$ref": "#/$defs/pending_cap"
},
"timeout_action": {
"enum": [
"reject",
"accept"
]
},
"review_fallback": {
"type": "boolean"
},
"submission_mode": {
"$ref": "#/$defs/submission_mode"
},
"submissions_open_at": {
"$ref": "#/$defs/starts_at"
},
"submissions_close_at": {
"$ref": "#/$defs/starts_at"
}
},
"additionalProperties": false
},
"operation": {
"enum": [
"create"
]
}
},
"minProperties": 2,
"additionalProperties": false
},
{
"type": "object",
"properties": {
"schedule": {
"type": "object",
"required": [
"auction_id",
"starts_at"
],
"properties": {
"brief": {
"$ref": "#/$defs/brief"
},
"title": {
"$ref": "#/$defs/title_2"
},
"max_lots": {
"$ref": "#/$defs/pending_cap"
},
"starts_at": {
"$ref": "#/$defs/starts_at"
},
"attributes": {
"type": "object",
"properties": {
"ordering": {
"enum": [
"submission",
"popularity",
"manual"
]
},
"soft_close": {
"$ref": "#/$defs/soft_close"
},
"reserve_mode": {
"enum": [
"sealed"
]
}
},
"additionalProperties": false
},
"auction_id": {
"$ref": "#/$defs/lot_id"
},
"gate_rules": {
"$ref": "#/$defs/gate_rules"
},
"description": {
"type": "string",
"maxLength": 2000
},
"listing_fee": {
"$ref": "#/$defs/preparation_budget"
},
"pending_cap": {
"$ref": "#/$defs/pending_cap"
},
"timeout_action": {
"enum": [
"reject",
"accept"
]
},
"review_fallback": {
"type": "boolean"
},
"submission_mode": {
"$ref": "#/$defs/submission_mode"
},
"submissions_open_at": {
"$ref": "#/$defs/starts_at"
},
"submissions_close_at": {
"$ref": "#/$defs/starts_at"
}
},
"additionalProperties": false
},
"operation": {
"enum": [
"schedule"
]
}
},
"minProperties": 2,
"additionalProperties": false
},
{
"type": "object",
"properties": {
"operation": {
"enum": [
"configure"
]
},
"configuration": {
"type": "object",
"required": [
"auction_id",
"run_id",
"expected_policy_version"
],
"properties": {
"brief": {
"$ref": "#/$defs/brief"
},
"title": {
"$ref": "#/$defs/title_2"
},
"run_id": {
"$ref": "#/$defs/lot_id"
},
"auction_id": {
"$ref": "#/$defs/lot_id"
},
"gate_rules": {
"$ref": "#/$defs/gate_rules"
},
"description": {
"type": "string",
"maxLength": 2000
},
"pending_cap": {
"$ref": "#/$defs/pending_cap"
},
"timeout_action": {
"enum": [
"reject",
"accept"
]
},
"review_fallback": {
"type": "boolean"
},
"submission_mode": {
"$ref": "#/$defs/submission_mode"
},
"expected_policy_version": {
"$ref": "#/$defs/expected_lot_revision"
}
},
"additionalProperties": false
}
},
"minProperties": 2,
"additionalProperties": false
},
{
"type": "object",
"properties": {
"order": {
"type": "object",
"properties": {
"run_id": {
"$ref": "#/$defs/lot_id"
},
"entry_ids": {
"type": "array",
"items": {
"$ref": "#/$defs/lot_id"
},
"maxItems": 100,
"minItems": 1
},
"auction_id": {
"$ref": "#/$defs/lot_id"
}
},
"minProperties": 3,
"additionalProperties": false
},
"operation": {
"enum": [
"order"
]
}
},
"minProperties": 2,
"additionalProperties": false
},
{
"type": "object",
"properties": {
"slug": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
},
"operation": {
"enum": [
"slug"
]
},
"auction_id": {
"$ref": "#/$defs/lot_id"
}
},
"minProperties": 3,
"additionalProperties": false
}
]
},
"starts_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"attributes": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"null"
]
}
},
"gate_rules": {
"type": "object",
"properties": {
"unit": {
"$ref": "#/$defs/title_2"
},
"attributes": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/choice"
}
},
"minimum_grade": {
"type": "number",
"maximum": 10,
"minimum": 0
},
"grading_companies": {
"type": "array",
"items": {
"$ref": "#/$defs/version"
},
"maxItems": 10,
"minItems": 1
},
"minimum_opening_price": {
"$ref": "#/$defs/amount_2"
}
},
"additionalProperties": false
},
"legal_name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"request_id": {
"$ref": "#/$defs/lot_id"
},
"soft_close": {
"type": "object",
"properties": {
"extension_mode": {
"enum": [
"add_to_deadline"
]
},
"window_seconds": {
"enum": [
60
]
},
"extension_seconds": {
"enum": [
30
]
}
},
"minProperties": 3,
"additionalProperties": false
},
"description": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"destination": {
"oneOf": [
{
"type": "object",
"properties": {
"kind": {
"enum": [
"fixed_price"
]
}
},
"minProperties": 1,
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"coming_soon"
]
},
"expected_arrival": {
"anyOf": [
{
"$ref": "#/$defs/starts_at"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"starts_at"
],
"properties": {
"kind": {
"enum": [
"standalone"
]
},
"starts_at": {
"$ref": "#/$defs/starts_at"
},
"duration_minutes": {
"type": "integer",
"maximum": 20160,
"minimum": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"properties": {
"ref": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"minLength": 1
},
{
"type": "object",
"properties": {
"run_id": {
"$ref": "#/$defs/lot_id"
},
"auction_id": {
"$ref": "#/$defs/lot_id"
}
},
"minProperties": 2,
"additionalProperties": false
}
]
},
"kind": {
"enum": [
"catalogue"
]
}
},
"minProperties": 2,
"additionalProperties": false
}
]
},
"pending_cap": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"destinations": {
"type": "array",
"items": {
"type": "object",
"required": [
"country"
],
"properties": {
"city": {
"$ref": "#/$defs/title"
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2
}
},
"additionalProperties": false
},
"maxItems": 50,
"minItems": 1
},
"origin_regions": {
"type": "array",
"items": {
"type": "object",
"required": [
"country"
],
"properties": {
"city": {
"$ref": "#/$defs/title"
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"subdivision": {
"$ref": "#/$defs/title"
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"submission_mode": {
"enum": [
"closed",
"auto",
"gated",
"review"
]
},
"funding_accounts": {
"type": "object",
"properties": {
"grant_account_id": {
"type": "string",
"format": "uuid"
},
"normal_account_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"preparation_budget": {
"type": "string",
"pattern": "^(0|[1-9]\\d{0,19})$"
},
"shipping_estimates": {
"type": "object",
"properties": {
"local": {
"$ref": "#/$defs/local"
},
"worldwide": {
"$ref": "#/$defs/local"
}
},
"minProperties": 2,
"additionalProperties": false
},
"expected_terms_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"expected_lot_revision": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"anyOf": [
{
"type": "object",
"required": [
"action",
"lot_id",
"expected_stock_revision",
"request_id",
"stock"
],
"properties": {
"stock": {
"type": "object",
"properties": {
"stock_id": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"minLength": 1
},
{
"type": "null"
}
]
},
"acquired_on": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"purchase_price": {
"anyOf": [
{
"type": "object",
"properties": {
"unit": {
"$ref": "#/$defs/unit"
},
"amount": {
"$ref": "#/$defs/amount"
}
},
"minProperties": 2,
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"action": {
"enum": [
"stock"
]
},
"lot_id": {
"$ref": "#/$defs/lot_id"
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"request_id": {
"$ref": "#/$defs/lot_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"expected_stock_revision": {
"type": "integer",
"maximum": 2147483646,
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"entry_id",
"expected_lot_revision",
"expected_terms_hash",
"listing",
"request_id"
],
"properties": {
"offer": {
"anyOf": [
{
"type": "object",
"properties": {
"reserve": {
"$ref": "#/$defs/amount"
},
"opening_bid": {
"$ref": "#/$defs/amount"
}
},
"additionalProperties": false
},
{
"type": "object",
"properties": {
"price": {
"$ref": "#/$defs/price"
},
"buy_now": {
"type": "boolean"
},
"make_offer": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
},
"action": {
"enum": [
"edit"
]
},
"photos": {
"$ref": "#/$defs/photos_2"
},
"listing": {
"$ref": "#/$defs/listing"
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"entry_id": {
"$ref": "#/$defs/lot_id"
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"expected_terms_hash": {
"$ref": "#/$defs/expected_terms_hash"
},
"expected_lot_revision": {
"$ref": "#/$defs/expected_lot_revision"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"kind",
"request_id",
"item"
],
"properties": {
"item": {
"type": "object",
"properties": {
"offer": {
"type": "object",
"anyOf": [
{
"required": [
"opening_bid",
"tick"
],
"properties": {
"price": false,
"buy_now": false,
"make_offer": false
}
},
{
"required": [
"price"
],
"properties": {
"tick": false,
"reserve": false,
"opening_bid": false
}
}
],
"required": [
"unit"
],
"properties": {
"tick": {
"$ref": "#/$defs/price"
},
"unit": {
"$ref": "#/$defs/unit"
},
"price": {
"$ref": "#/$defs/price"
},
"buy_now": {
"type": "boolean"
},
"reserve": {
"$ref": "#/$defs/amount"
},
"paypal_gs": {
"type": "boolean"
},
"make_offer": {
"type": "boolean"
},
"opening_bid": {
"$ref": "#/$defs/amount"
},
"payment_hours": {
"type": "integer",
"maximum": 168,
"minimum": 1
},
"settlement_account_id": {
"$ref": "#/$defs/lot_id"
}
},
"additionalProperties": false
},
"setup": {
"$ref": "#/$defs/setup"
},
"lot_id": {
"$ref": "#/$defs/lot_id"
},
"photos": {
"$ref": "#/$defs/photos_2"
},
"listing": {
"$ref": "#/$defs/listing"
},
"destination": {
"$ref": "#/$defs/destination"
},
"expected_lot_revision": {
"$ref": "#/$defs/expected_lot_revision"
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"item"
]
},
"action": {
"enum": [
"prepare"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"preparation_budget": {
"$ref": "#/$defs/preparation_budget"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"kind",
"request_id",
"catalogue"
],
"properties": {
"kind": {
"enum": [
"catalogue"
]
},
"action": {
"enum": [
"prepare"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"catalogue": {
"$ref": "#/$defs/catalogue"
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"preparation_budget": {
"$ref": "#/$defs/preparation_budget"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"workflow_id",
"expected_revision",
"request_id"
],
"properties": {
"item": {
"type": "object",
"properties": {
"offer": {
"type": "object",
"anyOf": [
{
"properties": {
"price": false,
"buy_now": false,
"make_offer": false
}
},
{
"properties": {
"tick": false,
"reserve": false,
"opening_bid": false
}
}
],
"properties": {
"tick": {
"$ref": "#/$defs/price"
},
"unit": {
"$ref": "#/$defs/unit"
},
"price": {
"$ref": "#/$defs/price"
},
"buy_now": {
"type": "boolean"
},
"reserve": {
"$ref": "#/$defs/amount"
},
"paypal_gs": {
"type": "boolean"
},
"make_offer": {
"type": "boolean"
},
"opening_bid": {
"$ref": "#/$defs/amount"
},
"payment_hours": {
"type": "integer",
"maximum": 168,
"minimum": 1
},
"settlement_account_id": {
"$ref": "#/$defs/lot_id"
}
},
"additionalProperties": false
},
"setup": {
"$ref": "#/$defs/setup"
},
"lot_id": {
"$ref": "#/$defs/lot_id"
},
"photos": {
"$ref": "#/$defs/photos_2"
},
"listing": {
"$ref": "#/$defs/listing"
},
"destination": {
"$ref": "#/$defs/destination"
},
"expected_lot_revision": {
"$ref": "#/$defs/expected_lot_revision"
}
},
"additionalProperties": false
},
"action": {
"enum": [
"continue"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"catalogue": {
"$ref": "#/$defs/catalogue"
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"workflow_id": {
"$ref": "#/$defs/lot_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"expected_revision": {
"$ref": "#/$defs/expected_lot_revision"
},
"preparation_budget": {
"$ref": "#/$defs/preparation_budget"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"workflow_id",
"expected_revision",
"proposal_id",
"proposal_hash",
"authorized",
"request_id"
],
"properties": {
"action": {
"enum": [
"publish"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"authorized": {
"enum": [
true
]
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"proposal_id": {
"$ref": "#/$defs/lot_id"
},
"workflow_id": {
"$ref": "#/$defs/lot_id"
},
"proposal_hash": {
"$ref": "#/$defs/expected_terms_hash"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"expected_revision": {
"$ref": "#/$defs/expected_lot_revision"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"target",
"request_id"
],
"properties": {
"action": {
"enum": [
"withdraw"
]
},
"target": {
"type": "object",
"oneOf": [
{
"required": [
"workflow_id",
"expected_revision"
],
"properties": {
"kind": {
"enum": [
"workflow"
]
}
},
"maxProperties": 3
},
{
"required": [
"entry_id",
"reason"
],
"properties": {
"kind": {
"enum": [
"entry"
]
}
},
"maxProperties": 3
},
{
"required": [
"coming_soon_id",
"expected_revision",
"reason"
],
"properties": {
"kind": {
"enum": [
"coming_soon"
]
},
"entry_id": false,
"workflow_id": false
}
}
],
"required": [
"kind"
],
"properties": {
"kind": {},
"reason": {
"$ref": "#/$defs/reason"
},
"entry_id": {
"$ref": "#/$defs/lot_id"
},
"workflow_id": {
"$ref": "#/$defs/lot_id"
},
"coming_soon_id": {
"$ref": "#/$defs/lot_id"
},
"expected_revision": {
"$ref": "#/$defs/expected_lot_revision"
}
},
"additionalProperties": false
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"submission_id",
"decision",
"reason",
"request_id"
],
"properties": {
"action": {
"enum": [
"review"
]
},
"reason": {
"$ref": "#/$defs/reason"
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"decision": {
"enum": [
"accept",
"reject"
]
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"submission_id": {
"$ref": "#/$defs/lot_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
}
},
"additionalProperties": false
}
]
}sell annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}bid — Join auctions and manage bids
Advertised destructive
Join a run, authorize a maximum or place an explicit manual bid. Paid actions require request_id and max_fee; automatic increments and maximum cancellation are free. See auction://reference.
bid input schema
{
"type": "object",
"$defs": {
"price": {
"type": "string",
"pattern": "^(0|[1-9]\\d{0,19})(\\.\\d{1,255})?$"
},
"max_fee": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,19})$"
},
"auction_id": {
"type": "string",
"format": "uuid",
"pattern": "^([\\da-fA-F]{8}-[\\da-fA-F]{4}-[1-8][\\da-fA-F]{3}-[89abAB][\\da-fA-F]{3}-[\\da-fA-F]{12}|0{8}-0{4}-0{4}-0{4}-0{12}|f{8}-f{4}-f{4}-f{4}-f{12})$"
},
"utm_source": {
"type": "string",
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9 _.-]*$",
"maxLength": 96,
"minLength": 1
},
"admission_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"funding_accounts": {
"type": "object",
"properties": {
"grant_account_id": {
"type": "string",
"format": "uuid"
},
"normal_account_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}
},
"oneOf": [
{
"type": "object",
"required": [
"action",
"auction_id",
"run_id",
"request_id"
],
"properties": {
"action": {
"enum": [
"join"
]
},
"run_id": {
"$ref": "#/$defs/auction_id"
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"auction_id": {
"$ref": "#/$defs/auction_id"
},
"request_id": {
"$ref": "#/$defs/auction_id"
},
"attribution": {
"type": "object",
"properties": {
"src": {
"$ref": "#/$defs/utm_source"
},
"channel": {
"enum": [
"browser",
"mcp"
]
},
"utm_term": {
"$ref": "#/$defs/utm_source"
},
"utm_medium": {
"$ref": "#/$defs/utm_source"
},
"utm_source": {
"$ref": "#/$defs/utm_source"
},
"captured_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"utm_content": {
"$ref": "#/$defs/utm_source"
},
"utm_campaign": {
"$ref": "#/$defs/utm_source"
}
},
"additionalProperties": false
},
"accept_terms": {
"enum": [
true
]
},
"admission_hash": {
"$ref": "#/$defs/admission_hash"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"admission_version": {
"type": "string",
"maxLength": 64
},
"sale_contact_hash": {
"$ref": "#/$defs/admission_hash"
},
"sale_contact_consent": {
"enum": [
true
]
},
"sale_contact_version": {
"type": "string",
"maxLength": 64
}
},
"additionalProperties": false
},
{
"type": "object",
"oneOf": [
{
"required": [
"price"
],
"properties": {
"mode": {
"enum": [
"amount"
]
},
"maximum": false
}
},
{
"required": [
"mode",
"maximum"
],
"properties": {
"mode": {
"enum": [
"maximum"
]
},
"price": false
}
}
],
"required": [
"entry_id",
"action",
"request_id"
],
"properties": {
"mode": {},
"price": {
"$ref": "#/$defs/price"
},
"action": {
"enum": [
"place"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"maximum": {
"$ref": "#/$defs/price"
},
"entry_id": {
"$ref": "#/$defs/auction_id"
},
"request_id": {
"$ref": "#/$defs/auction_id"
},
"accept_terms": {
"anyOf": [
{
"enum": [
true
]
},
{
"$ref": "#/$defs/admission_hash"
}
]
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"sale_contact_consent": {
"enum": [
true
]
}
},
"additionalProperties": false
},
{
"type": "object",
"oneOf": [
{
"required": [
"bid_seq",
"reason"
],
"properties": {
"mode": {
"enum": [
"bid"
]
}
}
},
{
"required": [
"mode"
],
"properties": {
"mode": {
"enum": [
"maximum"
]
},
"reason": false,
"bid_seq": false
}
}
],
"required": [
"entry_id",
"action",
"request_id"
],
"properties": {
"mode": {},
"action": {
"enum": [
"retract"
]
},
"reason": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"bid_seq": {
"type": "string",
"pattern": "^[1-9]\\d*$"
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"entry_id": {
"$ref": "#/$defs/auction_id"
},
"request_id": {
"$ref": "#/$defs/auction_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
}
},
"additionalProperties": false
}
]
}bid annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}buy — Buy items and negotiate offers
Advertised destructive
Buy or negotiate under frozen terms. Paid actions require request_id and max_fee; interest, decline and withdrawal are free. Pay the seller directly. See auction://reference.
buy input schema
{
"type": "object",
"$defs": {
"entry_id": {
"type": "string",
"format": "uuid",
"pattern": "^([\\da-fA-F]{8}-[\\da-fA-F]{4}-[1-8][\\da-fA-F]{3}-[89abAB][\\da-fA-F]{3}-[\\da-fA-F]{12}|0{8}-0{4}-0{4}-0{4}-0{12}|f{8}-f{4}-f{4}-f{4}-f{12})$"
},
"terms_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"anyOf": [
{
"required": [
"entry_id",
"price",
"unit",
"terms_hash",
"accept_terms"
],
"properties": {
"action": false,
"offer_id": false,
"interested": false,
"offer_hash": false,
"request_id": {
"$ref": "#/$defs/entry_id"
},
"accept_terms": {
"enum": [
true
]
},
"coming_soon_id": false,
"offer_terms_hash": false,
"sale_contact_consent": {
"enum": [
true
]
}
}
},
{
"required": [
"coming_soon_id",
"interested",
"action"
],
"properties": {
"action": {
"enum": [
"interest"
]
},
"request_id": {
"$ref": "#/$defs/entry_id"
}
},
"propertyNames": {
"enum": [
"coming_soon_id",
"interested",
"request_id",
"action",
"funding_accounts",
"max_fee"
]
}
},
{
"required": [
"entry_id",
"price",
"unit",
"terms_hash",
"accept_terms",
"action",
"offer_terms_hash"
],
"properties": {
"action": {
"enum": [
"offer"
]
},
"offer_id": false,
"interested": false,
"offer_hash": false,
"request_id": {
"$ref": "#/$defs/entry_id"
},
"accept_terms": {
"enum": [
true
]
},
"coming_soon_id": false,
"sale_contact_consent": {
"enum": [
true
]
}
}
},
{
"required": [
"action",
"offer_id",
"offer_hash",
"price",
"offer_terms_hash",
"accept_terms"
],
"properties": {
"unit": false,
"action": {
"enum": [
"counter"
]
},
"entry_id": false,
"interested": false,
"request_id": {
"$ref": "#/$defs/entry_id"
},
"terms_hash": false,
"accept_terms": {
"enum": [
true
]
},
"coming_soon_id": false,
"sale_contact_consent": {
"enum": [
true
]
}
}
},
{
"required": [
"action",
"offer_id",
"offer_hash",
"accept_terms"
],
"properties": {
"unit": false,
"price": false,
"action": {
"enum": [
"accept"
]
},
"entry_id": false,
"interested": false,
"request_id": {
"$ref": "#/$defs/entry_id"
},
"terms_hash": false,
"accept_terms": {
"enum": [
true
]
},
"coming_soon_id": false,
"offer_terms_hash": false,
"sale_contact_consent": {
"enum": [
true
]
}
}
},
{
"required": [
"action",
"offer_id"
],
"properties": {
"action": {
"enum": [
"decline",
"withdraw"
]
},
"request_id": {
"$ref": "#/$defs/entry_id"
}
},
"propertyNames": {
"enum": [
"action",
"offer_id",
"request_id",
"funding_accounts",
"max_fee"
]
}
}
],
"required": [
"request_id"
],
"properties": {
"unit": {
"anyOf": [
{
"type": "string",
"pattern": "^(?:(?:A(?:[EMU]D|[FZ]N|LL|OA|RS|WG)|B(?:AM|[BHMNSZ]D|DT|IF|O[BV]|RL|[TY]N|WP)|C(?:AD|DF|H[EFW]|L[FP]|NY|O[PU]|RC|UP|VE|ZK)|D(?:JF|KK|OP|ZD)|E(?:GP|RN|TB|UR)|F(?:JD|KP)|G(?:[BI]P|EL|HS|[MY]D|NF|TQ)|H(?:KD|NL|TG|UF)|I(?:[DNR]R|LS|QD|SK)|J(?:[MO]D|PY)|K(?:[EG]S|HR|MF|[PR]W|[WY]D|ZT)|L(?:AK|BP|KR|[RY]D|SL)|M(?:[AK]D|DL|GA|[MW]K|NT|OP|RU|[UVY]R|X[NV]|ZN)|N(?:[AZ]D|GN|IO|OK|PR)|OMR|P(?:AB|[EL]N|GK|HP|KR|YG)|QAR|R(?:ON|SD|UB|WF)|S(?:[AC]R|[BGR]D|DG|EK|[HSY]P|LE|OS|TN|VC|ZL)|T(?:HB|[JZ]S|MT|[NTW]D|OP|RY)|U(?:AH|GX|S[DN]|Y[IUW]|ZS)|V(?:E[DS]|ND|UV)|WST|X(?:A[DF]|C[DG]|[OP]F)|YER|Z(?:AR|MW|WG)))(?![\\s\\S])"
},
{
"type": "string",
"pattern": "^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}\\/[-a-z0-9]{3,8}:[-.%a-zA-Z0-9]{1,128}$"
}
]
},
"price": {
"type": "string",
"pattern": "^(0|[1-9]\\d{0,19})(\\.\\d{1,255})?$"
},
"action": {},
"max_fee": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,19})$"
},
"entry_id": {
"$ref": "#/$defs/entry_id"
},
"offer_id": {
"$ref": "#/$defs/entry_id"
},
"interested": {
"type": "boolean"
},
"offer_hash": {
"$ref": "#/$defs/terms_hash"
},
"request_id": {},
"terms_hash": {
"$ref": "#/$defs/terms_hash"
},
"accept_terms": {},
"coming_soon_id": {
"$ref": "#/$defs/entry_id"
},
"funding_accounts": {
"type": "object",
"properties": {
"grant_account_id": {
"type": "string",
"format": "uuid"
},
"normal_account_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"offer_terms_hash": {
"$ref": "#/$defs/terms_hash"
},
"sale_contact_consent": {}
},
"additionalProperties": false
}buy annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}credits — Manage credits and top-ups
Advertised destructiveOpen-world
Prepare top-ups or approve transfers, withdrawals, accounts and exports. Paid authority requires request_id and max_fee; x402 also requires an explicit cap. See auction://reference.
credits input schema
{
"type": "object",
"$defs": {
"label": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"route": {
"anyOf": [
{
"enum": [
"btc",
"algo",
"usdc",
"sibidz",
"usdt_ethereum",
"usdt_tron"
]
},
{
"type": "string",
"pattern": "^asset_[a-z0-9][a-z0-9_]{0,55}$"
}
]
},
"credits": {
"type": "string",
"pattern": "^(?:[1-9]\\d{0,3}|[12]\\d{4}|3[01]\\d{3}|32000)$"
},
"max_fee": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,19})$"
},
"principal": {
"type": "string",
"pattern": "^[1-9]\\d{0,19}$"
},
"request_id": {
"type": "string",
"format": "uuid",
"pattern": "^([\\da-fA-F]{8}-[\\da-fA-F]{4}-[1-8][\\da-fA-F]{3}-[89abAB][\\da-fA-F]{3}-[\\da-fA-F]{12}|0{8}-0{4}-0{4}-0{4}-0{12}|f{8}-f{4}-f{4}-f{4}-f{12})$"
},
"terms_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"operation_id": {
"$ref": "#/$defs/request_id"
},
"request_id_2": {
"$ref": "#/$defs/request_id"
},
"terms_version": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"customer_region": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"max_network_fee": {
"type": "string",
"pattern": "^(0|[1-9][0-9]*)$"
},
"funding_accounts": {
"type": "object",
"properties": {
"grant_account_id": {
"type": "string",
"format": "uuid"
},
"normal_account_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"principal_source": {
"$ref": "#/$defs/request_id"
},
"financial_principal": {
"type": "object",
"properties": {
"country": {
"type": "string"
},
"legal_name": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"minProperties": 2,
"additionalProperties": false
},
"customer_postal_code": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"customer_subdivision": {
"type": "string",
"maxLength": 100,
"minLength": 3
}
},
"oneOf": [
{
"type": "object",
"required": [
"action",
"request_id",
"route",
"credits",
"max_fee"
],
"properties": {
"route": {
"enum": [
"algo",
"usdc",
"sibidz"
]
},
"action": {
"enum": [
"x402"
]
},
"credits": {
"$ref": "#/$defs/credits"
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"terms_hash": {
"$ref": "#/$defs/terms_hash"
},
"accept_terms": {
"enum": [
true
]
},
"terms_version": {
"$ref": "#/$defs/terms_version"
},
"customer_region": {
"$ref": "#/$defs/customer_region"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"principal_source": {
"$ref": "#/$defs/principal_source"
},
"financial_principal": {
"$ref": "#/$defs/financial_principal"
},
"customer_postal_code": {
"$ref": "#/$defs/customer_postal_code"
},
"customer_subdivision": {
"$ref": "#/$defs/customer_subdivision"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"request_id",
"method",
"amount",
"accept_terms",
"terms_version",
"terms_hash",
"action"
],
"properties": {
"action": {
"enum": [
"fiat"
]
},
"amount": {
"type": "string",
"pattern": "^(?:0|[1-9]\\d{0,8})(?:\\.\\d{1,2})?$"
},
"method": {
"enum": [
"thb_international",
"thb_promptpay",
"gbp_international",
"gbp_local",
"usd_international",
"usd_domestic"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"terms_hash": {
"$ref": "#/$defs/terms_hash"
},
"accept_terms": {
"enum": [
true
]
},
"terms_version": {
"type": "string"
},
"customer_region": {
"$ref": "#/$defs/customer_region"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"principal_source": {
"$ref": "#/$defs/principal_source"
},
"financial_principal": {
"$ref": "#/$defs/financial_principal"
},
"customer_postal_code": {
"$ref": "#/$defs/customer_postal_code"
},
"customer_subdivision": {
"$ref": "#/$defs/customer_subdivision"
},
"destination_account_id": {
"$ref": "#/$defs/request_id"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"operation_id",
"request_id",
"action"
],
"properties": {
"action": {
"enum": [
"fiat_sent"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"operation_id": {
"$ref": "#/$defs/request_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"month",
"request_id",
"action",
"max_fee"
],
"properties": {
"month": {
"type": "string",
"pattern": "^(20[0-9]{2}|[3-9][0-9]{3})-(0[1-9]|1[0-2])$"
},
"action": {
"enum": [
"export"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"request_id",
"route",
"credits"
],
"properties": {
"route": {
"$ref": "#/$defs/route"
},
"action": {
"enum": [
"invoice"
]
},
"credits": {
"$ref": "#/$defs/credits"
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"terms_hash": {
"$ref": "#/$defs/terms_hash"
},
"accept_terms": {
"enum": [
true
]
},
"terms_version": {
"$ref": "#/$defs/terms_version"
},
"customer_region": {
"$ref": "#/$defs/customer_region"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"principal_source": {
"$ref": "#/$defs/principal_source"
},
"financial_principal": {
"$ref": "#/$defs/financial_principal"
},
"customer_postal_code": {
"$ref": "#/$defs/customer_postal_code"
},
"customer_subdivision": {
"$ref": "#/$defs/customer_subdivision"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"request_id",
"route"
],
"properties": {
"route": {
"$ref": "#/$defs/route"
},
"action": {
"enum": [
"deposit"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"request_id": {
"$ref": "#/$defs/request_id_2"
},
"terms_hash": {
"$ref": "#/$defs/terms_hash"
},
"accept_terms": {
"enum": [
true
]
},
"terms_version": {
"$ref": "#/$defs/terms_version"
},
"customer_region": {
"$ref": "#/$defs/customer_region"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"principal_source": {
"$ref": "#/$defs/principal_source"
},
"financial_principal": {
"$ref": "#/$defs/financial_principal"
},
"customer_postal_code": {
"$ref": "#/$defs/customer_postal_code"
},
"customer_subdivision": {
"$ref": "#/$defs/customer_subdivision"
}
},
"additionalProperties": false
},
{
"type": "object",
"oneOf": [
{
"required": [
"principal",
"destination"
],
"properties": {
"intent": {
"enum": [
"withdraw"
]
}
},
"propertyNames": {
"enum": [
"principal",
"destination",
"action",
"intent",
"request_id",
"source_account_id",
"funding_accounts",
"max_fee"
]
}
},
{
"required": [
"amount",
"recipient_profile_id"
],
"properties": {
"label": false,
"intent": {
"enum": [
"transfer"
]
},
"purpose": false,
"entry_id": false,
"principal": false,
"destination": false,
"ledger_account_id": false
}
},
{
"required": [
"purpose"
],
"properties": {
"intent": {
"enum": [
"create_account"
]
}
},
"propertyNames": {
"enum": [
"action",
"intent",
"request_id",
"purpose",
"label",
"funding_accounts",
"max_fee"
]
}
},
{
"required": [
"purpose",
"ledger_account_id"
],
"properties": {
"intent": {
"enum": [
"select_account"
]
}
},
"propertyNames": {
"enum": [
"action",
"intent",
"request_id",
"purpose",
"ledger_account_id",
"funding_accounts",
"max_fee"
]
}
},
{
"required": [
"entry_id"
],
"properties": {
"intent": {
"enum": [
"evidence"
]
}
},
"propertyNames": {
"enum": [
"action",
"intent",
"request_id",
"entry_id",
"funding_accounts",
"max_fee"
]
}
}
],
"required": [
"action",
"intent",
"request_id"
],
"properties": {
"label": {
"$ref": "#/$defs/label"
},
"action": {
"enum": [
"prepare"
]
},
"amount": {
"$ref": "#/$defs/principal"
},
"intent": {},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"purpose": {
"enum": [
"grant",
"normal"
]
},
"entry_id": {
"$ref": "#/$defs/request_id"
},
"principal": {
"$ref": "#/$defs/principal"
},
"request_id": {
"$ref": "#/$defs/request_id_2"
},
"destination": {
"type": "string"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"ledger_account_id": {
"$ref": "#/$defs/request_id"
},
"source_account_id": {
"$ref": "#/$defs/request_id"
},
"recipient_profile_id": {
"$ref": "#/$defs/request_id"
},
"destination_account_id": {
"$ref": "#/$defs/request_id"
}
},
"additionalProperties": false
},
{
"type": "object",
"oneOf": [
{
"required": [
"terms_version",
"terms_hash",
"accept_terms"
],
"properties": {
"intent": {
"enum": [
"top_up"
]
},
"approve": false,
"request_id": {
"$ref": "#/$defs/request_id"
},
"operation_id": {
"$ref": "#/$defs/request_id"
},
"terms_sha256": false,
"authority_digest": {
"$ref": "#/$defs/terms_hash"
}
}
},
{
"required": [
"terms_version",
"terms_sha256",
"accept_terms"
],
"properties": {
"intent": {
"enum": [
"withdraw"
]
},
"approve": false,
"request_id": {
"$ref": "#/$defs/request_id_2"
},
"terms_hash": false,
"operation_id": {
"$ref": "#/$defs/request_id"
},
"authority_digest": {
"$ref": "#/$defs/terms_hash"
}
}
},
{
"required": [
"approve"
],
"properties": {
"intent": {
"enum": [
"transfer",
"create_account",
"select_account",
"evidence"
]
},
"request_id": {
"$ref": "#/$defs/request_id_2"
},
"operation_id": {
"$ref": "#/$defs/operation_id"
},
"authority_digest": {
"$ref": "#/$defs/terms_hash"
}
},
"propertyNames": {
"enum": [
"action",
"intent",
"request_id",
"operation_id",
"authority_digest",
"approve",
"funding_accounts",
"max_fee"
]
}
}
],
"required": [
"action",
"intent",
"request_id",
"operation_id",
"authority_digest"
],
"properties": {
"action": {
"enum": [
"confirm"
]
},
"intent": {},
"approve": {
"enum": [
true
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"request_id": {},
"terms_hash": {
"$ref": "#/$defs/terms_hash"
},
"accept_terms": {
"enum": [
true
]
},
"operation_id": {},
"terms_sha256": {
"$ref": "#/$defs/terms_hash"
},
"terms_version": {
"$ref": "#/$defs/label"
},
"customer_region": {
"$ref": "#/$defs/customer_region"
},
"authority_digest": {},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"principal_source": {
"$ref": "#/$defs/principal_source"
},
"financial_principal": {
"$ref": "#/$defs/financial_principal"
},
"customer_postal_code": {
"$ref": "#/$defs/customer_postal_code"
},
"customer_subdivision": {
"$ref": "#/$defs/customer_subdivision"
}
},
"additionalProperties": false
},
{
"oneOf": [
{
"type": "object",
"required": [
"action",
"step",
"request_id",
"operation_id"
],
"properties": {
"step": {
"enum": [
"sent"
]
},
"action": {
"enum": [
"continue"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"request_id": {
"$ref": "#/$defs/request_id_2"
},
"operation_id": {
"$ref": "#/$defs/operation_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"step",
"request_id",
"operation_id",
"payment"
],
"properties": {
"step": {
"enum": [
"payment"
]
},
"action": {
"enum": [
"continue"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"payment": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"transaction_id"
],
"properties": {
"kind": {
"enum": [
"transaction"
]
},
"round": {
"$ref": "#/$defs/principal"
},
"inner_path": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"maxItems": 16
},
"event_index": {
"type": "integer",
"maximum": 4294967295,
"minimum": 0
},
"transaction_id": {
"type": "string",
"pattern": "^(?:[A-Z2-7]{52}|(?:0x)?[a-fA-F0-9]{64})$"
}
},
"additionalProperties": false
}
]
},
"request_id": {
"$ref": "#/$defs/request_id_2"
},
"operation_id": {
"$ref": "#/$defs/operation_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
}
},
"additionalProperties": false
},
{
"type": "object",
"oneOf": [
{
"required": [
"min_net",
"accept"
],
"properties": {
"decision": {
"enum": [
"partial_take",
"continue_requote"
]
},
"expected_revision": {
"type": "string",
"pattern": "^\\d+$"
}
},
"propertyNames": {
"enum": [
"operation_id",
"expected_revision",
"decision",
"min_net",
"accept",
"action",
"step",
"request_id",
"funding_accounts",
"max_fee"
]
}
},
{
"required": [
"valuation_id",
"gross_cap",
"min_net",
"accept"
],
"properties": {
"decision": {
"enum": [
"renew_btc"
]
},
"fee_payer": false,
"destination": false,
"obligation_id": false,
"max_network_fee": false,
"expected_revision": {
"type": "string",
"pattern": "^\\d+$"
},
"confirm_destination": false
}
},
{
"required": [
"destination",
"confirm_destination",
"fee_payer",
"max_network_fee"
],
"properties": {
"accept": false,
"min_net": false,
"decision": {
"enum": [
"return_original"
]
},
"gross_cap": false,
"valuation_id": false,
"expected_revision": {
"$ref": "#/$defs/max_network_fee"
}
}
}
],
"required": [
"operation_id",
"expected_revision",
"decision",
"action",
"step",
"request_id"
],
"properties": {
"step": {
"enum": [
"recovery"
]
},
"accept": {
"enum": [
true
]
},
"action": {
"enum": [
"continue"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"min_net": {
"type": "string",
"pattern": "^[1-9]\\d*$"
},
"decision": {},
"fee_payer": {
"enum": [
"company"
]
},
"gross_cap": {
"type": "string",
"pattern": "^[1-9]\\d*$"
},
"request_id": {
"$ref": "#/$defs/request_id_2"
},
"destination": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"operation_id": {
"$ref": "#/$defs/request_id"
},
"valuation_id": {
"$ref": "#/$defs/request_id"
},
"obligation_id": {
"$ref": "#/$defs/request_id"
},
"max_network_fee": {
"$ref": "#/$defs/max_network_fee"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"expected_revision": {},
"confirm_destination": {
"enum": [
true
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"step",
"operation_id",
"request_id"
],
"properties": {
"step": {
"enum": [
"link",
"revoke_link"
]
},
"action": {
"enum": [
"continue"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"request_id": {
"$ref": "#/$defs/request_id_2"
},
"operation_id": {
"$ref": "#/$defs/operation_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
}
},
"additionalProperties": false
}
]
},
{
"type": "object",
"required": [
"action",
"operation_id",
"request_id"
],
"properties": {
"action": {
"enum": [
"cancel"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"request_id": {
"$ref": "#/$defs/request_id_2"
},
"operation_id": {
"$ref": "#/$defs/operation_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
}
},
"additionalProperties": false
}
]
}credits annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}feedback — Review a trade and confirm handover
Submit an immutable review under its frozen fee or confirm handover free. Paid reviews require request_id and max_fee. Read eligibility first. See auction://reference.
feedback input schema
{
"type": "object",
"$defs": {
"entry_id": {
"type": "string",
"format": "uuid",
"pattern": "^([\\da-fA-F]{8}-[\\da-fA-F]{4}-[1-8][\\da-fA-F]{3}-[89abAB][\\da-fA-F]{3}-[\\da-fA-F]{12}|0{8}-0{4}-0{4}-0{4}-0{12}|f{8}-f{4}-f{4}-f{4}-f{12})$"
}
},
"oneOf": [
{
"required": [
"rating",
"comment"
],
"properties": {
"action": {
"enum": [
"submit"
]
},
"confirmed": false
}
},
{
"required": [
"confirmed"
],
"properties": {
"action": {
"enum": [
"confirm_handover"
]
},
"rating": false,
"comment": false
}
}
],
"required": [
"entry_id",
"action",
"request_id"
],
"properties": {
"action": {},
"rating": {
"type": "integer",
"maximum": 10,
"minimum": 1
},
"comment": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"max_fee": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,19})$"
},
"entry_id": {
"$ref": "#/$defs/entry_id"
},
"confirmed": {
"enum": [
true
]
},
"request_id": {
"$ref": "#/$defs/entry_id"
},
"funding_accounts": {
"type": "object",
"properties": {
"grant_account_id": {
"type": "string",
"format": "uuid"
},
"normal_account_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}feedback annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}contact — Contact support or message about an item
Open-world
Send free support or appeals, or paid private item messages with request_id and max_fee. Reads are free; messages never authorize spending. See auction://reference.
contact input schema
{
"type": "object",
"$defs": {
"conversation_id": {
"type": "string",
"format": "uuid",
"pattern": "^([\\da-fA-F]{8}-[\\da-fA-F]{4}-[1-8][\\da-fA-F]{3}-[89abAB][\\da-fA-F]{3}-[\\da-fA-F]{12}|0{8}-0{4}-0{4}-0{4}-0{12}|f{8}-f{4}-f{4}-f{4}-f{12})$"
}
},
"oneOf": [
{
"required": [
"message"
],
"properties": {
"text": false,
"action": {
"enum": [
"message"
]
},
"entry_id": false,
"request_id": {
"$ref": "#/$defs/conversation_id"
},
"decision_id": false
}
},
{
"required": [
"decision_id",
"text"
],
"properties": {
"to": false,
"human": false,
"action": {
"enum": [
"appeal"
]
},
"message": false,
"entry_id": false,
"request_id": {
"$ref": "#/$defs/conversation_id"
},
"conversation_id": false
}
},
{
"required": [
"message"
],
"properties": {
"to": false,
"text": false,
"human": false,
"action": {
"enum": [
"item_message"
]
},
"request_id": {
"$ref": "#/$defs/conversation_id"
},
"decision_id": false
}
}
],
"required": [
"request_id",
"action"
],
"properties": {
"to": {
"type": "string",
"pattern": "^@?[a-z0-9][a-z0-9_-]{1,39}$"
},
"text": {
"type": "string",
"maxLength": 3000,
"minLength": 1
},
"human": {
"type": "boolean"
},
"action": {},
"max_fee": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,19})$"
},
"message": {
"type": "string",
"maxLength": 6000,
"minLength": 1
},
"entry_id": {
"$ref": "#/$defs/conversation_id"
},
"request_id": {},
"decision_id": {
"$ref": "#/$defs/conversation_id"
},
"conversation_id": {
"$ref": "#/$defs/conversation_id"
},
"funding_accounts": {
"type": "object",
"properties": {
"grant_account_id": {
"type": "string",
"format": "uuid"
},
"normal_account_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}contact annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}research — Identify cards and request market research
Open-world
Read prices free; approve identification or a report with request_id and max_fee. Status, downloads and cancellation are free; each purchase needs approval. See auction://reference.
research input schema
{
"type": "object",
"$defs": {
"game": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"input": {
"type": "object",
"properties": {
"text": {
"type": "string",
"maxLength": 4000,
"minLength": 1
},
"image": {
"type": "object",
"oneOf": [
{
"type": "object",
"properties": {
"action": {
"enum": [
"upload"
]
},
"mime_type": {
"enum": [
"image/jpeg",
"image/png",
"image/webp"
]
},
"data_base64": {
"type": "string",
"maxLength": 13333336,
"minLength": 4
}
},
"minProperties": 3,
"additionalProperties": false
},
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"action": {
"enum": [
"import"
]
}
},
"minProperties": 2,
"additionalProperties": false
}
]
},
"grades": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"kind": {
"enum": [
"raw"
]
}
},
"minProperties": 1,
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"enum": [
"graded"
]
},
"grade": {
"$ref": "#/$defs/game"
},
"company": {
"$ref": "#/$defs/game"
}
},
"minProperties": 3,
"additionalProperties": false
}
]
},
"maxItems": 5,
"minItems": 1
},
"country": {
"type": "string"
},
"currency": {
"type": "string"
},
"card_details": {
"type": "object",
"properties": {
"game": {
"$ref": "#/$defs/game"
},
"edition": {
"$ref": "#/$defs/edition"
},
"variant": {
"$ref": "#/$defs/edition"
},
"language": {
"$ref": "#/$defs/game"
},
"set_name": {
"$ref": "#/$defs/set_name"
},
"card_name": {
"$ref": "#/$defs/set_name"
},
"collector_number": {
"$ref": "#/$defs/game"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"edition": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"max_fee": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,19})$"
},
"set_name": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"request_id": {
"type": "string",
"format": "uuid",
"pattern": "^([\\da-fA-F]{8}-[\\da-fA-F]{4}-[1-8][\\da-fA-F]{3}-[89abAB][\\da-fA-F]{3}-[\\da-fA-F]{12}|0{8}-0{4}-0{4}-0{4}-0{12}|f{8}-f{4}-f{4}-f{4}-f{12})$"
},
"funding_accounts": {
"type": "object",
"properties": {
"grant_account_id": {
"type": "string",
"format": "uuid"
},
"normal_account_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"expected_identification_revision": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"oneOf": [
{
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"enum": [
"offer"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
}
},
"additionalProperties": false
},
{
"type": "object",
"oneOf": [
{
"properties": {
"input": {
"$ref": "#/$defs/input"
},
"action": {
"enum": [
"request"
]
},
"product": {
"enum": [
"report"
]
},
"example_id": false,
"example_revision": false
}
},
{
"required": [
"input"
],
"properties": {
"input": {
"$ref": "#/$defs/input"
},
"action": {
"enum": [
"request"
]
},
"product": {
"enum": [
"identification"
]
}
},
"propertyNames": {
"enum": [
"action",
"product",
"request_id",
"input",
"funding_accounts",
"max_fee"
]
}
},
{
"required": [
"example_id",
"example_revision"
],
"properties": {
"input": false,
"action": {
"enum": [
"request"
]
},
"product": {
"enum": [
"example"
]
},
"identification_order_id": false,
"expected_identification_revision": false
}
}
],
"required": [
"action",
"product",
"request_id",
"max_fee"
],
"properties": {
"input": {},
"action": {},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"product": {},
"example_id": {
"$ref": "#/$defs/request_id"
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"example_revision": {
"$ref": "#/$defs/expected_identification_revision"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"identification_order_id": {
"$ref": "#/$defs/request_id"
},
"expected_identification_revision": {
"$ref": "#/$defs/expected_identification_revision"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"order_id"
],
"properties": {
"action": {
"enum": [
"status",
"download"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"order_id": {
"$ref": "#/$defs/request_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"order_id",
"request_id",
"expected_revision",
"max_fee"
],
"properties": {
"input": {
"$ref": "#/$defs/input"
},
"action": {
"enum": [
"continue"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"order_id": {
"$ref": "#/$defs/request_id"
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"expected_revision": {
"$ref": "#/$defs/expected_identification_revision"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"order_id",
"request_id",
"expected_revision"
],
"properties": {
"action": {
"enum": [
"cancel"
]
},
"max_fee": {
"$ref": "#/$defs/max_fee"
},
"order_id": {
"$ref": "#/$defs/request_id"
},
"request_id": {
"$ref": "#/$defs/request_id"
},
"funding_accounts": {
"$ref": "#/$defs/funding_accounts"
},
"expected_revision": {
"$ref": "#/$defs/expected_identification_revision"
}
},
"additionalProperties": false
}
]
}research annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
9 advertised
agent-guide — Start here: auction workflow and costs
Concise buyer/seller guide. Free; no account required.
agent-guide URI
auction://guideagent-examples — Core tool examples
JSON-RPC examples for onboarding, auctions, referrals and readiness-gated crypto purchases/redemption; exact retry guidance included. Free; no account required.
agent-examples URI
auction://examplesauction-reference — Detailed workflow and examples
Detailed policies and JSON examples. Free; no account required.
auction-reference URI
auction://referenceauction-errors — Errors and recovery
Error recovery and billing rules. Free; no account required.
auction-errors URI
auction://errorsauction-spec — Complete MCP contract
Tools, schemas, costs, account actions and errors. Free; no account required.
auction-spec URI
auction://specagreements — Participation agreement
Current immutable participation terms, version and SHA-256. Free; no account required.
agreements URI
auction://agreementssale-contact — Sale contact disclosure
Exact disclosure and explicit authorisation required before submission or the first accepted bid. Free; no account required.
sale-contact URI
auction://sale-contactprices — SIBIDZ price schedule
Every paid action and its credit cost. Free; no account required.
prices URI
auction://pricescurrencies — Currencies and digital assets
Supported fiat precision and network-qualified crypto identifiers. Free; no account required.
currencies URI
auction://currenciesentries-events — Selected auction events
Exact run-pinned resource. Native subscription includes initial snapshot and attachment for 6 credits per new target. Changed reads and same-connection renewal cost 2; reconnect admission costs 6. One receiver multiplexes selected resources.
entries-events URI template
auction://entries/{id}/events{?run,after}auctions-events — Selected auction events
Exact run-pinned resource. Native subscription includes initial snapshot and attachment for 6 credits per new target. Changed reads and same-connection renewal cost 2; reconnect admission costs 6. One receiver multiplexes selected resources.
auctions-events URI template
auction://auctions/{id}/events{?run,after}private-progress — Your workflow progress
Private seller/item checks, submission admission and financial operation progress. Free reads and subscriptions. Subscribe before reading, then read only on notifications or reconnect.
private-progress URI template
auction://progress/{kind}/{id}private-messages — Your private inbox
Durable contact replies, rewards and final auction outcomes. Free. Subscribe once, read immediately, then read on notifications; save next_cursor per client. Reads never mark messages read for another agent.
private-messages URI template
auction://messages/profile/{profile_id}{?after}historical-agreement — Exact agreement version
Free exact published agreement version; no account required.
historical-agreement URI template
auction://agreements{?version}lot-price-history — Lot auction and price history
Free public hammer prices, original currencies, auction results and activity. Latest first; before pages backward and after catches up. Private listings require their seller.
lot-price-history URI template
auction://lots/{lot_id}/history{?after,before}auction-runs — Catalogue runs
Free run list, newest first, with pinned history links for completed runs. Follow next_cursor as after.
auction-runs URI template
auction://auctions/{auction_id}/runs{?after}auction-price-history — Completed auction prices and history
Free public completed-auction results in their original currencies and sanitized history. Results and events each page at 100. Follow results_next_uri for more outcomes, next_uri for more events, or resume events with after=next_cursor. No watch or subscription is created.
auction-price-history URI template
auction://auctions/{auction_id}/history{?run,after,results_after}30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 4079 ms
- 95th percentile latency
- 4079 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 4079 ms · metadata changed · 9 tool(s), 9 resource(s), 8 resource template(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http sibidz-mcp https://sibidz.io/mcpCodex
Codex configuration
codex mcp add sibidz-mcp --url https://sibidz.io/mcpCursor
Cursor configuration
{
"mcpServers": {
"sibidz-mcp": {
"url": "https://sibidz.io/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"sibidz-mcp": {
"type": "streamableHttp",
"url": "https://sibidz.io/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"sibidz-mcp": {
"type": "http",
"url": "https://sibidz.io/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http sibidz-mcp https://sibidz.io/mcpClaude Desktop
Claude Desktop configuration
{
"mcpServers": {
"sibidz-mcp": {
"url": "https://sibidz.io/mcp"
}
}
}Windsurf
Windsurf configuration
{
"mcpServers": {
"sibidz-mcp": {
"serverUrl": "https://sibidz.io/mcp"
}
}
}Let your agent find its tools
Find servers like SIBIDZ MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other commerce servers
Do you run SIBIDZ MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.