> ## Documentation Index
> Fetch the complete documentation index at: https://dexbuilder.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# API conventions

> Base URL, route prefixes, authentication scope, and shared request conventions for DexBuilder APIs.

This page describes the shared conventions for the DexBuilder Platform, Prediction Markets, and Event Contracts APIs. Follow each endpoint page for its exact parameters and response model.

## Base URL and routes

Production Base URL:

```text theme={null}
https://api.dexbuilder.com
```

| API | Path prefix | Authentication |
| - | - | - |
| DexBuilder Platform | /api/v4/dexbuilder/... | Broker API Key; user-level endpoints also require X-User-Wallet-Address |
| Prediction Markets public data | /api/v4/prediction/... | No Broker API Key |
| Prediction Markets private | /api/v4/broker/prediction/... | Broker API Key and X-User-Wallet-Address |
| Event Contracts public data | /api/v4/event\_contracts/... | No Broker API Key |
| Event Contracts private | /api/v4/broker/event\_contracts/... | Broker API Key and X-User-Wallet-Address |

DexBuilder asset-configuration queries require a Broker API Key but no user wallet. See [Access on behalf of a user](https://dexbuilder.mintlify.site/en/api-reference/common/sub-user-wallet.md).

> [!NOTE]
>
> PerpDEX does not currently support Broker API. Its API Key and authentication rules are separate.

## Request conventions

* Sign private REST requests using the method, external path, query string, body, and Timestamp you actually send. See [Broker API Key and signing](https://dexbuilder.mintlify.site/en/api-reference/common/broker-authentication.md).
* Timestamp is a Unix timestamp in seconds. Business-field time units vary; use the field description on each endpoint.
* Keep query parameter order and body bytes unchanged after signing.
* Follow each endpoint's pagination and response model. Use decimal arithmetic for monetary values where precision matters.

## Responses and errors

Response and error shapes differ by product. Check the HTTP status and the product-specific response body. If a submission times out or its result is uncertain, query its status before deciding whether to retry. Supply Idempotency-Key where the endpoint requires it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.