> ## 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. # Global search preview — top results across users and events > Returns up to 5 hits per type for the header dropdown. If the query starts with `0x` we look up users by wallet (exact at length 42, prefix otherwise) and `events` is empty. Otherwise two independent text searches run in parallel; events also surface tag-driven hits via `matchedVia: 'tag'`. Minimum query length is 1 character. A market maker's wallet is never a user hit. ## OpenAPI ````yaml /api-reference/openapi.json get /api/search openapi: 3.1.0 info: title: PredictStreet API description: >- Client-facing HTTP API for the PredictStreet prediction-market platform. **Partner kinds.** Every authenticated endpoint except the partner-level platform reads (`/api/platform/status`, `/notices`, `/maintenance`) 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: >- Platform reference data and state. The contract registry and the fee configuration are public and need no key. The freeze flag (`/status`), active notices (`/notices`) and maintenance windows (`/maintenance`) need a partner API key in `X-Api-Key`. paths: /api/search: get: tags: - Search summary: Global search preview — top results across users and events description: >- Returns up to 5 hits per type for the header dropdown. If the query starts with `0x` we look up users by wallet (exact at length 42, prefix otherwise) and `events` is empty. Otherwise two independent text searches run in parallel; events also surface tag-driven hits via `matchedVia: 'tag'`. Minimum query length is 1 character. A market maker's wallet is never a user hit. operationId: SearchController_preview parameters: - name: q in: query required: true schema: type: string minLength: 1 maxLength: 64 description: Search query, 1–64 characters. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SearchPreviewRespDto' '400': description: Missing or out-of-bound `q`. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' security: - {} components: schemas: SearchPreviewRespDto: type: object required: - query - walletMode - users - events - usersHasMore - eventsHasMore properties: query: type: string description: Trimmed query string actually used. walletMode: type: boolean description: >- True when the query parsed as a `0x…` wallet prefix. In that case `events` is always empty. users: type: array items: $ref: '#/components/schemas/SearchUser' events: type: array items: $ref: '#/components/schemas/SearchEvent' usersHasMore: type: boolean description: >- True when there is at least one more row past the preview slice for this type — drives the "View more" footer in the dropdown without a follow-up round-trip. eventsHasMore: type: boolean ErrorEnvelope: type: object description: >- Error body returned by every API error (same shape as `Error`). Branch on `error.code`, not on `message`. required: - status - error properties: status: type: integer description: HTTP status, repeated in the body. example: 400 error: type: object required: - code - message properties: code: type: string description: Machine-readable code. example: bad_request 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. SearchUser: type: object required: - walletAddress - vaultAddress - username - avatarUrl properties: walletAddress: type: string description: Wallet (EOA) address, EIP-55 checksummed — the public identity. vaultAddress: type: string description: The user's vault address. username: type: string nullable: true avatarUrl: type: string nullable: true description: >- The profile photo (512x512 WebP), only once it passed moderation; null shows a generated avatar. SearchEvent: type: object required: - id - slug - title - teamA - teamB - matchedVia properties: id: type: string slug: type: string title: type: string teamA: nullable: true description: Home team; null when unknown. allOf: - $ref: '#/components/schemas/TeamRefDto' teamB: nullable: true description: Away team; null when unknown. allOf: - $ref: '#/components/schemas/TeamRefDto' matchedVia: type: string enum: - title - team - tag description: >- Which field caused the hit. `tag` means the event was found via one of its active tags rather than a direct title/team match. TeamRefDto: type: object properties: code: type: string description: FIFA 3-letter code (e.g. "BRA"). label: type: string description: >- Display name (e.g. "Brazil"). Falls back to the code when the code has no name mapping. logo: type: string nullable: true description: >- Club crest URL, or null. Null is normal for a national team: render the crest when present and fall back to a flag drawn from `code` only when it is null. required: - code - label - logo ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.