Foresea Venue APIs API
The Venue APIs API from Foresea — 5 operation(s) for venue apis.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/foresea-ink:foresea-ink-venue-apis-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Foresea Intelligence Venue APIs API
description: '## Overview
The **Foresea Intelligence API** turns market questions, linked evidence, and
prediction-market prices into probabilistic forecasts that can sit behind
trading dashboards, alerting systems, and research workflows. It supports binary, multiple-choice, numeric, and date forecasts. Each response
includes a structured **rationale**, typed forecast fields, optional evidence
sources fetched from live news, and optional market-edge analysis when you pass
a market-implied probability. ---
## Quick start
```bash
curl -X POST https://foresea.ink/predict \
-H "Content-Type: application/json" \
-d ''{
"question": "Will the Fed cut rates before September 30, 2026?",
"question_type": "binary",
"market_platform": "Polymarket",
"market_probability": 0.54,
"variant": "variant0_neutral_baseline"
}''
```
---
## Question types
Use `question_type` when your client already knows the shape of the question. If omitted, the model will try to infer it. | Type | Response shape |
|---|---|
| `binary` | `predicted_answer` is `Yes`/`No`; `confidence` is 0–1 |
| `multiple_choice` | `options` contains per-option probabilities; `predicted_answer` is the top option |
| `numeric` | `range_forecast` contains `p10`, `p50`, `p90`, and optional `unit` |
| `date` | `range_forecast` contains date percentiles |
For multiple-choice forecasts, pass `options` when the answer set is known. ---
## Prediction-market context
Pass `market_probability` when you know the current market-implied probability
for the target outcome. For binary markets this defaults to the `Yes` side; set
`market_outcome` to compare against `No` or a named multiple-choice outcome. Foresea returns `market_analysis` with model probability, market probability,
percentage-point edge, and a stance (`model_above_market`, `model_below_market`,
`in_line`, or `not_comparable`). ---
## Trading execution
Foresea can preview and submit guarded orders for Kalshi and Polymarket:
| Endpoint | Purpose |
|---|---|
| `GET /trading/accounts` | Return configured/not-configured server-account status without exposing secrets |
| `POST /trading/accounts/check` | Validate caller-supplied own-account (BYO) credentials without storing them |
| `POST /trading/preview` | Normalize and validate an order without placing it |
| `POST /trading/orders` | Submit a live order after explicit confirmation |
Live trading is disabled unless `FORESEA_ENABLE_TRADING=true`. Every live order
requires a signed-in user session, `execute=true`, and the exact confirmation
phrase `PLACE REAL ORDER`. Market/IOC/FOK-style orders are separately blocked
unless `FORESEA_ALLOW_MARKET_ORDERS=true`. Exchange credentials come from a shared server account (environment variables /
Secret Manager mounts) or an authenticated user''s **encrypted account
connection**. The connection endpoint accepts a user''s credentials once, validates
them with a unique data-encryption key wrapped by Cloud KMS, and never returns
them to the browser. Inline `venue_credentials` are rejected on public preview
and order calls; encrypted own-account trading remains gated by
`FORESEA_ENABLE_BYO_TRADING=true` (independent of `FORESEA_ENABLE_TRADING`). `/agent/analyze` may return a directional recommendation, but it never places an
order. Use `/trading/preview` first, review the normalized order, then call
`/trading/orders` only when you intend to submit a real order. ---
## Prompt variants
The `variant` field controls how the LLM is prompted.'
contact:
name: Pareel Amre
url: https://foresea.ink/
email: pareel.amre@gmail.com
license:
name: MIT
url: https://opensource.org/licenses/MIT
version: 1.0.0
tags:
- name: Venue APIs
paths:
/market/venue/catalog:
get:
tags:
- Venue APIs
summary: Venue Catalog
operationId: venue_catalog_market_venue_catalog_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Venue Catalog Market Venue Catalog Get
/market/venue/{platform}/{operation}:
post:
tags:
- Venue APIs
summary: Public Venue Data
operationId: public_venue_data_market_venue__platform___operation__post
parameters:
- name: platform
in: path
required: true
schema:
type: string
title: Platform
- name: operation
in: path
required: true
schema:
type: string
title: Operation
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/VenueRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Public Venue Data Market Venue Platform Operation Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/trading/venue/catalog:
get:
tags:
- Venue APIs
summary: Account Venue Catalog
operationId: account_venue_catalog_trading_venue_catalog_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Account Venue Catalog Trading Venue Catalog Get
/trading/venue/{platform}/{operation}:
post:
tags:
- Venue APIs
summary: Account Venue Data
operationId: account_venue_data_trading_venue__platform___operation__post
parameters:
- name: platform
in: path
required: true
schema:
type: string
title: Platform
- name: operation
in: path
required: true
schema:
type: string
title: Operation
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/VenueRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Account Venue Data Trading Venue Platform Operation Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/trading/venue/{platform}/actions/{operation}:
post:
tags:
- Venue APIs
summary: Venue Action
operationId: venue_action_trading_venue__platform__actions__operation__post
parameters:
- name: platform
in: path
required: true
schema:
type: string
title: Platform
- name: operation
in: path
required: true
schema:
type: string
title: Operation
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/VenueActionRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Venue Action Trading Venue Platform Actions Operation Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
VenueActionRequest:
properties:
parameters:
additionalProperties: true
type: object
title: Parameters
body:
anyOf:
- additionalProperties: true
type: object
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
title: Body
execute:
type: boolean
title: Execute
default: false
confirmation:
type: string
title: Confirmation
default: ''
audit_order_id:
anyOf:
- type: string
- type: 'null'
title: Audit Order Id
additionalProperties: false
type: object
title: VenueActionRequest
VenueRequest:
properties:
parameters:
additionalProperties: true
type: object
title: Parameters
body:
anyOf:
- additionalProperties: true
type: object
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
title: Body
additionalProperties: false
type: object
title: VenueRequest
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError