---
title: "Get the caller's Predict.fun account profile"
method: GET
path: "/exchanges/predictfun/account"
tags: ["Onboarding"]
---

# Get the caller's Predict.fun account profile

`GET /exchanges/predictfun/account`

## Request

- Base URL: `https://execution.kairos.trade`
- URL: `https://execution.kairos.trade/exchanges/predictfun/account`
- Auth: API key in header `X-Client-Id` and API key in header `X-Api-Key` and API key in header `X-Api-Secret`

Authenticates against Predict.fun with the caller's wallet and returns the `data` block of their `GET /v1/account` — display name, address, referral state and points. The upstream shape is forwarded verbatim, so new upstream fields appear without a Kairos change; treat the response as open.
> **Error shape.** Minimal `{"error": "...", "code": "..."}` (`OrderSimpleErrorResponse`).
**Auth.** API keys and delegations need `trade:execute` (a cold venue session is minted by signing a login challenge with the user's wallet) and the `predictfun` platform access flag.

## Response `200`

The caller's Predict.fun profile.

- OrderPredictfunAccountResponse: Response for `GET /exchanges/predictfun/account` — the `data` block of Predict.fun's own `GET /v1/account`, forwarded verbatim. Upstream may add fields.
  - `name` string, required
  - `address` string, required
  - `image_url` string, nullable
  - `referral` OrderPredictfunAccountReferral, required
    - `code` string, nullable
    - `status` string, required: `LOCKED` or `UNLOCKED` per Predict.fun's spec. Kept as an open string so a new upstream state does not break deserialization — do not treat it as a closed enum.
  - `points` OrderPredictfunAccountPoints, required
    - `total` number, double, required

## Other responses

- `401`: No valid credential presented — missing/invalid API-key headers or an invalid/expired session token.
- `404`: `NO_CREDENTIALS` — "No Predict.fun wallet found for this user".
- `500`: `INTERNAL_ERROR` — the registered executor or credential set has an unexpected type.
- `503`: `NOT_CONFIGURED` — Predict.fun (or its credential provider) is not configured on this deployment.

---

[API](https://skmtc.dev/kairos/apis/kairos-order-execution-api.md) - [All operations](https://skmtc.dev/kairos/apis/kairos-order-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kairos/apis/kairos-order-execution-api/revisions/9ba7d463d505?raw)