# Corvus  API

## API Docs
- Token [Get Token](https://docs.ourcorvus.com/459947767e0.md): Get token,
- User > Wallet [Query user ledger balance](https://docs.ourcorvus.com/459744726e0.md): Returns the available balance, frozen balance, total balance, and currently available deposit address of the current logged-in user from the system ledger. The balance comes from the internal system ledger rather than a real-time snapshot of an on-chain subaccount. User identity is resolved from the login session, so userId is not required.
- Position [My positions with pagination](https://docs.ourcorvus.com/459744727e0.md): Returns paginated prediction positions for the current logged-in user. Results can be filtered by position status. When hideZeroShares=true, positions with 0 remaining shares are hidden.
- Market Data [Get match team information](https://docs.ourcorvus.com/459744728e0.md): Pass one or more match titles and a league identifier via query parameters and return the team details for each title. When titles are long or numerous, the POST version is recommended to avoid an overly long URL that could cause HTTP 414.
- Market Data [Get match team information in batch](https://docs.ourcorvus.com/459744729e0.md): Uses the request body to carry the match title list and league identifier. Suitable for long titles or batch query scenarios.
- Market Data [Get market price history](https://docs.ourcorvus.com/459744730e0.md): Gets price trend data by Polymarket CLOB token ID. The returned percentValue is suitable for the Y-axis of frontend trend charts, while originalPrice preserves the raw 0-1 price.
- Market Data [Get order books in batch](https://docs.ourcorvus.com/459744731e0.md): Queries Polymarket CLOB order books in batch. The request body is an array of token query items. The server calls the upstream CLOB API item by item and returns results in the same order. The controller requires a non-empty array, and the recommended business limit is no more than 10 tokens per request.
- Market Data [Get topic market groups](https://docs.ourcorvus.com/459744732e0.md): Gets market group metadata under the specified topic for sidebar, filter, or topic page group display. Example: /api/market/politics/iran/groups.
- Market Data [Get topic event list](https://docs.ourcorvus.com/459744733e0.md): Gets the event list under the specified topic. limit defaults to 20, and the server constrains valid values to 1 through 300.
- Market Data [Get historical events in the same topic series](https://docs.ourcorvus.com/459744734e0.md): Gets the historical event list in the same series by the current event id/slug or any market id/slug under the event. limit defaults to 20, and the server constrains valid values to 1 through 100.
- Market Data [Get topic event details](https://docs.ourcorvus.com/459744735e0.md): Gets a single topic event detail by event id, event slug, or any market id/slug under the event.
- Order [My orders with pagination](https://docs.ourcorvus.com/459744736e0.md): Returns paginated prediction order records for the current logged-in user.
- Order [Create prediction buy order](https://docs.ourcorvus.com/459744737e0.md): Creates a prediction order after the user confirms a purchase. The endpoint performs parameter validation, fee calculation, ledger deduction, order persistence, and advances the order status according to actual Polymarket results. It requires prediction:order:create permission and is protected against duplicate submission.
- Order [Create prediction sell order](https://docs.ourcorvus.com/459744738e0.md): Freezes the current user's position shares and submits a SELL order to Polymarket. If the external trade succeeds, the order enters the subsequent review and crediting flow. It requires prediction:order:create permission and is protected against duplicate submission.

## Schemas
- [ErrorResponse](https://docs.ourcorvus.com/275335804d0.md): 
- [WalletBalanceResponse](https://docs.ourcorvus.com/275335805d0.md): 
- [WalletAccountBalanceVo](https://docs.ourcorvus.com/275335806d0.md): 
- [DepositAddressVo](https://docs.ourcorvus.com/275335807d0.md): 
- [PositionListResponse](https://docs.ourcorvus.com/275335808d0.md): 
- [PositionVo](https://docs.ourcorvus.com/275335809d0.md): 
- [TeamsQueryBo](https://docs.ourcorvus.com/275335810d0.md): 
- [TeamsResponse](https://docs.ourcorvus.com/275335811d0.md): 
- [MatchTeamsVo](https://docs.ourcorvus.com/275335812d0.md): 
- [PriceHistoryResponse](https://docs.ourcorvus.com/275335813d0.md): 
- [PriceHistoryPointVo](https://docs.ourcorvus.com/275335814d0.md): 
- [OrderBookQueryBo](https://docs.ourcorvus.com/275335815d0.md): 
- [OrderBooksResponse](https://docs.ourcorvus.com/275335816d0.md): 
- [OrderBookVo](https://docs.ourcorvus.com/275335817d0.md): 
- [OrderBookEntry](https://docs.ourcorvus.com/275335818d0.md): 
- [TopicGroupsResponse](https://docs.ourcorvus.com/275335819d0.md): 
- [TopicMarketGroupVo](https://docs.ourcorvus.com/275335820d0.md): 
- [MarketEventsResponse](https://docs.ourcorvus.com/275335821d0.md): 
- [MarketDetailResponse](https://docs.ourcorvus.com/275335822d0.md): 
- [MarketItemVo](https://docs.ourcorvus.com/275335823d0.md): 
- [EventMarketVo](https://docs.ourcorvus.com/275335824d0.md): 
- [OrderListResponse](https://docs.ourcorvus.com/275335825d0.md): 
- [PredictionOrderListVo](https://docs.ourcorvus.com/275335826d0.md): 
- [PredictionOrderCreateBo](https://docs.ourcorvus.com/275335827d0.md): 
- [PredictionSellOrderCreateBo](https://docs.ourcorvus.com/275335828d0.md): 
- [PredictionOrderResponse](https://docs.ourcorvus.com/275335829d0.md): 
- [PredictionOrderVo](https://docs.ourcorvus.com/275335830d0.md):