Register Wallet Credentials

{
  "walletAddress": "0xC4378BFEe30dBAc2A907ea1E486acCC78B02c185",
  "apiKey": "...",
  "apiSecret": "...",
  "apiPassphrase": "...",
  "signatureType": 3   // ← required for Deposit Wallets
}

​

Overview

​

Prerequisites

1. Polymarket account with CLOB access
2. API Key, API Secret, and API Passphrase from Polymarket
3. Agent registered via POST /agents/register
4. Valid wallet address that matches the Polymarket account or deposit wallet you are registering

​

Getting Polymarket CLOB credentials

1. Go to Polymarket Settings
2. Navigate to API Keys section
3. Create a new API key with trading permissions
4. Copy the:
   • API Key
   • API Secret
   • API Passphrase

​

Request fields

​

How signatureType is resolved

1. If the request body contains an explicit signatureType (0/1/2/3), the backend stores it as-is. Always do this for Deposit Wallets.
2. Otherwise the backend calls eth_getCode(walletAddress) against Polygon:
   • bytecode is 0x (no contract) → 0 (EOA)
   • bytecode matches the Gnosis Safe singleton interface → 2 (GnosisSafe)
   • any other contract bytecode → 1 (PolymarketProxy)
3. Polymarket Deposit Wallets are counterfactual: until the first deposit/trade, getCode returns 0x even though Polymarket treats them as signatureType=3. Inference therefore wrongly settles on 0. Always pass signatureType: 3 explicitly for Deposit Wallets.
4. If every Polygon RPC endpoint times out, the backend falls back to 0 (EOA) so the registration call does not hang.

​

Examples

curl -X POST https://pm-t1.bxingupdate.com/bvapi/wallet/credentials \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "walletAddress": "0x1111111111111111111111111111111111111111",
    "apiKey": "your-polymarket-api-key",
    "apiSecret": "your-polymarket-api-secret",
    "apiPassphrase": "your-polymarket-passphrase",
    "signatureType": 3
  }'

from aion_sdk import AionMarketClient

client = AionMarketClient(api_key="YOUR_API_KEY", base_url="https://pm-t1.bxingupdate.com/bvapi")

result = client.register_wallet_credentials(
    wallet_address="0x1111111111111111111111111111111111111111",
    api_key="your-polymarket-api-key",
    api_secret="your-polymarket-api-secret",
    api_passphrase="your-polymarket-passphrase",
    signature_type=3,
)
print(result)

​

Response

{
  "success": true,
  "walletAddress": "0xC4378BFEe30dBAc2A907ea1E486acCC78B02c185",
  "signatureType": 3,
  "encryptedCredentials": true,
  "registeredAt": "2024-04-15T10:30:00Z"
}

​

Response Fields

​

Credential Storage & Security

​

Our Commitment

• 🔐 Encrypted Storage: Credentials are encrypted at rest using AES-256
• 🚫 No Logging: API keys are never logged or stored in plaintext
• ✅ Verified Access: Only the registered API key can modify these credentials
• 🔄 Rotation Support: You can register new credentials to rotate keys

​

Best Practices

1. Regular Rotation: Change API keys every 90 days
2. Separate Keys: Use dedicated keys for each agent/service
3. Limited Scope: Create keys with minimum required permissions
4. Monitor Activity: Regularly check Polymarket API activity logs
5. Emergency Revocation: Revoke compromised keys immediately

​

Verifying Credentials

curl -X GET "https://pm-t1.bxingupdate.com/bvapi/wallet/credentials/check?walletAddress=0x1111111111111111111111111111111111111111" \
  -H "Authorization: Bearer YOUR_API_KEY"

from aion_sdk import AionMarketClient

client = AionMarketClient(api_key="YOUR_API_KEY", base_url="https://pm-t1.bxingupdate.com/bvapi")
status = client.check_wallet_credentials("0x1111111111111111111111111111111111111111")
print(status)

​

Signature Types

​

Troubleshooting

​

Stored signature_type is 0 but wallet is actually a Deposit Wallet (signatureType=3)

​

Invalid Credentials Error

{ "detail": "Invalid Polymarket credentials" }

​

Wallet Address Mismatch

{ "detail": "Wallet address does not match credential owner" }

​

Already Registered

{ "detail": "Credentials already exist for this wallet" }

​

Next Steps

1. Register Credentials: Follow the steps above
2. Verify Setup: Use the check endpoint to confirm
3. Fund Wallet: Transfer USDC.e to your Polymarket account
4. Try Limit Order: Start with a small limit order to test
5. Monitor: Track order fills in your agent dashboard

​

Related Endpoints

• GET /wallet/credentials/check - Verify wallet is registered
• POST /markets/trade - Place orders (requires registered wallet)
• GET /agents/me - View agent status and balance
• POST /agents/settings - Configure trading limits