> ## Documentation Index > Fetch the complete documentation index at: https://docs.testnet.dev.adipredictstreet.com/llms.txt > Use this file to discover all available pages before exploring further. # Get contract addresses > Contract addresses and chain settings for the environment this API serves: the chain id and a public RPC URL, the two exchanges you sign orders against (`ctfExchange` for binary markets, `ctfExchangeNegRisk` for neg-risk markets), the USDC collateral token and its EIP-712 permit domain, the vault factory, the outcome-token contract, both oracles, and the executor you name as `spender` in a gasless-deposit permit. The values come from the live deployment's configuration, so read them at startup instead of hardcoding addresses. See [Environments](/environments) for a sample response and [Addresses](/concepts/contracts/addresses) for the per-environment table. Public, no authentication. Rate limit: 60 requests per minute per IP, on top of the 600 per minute per IP that `notices`, `status`, `contracts` and `fee-config` share. Cacheable for 30 seconds. ## OpenAPI ````yaml /api-reference/openapi.json get /api/platform/contracts openapi: 3.1.0 info: title: PredictStreet API description: >- Client-facing HTTP API for the PredictStreet prediction-market platform. **Partner kinds.** Every authenticated endpoint resolves a request's *effective wallet* from the partner row. `single_wallet` partners bind to one `associatedWallet` set at creation. `multi_wallet` partners declare the actor on every request via an `X-User-Wallet: 0x<40-hex>` header. See the [Partner kinds](/auth/api-keys#partner-kinds) doc for the full contract. version: '2026-06-16' contact: name: PredictStreet partners email: partners@predictstreet.com servers: - url: https://core.api.dev.predictstreet.sde.adifoundation.ai description: Testnet (partner integrator API — final domain TBD) security: [] tags: - name: Deposits description: >- Gasless USDC deposit relay - submit a signed EIP-2612 permit and the platform broadcasts the on-chain deposit for you (no gas). - name: Events description: >- Polymarket-style event grouping with football metadata (group, stage, teams, tags). - name: Tags description: Curated tag taxonomy used to filter events. - name: Markets description: 'Public market data: list, detail, orderbook, trades, OHLC.' - name: Crypto description: >- Crypto price markets: the underlying-asset price curve and Up/Down series navigation. The markets themselves are ordinary binary markets — list them through /api/markets and /api/events. - name: Orders description: >- Signed-order place / cancel / read. Requires `X-Api-Key` with `orders:read` / `orders:write` scope; every write additionally requires an EIP-712 signature over the order. - name: Portfolio description: >- Balances, positions, trades, fees, vault info for the key's `associatedWallet`. Requires `X-Api-Key` with `portfolio:read` scope. - name: Matches description: >- A match groups several events into one fixture/card (1X2 + first-scorer + over-under under one matchup). - name: Vault description: >- Backend co-signatures for ERC-1155 split / merge, and recovery for off-chain locks when the corresponding chain tx never confirmed. Requires `X-Api-Key` with `vault:write` scope plus an EIP-712 signature over the operation. - name: Leaderboard description: Public ranked leaderboard across PnL / volume buckets. - name: Search description: Global search across users, events, and matches. - name: Withdrawal Security description: >- Self-service withdrawal 2FA (TOTP) and withdrawal-address whitelist. Same endpoints serve the web app (user sessions) and API-key integrators. Mutations need `vault:write`, reads `portfolio:read`. Both are opt-in per wallet and only gate withdrawals once the platform enables withdrawal-security enforcement. - name: Platform description: >- Public platform state: the contract registry, the platform fee configuration, the platform freeze flag and active notices. No authentication. paths: /api/platform/contracts: get: tags: - Platform summary: Get contract addresses description: >- Contract addresses and chain settings for the environment this API serves: the chain id and a public RPC URL, the two exchanges you sign orders against (`ctfExchange` for binary markets, `ctfExchangeNegRisk` for neg-risk markets), the USDC collateral token and its EIP-712 permit domain, the vault factory, the outcome-token contract, both oracles, and the executor you name as `spender` in a gasless-deposit permit. The values come from the live deployment's configuration, so read them at startup instead of hardcoding addresses. See [Environments](/environments) for a sample response and [Addresses](/concepts/contracts/addresses) for the per-environment table. Public, no authentication. Rate limit: 60 requests per minute per IP, on top of the 600 per minute per IP that `notices`, `status`, `contracts` and `fee-config` share. Cacheable for 30 seconds. operationId: PlatformController_contracts parameters: [] responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PlatformContractsDto' '404': description: >- `contract_address_unconfigured` — the environment is missing a required contract address or its chain id. No partial registry is returned. Not expected on a healthy deployment; retry later. content: application/json: schema: $ref: '#/components/schemas/Error' '429': $ref: '#/components/responses/RateLimited' security: - {} components: schemas: PlatformContractsDto: type: object description: >- Contract addresses and chain settings for this environment. Every address is a 0x-prefixed 20-byte hex string. properties: chainId: type: integer description: >- EVM chain id of the network the contracts are deployed on — `99999` on the ADI testnet. example: 99999 rpcUrl: type: string description: Public JSON-RPC URL for read-only on-chain calls. example: https://rpc.ab.testnet.adifoundation.ai/ vaultFactory: type: string description: >- VaultFactory — `vaultOf(wallet)` returns a wallet's vault address. The platform calls `deployVault` for you. usdc: type: string description: >- USDC collateral token (ERC-20). On testnet this is mUSDC, which exposes a public `mint(address,uint256)`. wrappedCollateral: type: string nullable: true description: >- Optional WrappedCollateral helper. `null` when the environment has none, as on the current testnet. ctfExchange: type: string description: >- Exchange for binary markets — the `verifyingContract` of the EIP-712 domain you sign binary-market orders against. ctfExchangeNegRisk: type: string description: >- Exchange for neg-risk markets — the `verifyingContract` for neg-risk orders. Not the same address as `ctfExchange`. negRiskAdapter: type: string description: >- NegRiskAdapter — multi-outcome (neg-risk) support on top of ConditionalTokens. See [NegRiskAdapter](/concepts/contracts/neg-risk-adapter). conditionalTokens: type: string description: ConditionalTokens — the ERC-1155 contract that holds outcome tokens. depositLimitRegistry: type: string description: >- DepositLimitRegistry address as configured for this environment. It can be the same address as `depositLimitRegistryProxy`, as on the current testnet; send your calls to `depositLimitRegistryProxy`. depositLimitRegistryProxy: type: string description: >- DepositLimitRegistry transparent proxy — the address to call from clients. oracle: type: string description: >- Oracle for binary markets. Disputes on a binary market are filed here with `challengeOutcome(conditionId)`. negRiskOracle: type: string nullable: true description: >- Oracle for neg-risk markets. Disputes on a neg-risk group are filed here with `challengeOutcome(negRiskMarketId)`, not on `oracle`. `null` when the environment has no neg-risk oracle. multicallExecutor: type: string description: >- Executor contract for gasless deposits. Name it as the `spender` of the USDC EIP-2612 `Permit` you sign for `POST /api/deposits/relay` — not the account that pays the gas. The relay rebuilds the permit with this spender, so a permit signed for any other spender is refused as `permit_signer_mismatch`. usdcEip712: type: object description: >- `name` and `version` of the USDC contract's EIP-712 domain. Use exactly these values when you build the `Permit` for a gasless deposit; any other values recover a different signer and the relay answers `permit_signer_mismatch`. properties: name: type: string example: USD Coin version: type: string example: '2' required: - name - version ccipBridge: type: object nullable: true description: >- Cross-chain withdrawal bridge (Chainlink CCIP). `null` when the environment has no bridge configured — cross-chain withdrawals are then unavailable. properties: destChainSelector: type: string description: >- CCIP chain selector of the Ethereum destination lane, as a decimal uint64 string. Sign it into the bridge authorization and send it as `bridge.destChainSelector` on `POST /api/withdrawals/request`. required: - destChainSelector generatedAt: type: string format: date-time description: >- ISO-8601 — when this response was generated. Not a deploy timestamp: compare the addresses between reads to detect a redeploy. required: - chainId - rpcUrl - vaultFactory - usdc - wrappedCollateral - ctfExchange - ctfExchangeNegRisk - negRiskAdapter - conditionalTokens - depositLimitRegistry - depositLimitRegistryProxy - oracle - negRiskOracle - multicallExecutor - usdcEip712 - ccipBridge - generatedAt Error: type: object description: >- Error body returned by every API error (same shape as `ErrorEnvelope`). Branch on `error.code`, not on `message`. required: - status - error properties: status: type: integer description: HTTP status, repeated in the body. example: 404 error: type: object required: - code - message properties: code: type: string description: >- Machine-readable code (e.g. `market_not_found`, `event_not_found`, `invalid_limit`). message: type: string trace_id: type: string description: Request trace id; quote it to support. May be absent. retryAfterSec: type: integer description: >- Seconds to wait before retrying, when the server says so (also sent as the `Retry-After` header). retryable: type: boolean description: >- Whether the same request may be sent again as it is. Absent when the server does not say. details: type: object additionalProperties: true description: >- Extra structured context thrown with the error, e.g. `slug`, `allowed`, `auditId`. responses: RateLimited: description: >- Rate limit exceeded. `Retry-After` and `X-RateLimit-Reset` headers are set. headers: Retry-After: schema: type: integer X-RateLimit-Limit: schema: type: integer X-RateLimit-Remaining: schema: type: integer X-RateLimit-Reset: schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.