Server definition
- Hash
- sha256:c623416979faa1f5b1dd962401a3135472b1355e1ffd3c6c853127b7b9860519
- What it is
- What a remote MCP server returned when asked what it offers: 5 tools
The blob, as servednamed by its sha256
{
"instructions": "PolyTest serves historical data for Polymarket crypto Up/Down markets. A market asks whether a coin's price ends a fixed window at or above where it started. Each market has about 8 snapshots per second with the coin spot price and the Up and Down token prices. Order books are optional. All tools are read-only. Usual flow: polytest_list_markets to find a market, polytest_get_price_series for the shape of that market, then polytest_get_snapshots for tick detail or the order book at one moment.\n\nRules:\n- market_type is one of 5m, 15m, 1hr, 4hr, 24hr. Do not write 1h or 4h.\n- coin is btc, eth, or sol, in lowercase. 4hr and 24hr markets exist for btc only.\n- Times are ISO 8601. A time with no zone is UTC.\n- price_up and price_down are the lowest asks on each side's order book, from 0 to 1. Together they usually add up to a little more than 1.\n- Read a market's status field, not its winner, to tell whether it is still running. PolyTest loads new markets in batches, so the newest data can be hours old. polytest_list_markets says so when it is.\n- Markets list newest first. Snapshots list oldest first.\n- A tie resolves Up. Up wins when the close is at or above the open.\n- Every call counts against the caller's plan limits. Each tool description states its cost in API requests. polytest_get_limits shows the plan.\n- For bulk pulls or backtests, write code against the REST API or the @polytest/sdk package instead of paging through tools. SDK docs: https://www.polytest.io/docs/sdk",
"tools": [
{
"description": "Returns the plan behind the current credential, an API key or a signed-in account: tier, rate limits, concurrency cap, data access, key cap, and trial budget. data_access gives how many of the most recent markets of each type the plan can read. A null cap means no cap. trial_budget is what a free trial may use in total over its 3 days. It applies only during a trial and does not show how much is left. Use it before a large read or after a plan or rate limit error. Costs 1 API request.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"type": "object"
},
"name": "polytest_get_limits",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"api_keys": {
"additionalProperties": false,
"properties": {
"max_active": {
"type": [
"number",
"null"
]
}
},
"required": [
"max_active"
],
"type": "object"
},
"concurrency": {
"additionalProperties": false,
"properties": {
"max_concurrent": {
"type": [
"number",
"null"
]
}
},
"required": [
"max_concurrent"
],
"type": "object"
},
"data_access": {
"additionalProperties": false,
"properties": {
"15m_markets": {
"type": [
"number",
"null"
]
},
"1hr_markets": {
"type": [
"number",
"null"
]
},
"24hr_markets": {
"type": [
"number",
"null"
]
},
"4hr_markets": {
"type": [
"number",
"null"
]
},
"5m_markets": {
"type": [
"number",
"null"
]
},
"snapshots_per_market": {
"type": [
"number",
"null"
]
}
},
"required": [
"5m_markets",
"15m_markets",
"1hr_markets",
"4hr_markets",
"24hr_markets",
"snapshots_per_market"
],
"type": "object"
},
"rate_limits": {
"additionalProperties": false,
"properties": {
"burst_per_second": {
"type": "number"
},
"requests_per_minute": {
"type": "number"
}
},
"required": [
"requests_per_minute",
"burst_per_second"
],
"type": "object"
},
"tier": {
"type": "string"
},
"trial_budget": {
"additionalProperties": false,
"properties": {
"bytes": {
"type": "number"
},
"records": {
"type": "number"
},
"requests": {
"type": "number"
}
},
"required": [
"requests",
"records",
"bytes"
],
"type": "object"
}
},
"required": [
"tier",
"rate_limits",
"concurrency",
"data_access",
"api_keys",
"trial_budget"
],
"type": "object"
}
},
{
"description": "Returns one market by market_id or by slug. Pass exactly one of them. A slug is the last path segment of a Polymarket event URL, as in https://polymarket.com/event/<slug>, and the whole URL works too. Use it to resolve a Polymarket link or to read the full record of a market, including token ids and resolution fields. Costs 1 API request.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"market_id": {
"description": "PolyTest market id. Pass this or slug, not both.",
"type": "string"
},
"slug": {
"description": "A Polymarket event URL, or its last path segment. Pass this or market_id, not both.",
"type": "string"
}
},
"type": "object"
},
"name": "polytest_get_market",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"market": {
"additionalProperties": false,
"properties": {
"clob_token_down": {
"type": [
"string",
"null"
]
},
"clob_token_up": {
"type": [
"string",
"null"
]
},
"coin": {
"type": "string"
},
"condition_id": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
]
},
"end_time": {
"type": "string"
},
"event_id": {
"type": "string"
},
"final_liquidity": {
"type": [
"number",
"null"
]
},
"final_volume": {
"type": [
"number",
"null"
]
},
"market_id": {
"type": "string"
},
"market_type": {
"type": "string"
},
"price_end": {
"description": "Coin spot price when the window closed. Null until it is recorded.",
"type": [
"number",
"null"
]
},
"price_start": {
"description": "Coin spot price when the window opened.",
"type": [
"number",
"null"
]
},
"resolved_at": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"start_time": {
"type": "string"
},
"status": {
"description": "upcoming: not started. open: the window is still running. resolved: the winner is known. ended_no_result: the window closed and PolyTest has no result for it.",
"enum": [
"upcoming",
"open",
"resolved",
"ended_no_result"
],
"type": "string"
},
"updated_at": {
"type": [
"string",
"null"
]
},
"winner": {
"description": "Winning side once the market resolves. A tie resolves Up.",
"type": [
"string",
"null"
]
}
},
"required": [
"market_id",
"slug",
"market_type",
"coin",
"start_time",
"end_time",
"price_start",
"price_end",
"winner",
"final_volume",
"resolved_at",
"status",
"event_id",
"final_liquidity",
"condition_id",
"clob_token_up",
"clob_token_down",
"created_at",
"updated_at"
],
"type": "object"
}
},
"required": [
"market"
],
"type": "object"
}
},
{
"description": "Returns evenly spaced price points across one market, oldest first. Use it to see the shape of a market without paging through snapshots. It splits the market window, or the part of it inside start_time and end_time, into samples equal buckets and returns the first snapshot of each bucket. Each point has time, spot_price, price_up, and price_down. empty_buckets counts the buckets with no snapshot, and note says where the data ends when the last buckets are empty. For a market still running, the range stops at the current time. Costs 1 + samples API requests, which is 21 with the default. The result is complete and has no paging. For more detail, raise samples or call polytest_get_snapshots on a short range.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end_time": {
"description": "ISO 8601. End of the range. Defaults to the market end. No zone means UTC.",
"type": "string"
},
"market_id": {
"description": "PolyTest market id from polytest_list_markets or polytest_get_market.",
"type": "string"
},
"samples": {
"default": 20,
"description": "Number of buckets. Each one costs 1 API request.",
"maximum": 60,
"minimum": 2,
"type": "integer"
},
"start_time": {
"description": "ISO 8601. Start of the range. Defaults to the market start. No zone means UTC.",
"type": "string"
}
},
"required": [
"market_id"
],
"type": "object"
},
"name": "polytest_get_price_series",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bucket_seconds": {
"description": "Length of each bucket in seconds.",
"type": "number"
},
"empty_buckets": {
"description": "Buckets that had no snapshot.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"end_time": {
"description": "End of the sampled range.",
"type": "string"
},
"market_id": {
"type": "string"
},
"note": {
"type": "string"
},
"points": {
"items": {
"additionalProperties": false,
"properties": {
"price_down": {
"description": "Lowest ask on the Down order book, 0 to 1: what buying Down cost at that moment. Null when nobody was selling Down. Up and Down asks usually add up to a little more than 1.",
"type": [
"number",
"null"
]
},
"price_up": {
"description": "Lowest ask on the Up order book, 0 to 1: what buying Up cost at that moment. Null when nobody was selling Up.",
"type": [
"number",
"null"
]
},
"spot_price": {
"description": "Coin spot price.",
"type": [
"number",
"null"
]
},
"time": {
"type": "string"
}
},
"required": [
"time",
"spot_price",
"price_up",
"price_down"
],
"type": "object"
},
"type": "array"
},
"requests_used": {
"description": "API requests this call made, retries included.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"start_time": {
"description": "Start of the sampled range.",
"type": "string"
}
},
"required": [
"market_id",
"start_time",
"end_time",
"bucket_seconds",
"points",
"empty_buckets",
"requests_used"
],
"type": "object"
}
},
{
"description": "Returns snapshots of one market, oldest first. Each row has time, spot_price, price_up, and price_down. Use it for tick detail in a short time range. For the shape of a whole market, use polytest_get_price_series. A market has about 8 snapshots per second, so narrow the range with start_time and end_time. With include_orderbook each row also has the Up and Down order books, cut to orderbook_depth levels per side, and a page holds at most 20 rows. The book at one moment is this tool with start_time set to that moment, limit 1, and include_orderbook true. Costs 1 API request. To continue, call again with offset set to next_offset while stop is \"more\". stop \"snapshot_offset_cap\" means offsets end at 100000, so move start_time forward to continue. If truncated is true, rows were cut to keep the result small and next_offset points at the first cut row.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end_time": {
"description": "ISO 8601. Keeps snapshots at or before this time. No zone means UTC.",
"type": "string"
},
"include_orderbook": {
"default": false,
"description": "Adds the Up and Down order books to each row.",
"type": "boolean"
},
"limit": {
"default": 50,
"description": "Rows per page. At most 20 with order books.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"market_id": {
"description": "PolyTest market id from polytest_list_markets or polytest_get_market.",
"type": "string"
},
"offset": {
"default": 0,
"description": "Rows to skip. Pass next_offset from the previous page.",
"maximum": 100000,
"minimum": 0,
"type": "integer"
},
"orderbook_depth": {
"default": 5,
"description": "Price levels kept per side of each book.",
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"start_time": {
"description": "ISO 8601. Keeps snapshots at or after this time. No zone means UTC.",
"type": "string"
}
},
"required": [
"market_id"
],
"type": "object"
},
"name": "polytest_get_snapshots",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"count": {
"description": "Rows in this result.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"market_id": {
"type": "string"
},
"next_offset": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Offset of the next page when stop is more."
},
"note": {
"type": "string"
},
"snapshots": {
"items": {
"additionalProperties": false,
"properties": {
"orderbook_down": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"asks": {
"description": "Best ask first.",
"items": {
"additionalProperties": false,
"properties": {
"price": {
"type": "number"
},
"size": {
"type": "number"
}
},
"required": [
"price",
"size"
],
"type": "object"
},
"type": "array"
},
"bids": {
"description": "Best bid first.",
"items": {
"additionalProperties": false,
"properties": {
"price": {
"type": "number"
},
"size": {
"type": "number"
}
},
"required": [
"price",
"size"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"bids",
"asks"
],
"type": "object"
},
{
"type": "null"
}
]
},
"orderbook_up": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"asks": {
"description": "Best ask first.",
"items": {
"additionalProperties": false,
"properties": {
"price": {
"type": "number"
},
"size": {
"type": "number"
}
},
"required": [
"price",
"size"
],
"type": "object"
},
"type": "array"
},
"bids": {
"description": "Best bid first.",
"items": {
"additionalProperties": false,
"properties": {
"price": {
"type": "number"
},
"size": {
"type": "number"
}
},
"required": [
"price",
"size"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"bids",
"asks"
],
"type": "object"
},
{
"type": "null"
}
]
},
"price_down": {
"description": "Lowest ask on the Down order book, 0 to 1: what buying Down cost at that moment. Null when nobody was selling Down. Up and Down asks usually add up to a little more than 1.",
"type": [
"number",
"null"
]
},
"price_up": {
"description": "Lowest ask on the Up order book, 0 to 1: what buying Up cost at that moment. Null when nobody was selling Up.",
"type": [
"number",
"null"
]
},
"spot_price": {
"description": "Coin spot price.",
"type": [
"number",
"null"
]
},
"time": {
"type": "string"
}
},
"required": [
"time",
"spot_price",
"price_up",
"price_down"
],
"type": "object"
},
"type": "array"
},
"stop": {
"enum": [
"more",
"end",
"tier_window",
"snapshot_offset_cap"
],
"type": "string"
},
"truncated": {
"description": "True when rows were cut to keep the result small.",
"type": "boolean"
}
},
"required": [
"market_id",
"snapshots",
"count",
"stop",
"next_offset",
"truncated"
],
"type": "object"
}
},
{
"description": "Lists Up/Down markets of one market_type for one coin. Use it to find a market_id before reading snapshots or a price series. Returns market rows, newest first by start time, each with its window, opening and closing spot price, winner, volume, and status. Use status, not winner, to tell whether a market is still running. coin is btc, eth, or sol, and 4hr and 24hr markets exist for btc only. start_time and end_time filter on the market start time. PolyTest loads new markets in batches, and note says so when the newest market is hours old. Costs 1 API request. To continue, call again with offset set to next_offset while stop is \"more\". stop \"tier_window\" means the plan does not cover the requested markets. If truncated is true, rows were cut to keep the result small and next_offset points at the first cut row.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"coin": {
"default": "btc",
"description": "Coin symbol in lowercase: btc, eth, or sol. 4hr and 24hr markets exist for btc only.",
"type": "string"
},
"end_time": {
"description": "ISO 8601. Keeps markets that start at or before this time. No zone means UTC.",
"type": "string"
},
"limit": {
"default": 20,
"description": "Rows per page.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"market_type": {
"description": "Window length. One of 5m, 15m, 1hr, 4hr, 24hr.",
"enum": [
"5m",
"15m",
"1hr",
"4hr",
"24hr"
],
"type": "string"
},
"offset": {
"default": 0,
"description": "Rows to skip. Pass next_offset from the previous page.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"start_time": {
"description": "ISO 8601. Keeps markets that start at or after this time. No zone means UTC.",
"type": "string"
}
},
"required": [
"market_type"
],
"type": "object"
},
"name": "polytest_list_markets",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"count": {
"description": "Rows in this result.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"markets": {
"items": {
"additionalProperties": false,
"properties": {
"coin": {
"type": "string"
},
"end_time": {
"type": "string"
},
"final_volume": {
"type": [
"number",
"null"
]
},
"market_id": {
"type": "string"
},
"market_type": {
"type": "string"
},
"price_end": {
"description": "Coin spot price when the window closed. Null until it is recorded.",
"type": [
"number",
"null"
]
},
"price_start": {
"description": "Coin spot price when the window opened.",
"type": [
"number",
"null"
]
},
"resolved_at": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"start_time": {
"type": "string"
},
"status": {
"description": "upcoming: not started. open: the window is still running. resolved: the winner is known. ended_no_result: the window closed and PolyTest has no result for it.",
"enum": [
"upcoming",
"open",
"resolved",
"ended_no_result"
],
"type": "string"
},
"winner": {
"description": "Winning side once the market resolves. A tie resolves Up.",
"type": [
"string",
"null"
]
}
},
"required": [
"market_id",
"slug",
"market_type",
"coin",
"start_time",
"end_time",
"price_start",
"price_end",
"winner",
"final_volume",
"resolved_at",
"status"
],
"type": "object"
},
"type": "array"
},
"next_offset": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Offset of the next page when stop is more."
},
"note": {
"type": "string"
},
"stop": {
"enum": [
"more",
"end",
"tier_window"
],
"type": "string"
},
"truncated": {
"description": "True when rows were cut to keep the result small.",
"type": "boolean"
}
},
"required": [
"markets",
"count",
"stop",
"next_offset",
"truncated"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:c623416979faa1f5b1dd962401a3135472b1355e1ffd3c6c853127b7b9860519 | sha256sum