Value one public address across every hosted account venue in one call.
const url = 'https://data.predictefy.com/v1/portfolio?address=example';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://data.predictefy.com/v1/portfolio?address=example' \ --header 'Authorization: Bearer <token>'Fans out only to registry venues with a served public balance or position lane. The optional venues query is a comma-separated subset of that live registry-derived set. Balance and position envelopes fail independently per venue, so one upstream outage never blanks another venue. Position marks resolve (venue, marketId) against one hot-catalog snapshot: outcomes[].price is authoritative, yes_price/no_price are the binary fast path, and last_price is used only for outcome-less long/short instruments. Unresolvable markets, missing prices, and missing sizes return mark=null with markReason; totals sum only real marks and remain null when none exist. Venues with served public fills get average-cost unrealized PnL from the bounded fetched window, always labeled basis=fills_window and complete=false. No realized PnL is manufactured. Dark unless READS_ENABLE_PORTFOLIO=true.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Optional comma-separated subset of portfolio-capable registry venues.
Responses
Section titled “Responses”A bounded cross-venue portfolio snapshot with honest partial availability.
object
object
object
object
object
Exact when the first adapter page proves the complete count; otherwise null.
object
object
Exact when the first adapter page proves the complete count; otherwise null.
object
object
object
Example
{ "data": { "venues": { "additionalProperty": { "balances": { "availability": "available", "provenance": { "source": "venue_api", "visibility": "public" }, "data": [ { "kind": "cash" } ] }, "positions": { "availability": "available", "provenance": { "source": "venue_api", "visibility": "public" }, "data": [ { "side": "long", "status": "open", "mark": { "source": "hot_catalog" }, "markReason": "catalog_unavailable", "pnl": { "basis": "fills_window", "complete": false } } ] } } } }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}