Omen Developer Portal
Request accessSign inAPI Keys

API Reference

Wallets Proxy API

Detailed reference for endpoints, authentication, channels, messages, environment endpoints, and data models in this integration area.

OpenAPI referencev0.2.2Wallets

Omen Wallets Proxy API

Proxy for the Omen Wallets retail API. Authenticates users via JWT (omen-auth) and forwards requests to the internal omen-wallets service. Request and response bodies are passed through verbatim from omen-wallets. **Token amounts** are serialized as raw smallest-unit JSON strings. pUSD, USDC.e, and USDT0 use 6 decimals (e.g. `"1000000"` = 1.00 token).

Environment endpoints

Test environmenthttps://wallets-proxy.test.omen.tradeTest environment
Local developmenthttp://localhost:8080Local development

Authentication

BearerAuthhttpbearer

omen-auth access token (ES256). Claims must include sub, iss=omen-auth, aud=authenticated, pdt=defi.

ServiceSecretAuthapiKeyX-Service-Secret

Service-to-service shared secret. Required only for internal backend routes.

Endpoints

MethodPathSummaryTags
GET/internal/wallet/{user_id}Resolve wallet address for a user
Internal
GET/api/v1/retail/onboard/statusCheck onboarding progress
Retail Onboarding
GET/api/v1/retail/walletGet retail wallet info
Retail Account
GET/api/v1/retail/wallet/balanceGet pUSD balance
Retail Account
GET/api/v1/retail/credentialsGet Polymarket API credential metadata
Retail Account
POST/api/v1/retail/credentials/resetReset Polymarket credentials
Retail Account
GET/api/v1/retail/approvalsCheck token approval status
Retail Account
POST/api/v1/retail/wallet/registerRegister a self-provisioned Privy embedded wallet
Retail Onboarding
POST/api/v1/retail/safe/createSubmit a client-signed SAFE-CREATE deployment
Retail Onboarding
POST/api/v1/retail/safe/execute/preparePrepare a SAFE execute for client signing
Retail Onboarding
POST/api/v1/retail/safe/execute/submitSubmit a client-signed SAFE execute
Retail Onboarding
POST/api/v1/retail/deposit-wallet/createDeploy a Polymarket deposit wallet
Retail Onboarding
POST/api/v1/retail/deposit-wallet/execute/preparePrepare a deposit wallet batch for client signing
Retail Onboarding
POST/api/v1/retail/deposit-wallet/execute/submitSubmit a signed deposit wallet batch
Retail Onboarding
POST/api/v1/retail/credentials/preparePrepare a ClobAuth challenge for client signing
Retail Onboarding
POST/api/v1/retail/credentials/submitSubmit a client-signed ClobAuth payload
Retail Onboarding
POST/api/v1/retail/agentic/signSign venue-generic EIP-712 typed data
Retail Onboarding
GET/api/v1/retail/balancesGet combined balances across venues
Cross-venue
GET/api/v1/retail/deposit-addressGet deposit addresses for all venues
Cross-venue
POST/api/v1/retail/transfer/quoteGet cross-venue transfer quote
Cross-venue
POST/api/v1/retail/transfer/executeExecute cross-venue transfer
Cross-venue
GET/api/v1/retail/transfer/status/{tx_hash}Check cross-venue transfer status
Cross-venue

Data models

AuthErrorResponseErrorResponseRetailApiCredentialMetadataOnboardingStatusResponseRetailWalletResponseBalanceResponseCredentialResetResponseApprovalStatusResponseRegisterRetailWalletRequestRegisterRetailWalletResponseSafeCreateSubmitRequestSafeExecuteTransactionDtoSafeExecutePrepareRequestSafeExecutePrepareResponseSafeExecuteSubmitRequestDepositWalletCreateRequestDepositWalletCreateResponseDepositWalletExecutePrepareRequestDepositWalletExecutePrepareResponseDepositWalletExecuteSubmitRequestDepositWalletExecuteSubmitResponseRelayerSubmitResponseCredentialsPrepareRequestCredentialsPrepareResponseCredentialsSubmitRequestCredentialsSubmitResponseAgenticSignRequestAgenticSignResponseVenueVenueBalanceBalancesResponsePredictionMarketsDepositInfoPolymarketBridgeDepositAddressesPerpsDepositInfoDepositAddressResponseTransferQuoteRequestBridgeEstimateTransferQuoteResponseTransferExecuteRequestTransferExecuteResponseTransferStatusResponse