Skip to main content
GET
/
v1
/
markets
/
{condition_id}
Get a market
curl --request GET \
  --url https://api.foresight.now/v1/markets/{condition_id}
{
  "condition_id": "<string>",
  "chain_id": 56,
  "question": "Will BTC close above $100k on Dec 31?",
  "tokens": [
    {
      "token_id": "<string>",
      "decimals": 18
    }
  ],
  "fee_rate_bps": 100,
  "created_at": "2023-11-07T05:31:56Z",
  "summary": "<string>",
  "rules": "<string>",
  "collateral_token": "<string>",
  "ctf_exchange_address": "<string>",
  "conditional_tokens_address": "<string>",
  "end_date": "2023-11-07T05:31:56Z",
  "ticker": {
    "bestBid": 0.54,
    "bestAsk": 0.55,
    "lastPrice": 0.545,
    "spread": 0.01,
    "displayPriceYES": 0.55,
    "displayPriceNO": 0.45
  }
}

Headers

​
X-Language
enum<string>
default:en

Language for translated fields (summary, rules). Defaults to English.

Available options:
en,
cn

Path Parameters

​
condition_id
string
required

On-chain ConditionalTokens condition hash.

Example:

"0x9cded060be358b76678e598084cf258c7257771e473dbb461cad23417302d606"

Query Parameters

​
chain_id
integer
required

Blockchain network id. BSC mainnet is 56.

Example:

56

Response

OK

​
condition_id
string
required

On-chain ConditionalTokens condition hash.

​
chain_id
integer
required
Example:

56

​
question
string
required
Example:

"Will BTC close above $100k on Dec 31?"

​
status
enum<string>
required

Raw market status. Trading is only possible while OPEN.

Available options:
OPEN,
CLOSED,
RESOLVED,
PAUSED,
SEEDING
​
tokens
object[]
required
​
fee_rate_bps
integer
required

Advertised platform fee in basis points (100 = 1%).

Example:

100

​
created_at
string<date-time>
required
​
summary
string | null

Market-group description, translated per X-Language.

​
rules
string | null

Resolution rules, translated per X-Language.

​
collateral_token
string | null

Collateral ERC-20 address.

​
ctf_exchange_address
string | null

CTF Exchange contract — used as the EIP-712 verifyingContract when signing orders for this market.

​
conditional_tokens_address
string | null

ConditionalTokens (ERC-1155) contract address for this market's chain.

​
end_date
string<date-time> | null
​
ticker
object

Cached ticker snapshot as embedded in a market object. Numeric fields are JSON numbers (camelCase). null until the first order/trade populates the cache. Note: this differs from the standalone /ticker endpoint, which returns snake_case string fields.