Trade Bitcoin Up/Down prediction markets on Lucyd: markets, order books, orders, positions.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Full details of one market, including its rules and the ids of its up and down outcome tokens.
Market address (its id), from list_markets.
Full details of one market, including its rules and the ids of its up and down outcome tokens.
| Argument | Type | Description |
|---|---|---|
| market* | string | Market address (its id), from list_markets. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"market"
],
"properties": {
"market": {
"type": "string",
"description": "Market address (its id), from list_markets."
}
}
}Order book of a market outcome: bids (best first) and asks with prices in USDC per token and sizes in tokens, plus best bid, best ask and mid. Buying down at p is the same book as selling up at 1 - p.
| Argument | Type | Description |
|---|---|---|
| market* | string | Market address. |
| outcome | string | null | Outcome whose book to show: up or down. Default up. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"market"
],
"properties": {
"market": {
"type": "string",
"description": "Market address."
},
"outcome": {
"type": [
"string",
"null"
],
"description": "Outcome whose book to show: up or down. Default up."
}
}
}Profit and loss over time of a wallet, as a series of points. Defaults to the configured wallet.
| Argument | Type | Description |
|---|---|---|
| range | string | null | Period: 1d, 1w, 1m or all. Default 1w. |
| address | string | null | Wallet address. Default: the configured wallet. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"range": {
"type": [
"string",
"null"
],
"description": "Period: 1d, 1w, 1m or all. Default 1w."
},
"address": {
"type": [
"string",
"null"
],
"description": "Wallet address. Default: the configured wallet."
}
}
}Positions of a wallet: tokens held per market and outcome, average price, current value and profit. Settled markets show the payout. Defaults to the configured wallet.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | How many positions, 1 to 100. Default 50. |
| state | string | null | Market state filter: open, pending, settled or voided. |
| market | string | null | Only this market address, or several comma separated. |
| trader | string | null | Wallet address. Default: the configured wallet. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "How many positions, 1 to 100. Default 50."
},
"state": {
"type": [
"string",
"null"
],
"description": "Market state filter: open, pending, settled or voided."
},
"market": {
"type": [
"string",
"null"
],
"description": "Only this market address, or several comma separated."
},
"trader": {
"type": [
"string",
"null"
],
"description": "Wallet address. Default: the configured wallet."
}
}
}Health of the Lucyd service: API and database, settlement of ended markets on time, live trade stream. Use it when something looks stuck, e.g. a market is not resolving.
No arguments.
{
"type": "object",
"properties": {}
}Stats of a wallet: total and realized profit, volume, markets traded, win rate. Defaults to the configured wallet.
| Argument | Type | Description |
|---|---|---|
| address | string | null | Wallet address. Default: the configured wallet. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"address": {
"type": [
"string",
"null"
],
"description": "Wallet address. Default: the configured wallet."
}
}
}List prediction markets on Lucyd. Each market asks whether the BTC price will be Up or Down at its end date versus the strike (strike is the price times 1e8). Returns address (the market id), state, period, start and end dates, strike, winner and volume.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | How many markets to return, 1 to 100. Default 20. |
| order | string | null | Sort by end date: asc or desc. Default desc. |
| state | string | null | Market state: open, pending (ended, waiting for result), settled or voided. Comma separated for several. |
| offset | integer | null | Skip this many markets, for paging. |
| period | string | null | Market period: 5m, 15m, 30m, 1h, 4h or Daily. Comma separated for several. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "How many markets to return, 1 to 100. Default 20."
},
"order": {
"type": [
"string",
"null"
],
"description": "Sort by end date: asc or desc. Default desc."
},
"state": {
"type": [
"string",
"null"
],
"description": "Market state: open, pending (ended, waiting for result), settled or voided. Comma separated for several."
},
"offset": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Skip this many markets, for paging."
},
"period": {
"type": [
"string",
"null"
],
"description": "Market period: 5m, 15m, 30m, 1h, 4h or Daily. Comma separated for several."
}
}
}Recent trades, newest first. Filter by market and/or trader. Amounts are in USDC and tokens.
| Argument | Type | Description |
|---|---|---|
| to | integer | null | Only trades before this time, unix seconds. |
| from | integer | null | Only trades after this time, unix seconds. |
| limit | integer | null | How many trades, 1 to 100. Default 20. |
| market | string | null | Only trades on this market address. |
| trader | string | null | Only trades of this wallet. Use "me" for the configured wallet. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"to": {
"type": [
"integer",
"null"
],
"format": "uint64",
"minimum": 0,
"description": "Only trades before this time, unix seconds."
},
"from": {
"type": [
"integer",
"null"
],
"format": "uint64",
"minimum": 0,
"description": "Only trades after this time, unix seconds."
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "How many trades, 1 to 100. Default 20."
},
"market": {
"type": [
"string",
"null"
],
"description": "Only trades on this market address."
},
"trader": {
"type": [
"string",
"null"
],
"description": "Only trades of this wallet. Use \"me\" for the configured wallet."
}
}
}Leaderboard of traders, best first.
| Argument | Type | Description |
|---|---|---|
| sort | string | null | Sort field: pnl, volume, markets or win_rate. Default pnl. |
| limit | integer | null | How many traders, 1 to 50. Default 10. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sort": {
"type": [
"string",
"null"
],
"description": "Sort field: pnl, volume, markets or win_rate. Default pnl."
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "How many traders, 1 to 50. Default 10."
}
}
}