# Pascal API Docs

> Public API documentation for Pascal's REST and WebSocket APIs.

This index and the linked Markdown files are generated from the public docs at https://docs.pascal.trade.

Use General for exchange concepts, API for endpoints and schemas, and Request Signing only when implementing or verifying signatures.

## App Market Links

Pascal app market pages are JavaScript-rendered. When reading an app URL like `https://app.pascal.trade/trade/{eventId}?marketSymbol={symbol}`, use the `marketSymbol` query parameter as the Pascal market symbol.

- Live market metadata, current `mark_price`, and `rules_url` with GET-only access: fetch `https://data.pascal.trade/api/v1/markets` and filter the response `data` array for `symbol == "MARKET_SYMBOL"`.
- Exact market lookup, including resolved markets: POST `{"symbols":["MARKET_SYMBOL"],"events":[],"games":[]}` to `https://data.pascal.trade/api/v1/markets/search`.
- Order book and current bid/ask levels: GET `https://data.pascal.trade/api/v1/books?symbols=MARKET_SYMBOL`.
- Rules text: fetch the `rules_url` returned by the market search response.

## Docs

- [General](llms/general.txt): Quickstart, exchange overview, trading mechanics, collateral, matching, and tick sizes.
- [API](llms/api.txt): Base URLs, authentication, REST endpoints, WebSocket messages, reference types, and errors.
- [Request Signing](llms/request-signing.txt): Permit headers, signed request payloads, and signing test vectors.

## Examples And Signing

- [Python quickstart](https://github.com/Pascal-Research-Inc/pascal-python-quickstart#quickstart): Best place to look for executable examples of trading with Pascal's API.
- [Request signing test vectors](llms/request-signing.txt): Use these when writing your own signing code and compare your payloads and signatures against the generated examples.

## Optional

- [Full docs](llms-full.txt): Complete generated Markdown reference. Use this only when you need the whole public API docs corpus in one file.