# Foresight Hub

## Docs

- [Create an API key](https://docs.foresight.now/api-reference/auth/create-an-api-key.md): Create a new API key for the authenticated user. **L1 — Privy JWT only** (you cannot create keys with a key). The `secret` is returned only once.
- [Issue a WebSocket token](https://docs.foresight.now/api-reference/auth/issue-a-websocket-token.md): Issue a single-use, 60-second token used to authenticate the private `user` WebSocket channel. **L2 — JWT or API key.**
- [List API keys](https://docs.foresight.now/api-reference/auth/list-api-keys.md): List non-revoked API keys for the authenticated user. **L1 — Privy JWT only.** Secrets are never returned.
- [Revoke an API key](https://docs.foresight.now/api-reference/auth/revoke-an-api-key.md): Soft-revoke a key (sets `revokedAt`; the key stops working immediately). **L1 — Privy JWT only.**
- [Rotate an API-key secret](https://docs.foresight.now/api-reference/auth/rotate-an-api-key-secret.md): Issue a new secret for an existing key. The old secret stops working immediately. **L1 — Privy JWT only.**
- [List fills](https://docs.foresight.now/api-reference/fills/list-fills.md): List the authenticated wallet's fills (maker or taker side). **L2, permission `read`.**
- [Get a market](https://docs.foresight.now/api-reference/market-data/get-a-market.md): Single-market detail by `condition_id`. Accepts any status. **L0 — public.**
- [Get market tokens](https://docs.foresight.now/api-reference/market-data/get-market-tokens.md): ERC-1155 token ids and collateral `decimals` for this market. **L0 — public.**
- [Get orderbook snapshot](https://docs.foresight.now/api-reference/market-data/get-orderbook-snapshot.md): Aggregated orderbook snapshot. **L0 — public.**
- [Get public trades](https://docs.foresight.now/api-reference/market-data/get-public-trades.md): Public settled trade prints (no maker/taker direction). **L0 — public.** Paginated.
- [Get ticker](https://docs.foresight.now/api-reference/market-data/get-ticker.md): Best bid/ask, last price, and spread. **L0 — public.**
- [List markets](https://docs.foresight.now/api-reference/market-data/list-markets.md): List CLOB markets on a chain. **L0 — public.** Paginated.
- [Cancel orders](https://docs.foresight.now/api-reference/orders/cancel-orders.md): Cancel orders by hash, by filter, or all. **L2, permission `trade`.**
- [Get an order](https://docs.foresight.now/api-reference/orders/get-an-order.md): Get a single order by hash, scoped to the authenticated wallet. **L2, permission `read`.**
- [Get on-chain cancel calldata](https://docs.foresight.now/api-reference/orders/get-on-chain-cancel-calldata.md): Return unsigned calldata to cancel an order directly against the CTF Exchange. The backend does **not** submit this transaction — you sign and send it yourself. **L2, permission `trade`.**
- [List orders](https://docs.foresight.now/api-reference/orders/list-orders.md): List the authenticated wallet's orders. **L2, permission `read`.**
- [Place orders](https://docs.foresight.now/api-reference/orders/place-orders.md): Batch-place up to **15** signed EIP-712 orders. **L2, permission `trade`.**
- [List positions](https://docs.foresight.now/api-reference/positions/list-positions.md): List the authenticated wallet's CLOB positions. **L2, permission `read`.**
- [Authentication](https://docs.foresight.now/foresight-apis/clob/authentication.md): How to authenticate against the CLOB Trading API: the three auth tiers, API-key lifecycle, permissions, and short-lived WebSocket tokens.
- [Errors](https://docs.foresight.now/foresight-apis/clob/errors.md): The CLOB API error envelope, the full error-code table with HTTP mappings, inline vs HTTP errors, idempotency, batch caps, and pagination.
- [CLOB Trading API](https://docs.foresight.now/foresight-apis/clob/introduction.md): Programmatic order-book trading on Foresight: signed limit and market orders, real-time market data, and a private WebSocket feed. This is a separate API from the legacy AMM Trade API.
- [Signing orders](https://docs.foresight.now/foresight-apis/clob/signing-orders.md): Build and sign EIP-712 orders for the CLOB: the typed-data domain, the Order struct, the integer-tick maker/taker amount math, and a complete worked example.
- [WebSocket](https://docs.foresight.now/foresight-apis/clob/websocket.md): Realtime CLOB feed: connect to /v1/ws, subscribe to public book/ticker/trades channels and the private user channel, and apply order-book deltas correctly.
- [Foresight API Documentation](https://docs.foresight.now/foresight-apis/foresight-api-documentation.md)
- [Foresight API Swagger](https://docs.foresight.now/foresight-apis/foresight-api-swagger.md): This section provides developers with interactive API documentation to explore and test Foresight’s endpoints. It is intended for building integrations, automating workflows, and accessing platform data programmatically.
- [Brand Assets](https://docs.foresight.now/foresight-brand-assets/downloadables.md)
- [FAQs](https://docs.foresight.now/guides/arena-markets/arena-faqs.md)
- [Arena Market Creation](https://docs.foresight.now/guides/arena-markets/arena-market-creation.md): Allows anyone to create and participate in user-generated prediction markets. Instead of waiting for official listings, users can propose verifiable events, seed liquidity with conviction, and earn rewards from market activity.
- [Arena Seeding](https://docs.foresight.now/guides/arena-markets/arena-seeding.md): This is where you confirm your position, review all key information about the market, and stake your funds to help it reach the seeding goal.
- [Deposit via Fiat](https://docs.foresight.now/guides/deposits-and-withdrawals/deposit-via-card-1.md): Purchase supported stablecoins using your local currency via card payments. Funds are processed through a third-party on-ramp provider and credited to your Foresight account.
- [Deposit via Crypto](https://docs.foresight.now/guides/deposits-and-withdrawals/deposit-via-wallet.md): Fund your Foresight account by sending supported tokens directly from your wallet using a deposit address or QR code.
- [Withdrawals](https://docs.foresight.now/guides/deposits-and-withdrawals/withdrawals.md): Withdrawals allow you to move your available balance from Foresight back to your external wallet. All withdrawals are executed on-chain and processed on the network and stablecoin associated with your selected chain (e.g., Katana, Base, or Citrea).
- [How to Add Funds](https://docs.foresight.now/guides/getting-started/how-to-add-funds.md): Before placing a prediction on Foresight, you need to fund your wallet with supported stablecoins on a supported network.  This section explains how to fund your wallet, choose the appropriate network, and safely move assets into the platform.
- [How to Sign-Up](https://docs.foresight.now/guides/getting-started/how-to-sign-up.md): You can create a Foresight account using either an email login or a crypto wallet. Choose the option that best fits your workflow and security preferences.
- [Introduction to Foresight](https://docs.foresight.now/guides/getting-started/introduction-to-foresight.md): Foresight is a social prediction market where users trade on real-world outcomes using community-driven insights and enables information discovery. Share your conviction, influence how markets move, and earn when others act on your conviction, all backed by transparent on-chain execution. Incentives…
- [Making Your First Prediction](https://docs.foresight.now/guides/getting-started/making-your-first-prediction.md): Once you've Signed-up and Added Funds, you can place your first prediction in just a few steps.
- [Market Creation](https://docs.foresight.now/guides/platform-markets/market-creation.md)
- [Market Resolutions and Payouts](https://docs.foresight.now/guides/platform-markets/market-resolutions-and-payouts-1.md)
- [Market Rules and Clarification](https://docs.foresight.now/guides/platform-markets/market-rules-and-clarification-1.md)
- [Market States](https://docs.foresight.now/guides/platform-markets/market-states-1.md): Each market on Foresight moves through different states during its lifecycle. These states determine whether you can trade, when prices update, and when payouts become available.
- [Market Types](https://docs.foresight.now/guides/platform-markets/market-types.md): Foresight supports two primary market types: Single markets and Multi markets. Each type defines how outcomes are structured and how resolution timelines behave.
- [Pricing and Probability](https://docs.foresight.now/guides/platform-markets/pricing-and-probability.md)
- [KAT Market Incentives ](https://docs.foresight.now/guides/rewards/kat-market-incentives.md)
- [Vision Points](https://docs.foresight.now/guides/rewards/vision-points-1.md): A rewards system that incentivizes active trading, market creation, and meaningful participation on Foresight. Earn points by trading, seeding markets, and contributing to the ecosystem.
- [FAQs](https://docs.foresight.now/guides/rewards/vision-points-faqs.md)

## OpenAPI Specs

- [openapi-clob-v1](https://docs.foresight.now/api-reference/openapi-clob-v1.yaml)
- [openapi](https://docs.foresight.now/api-reference/openapi.json)