Register Wallet Credentials

​

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 derived from your private key

​

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

​

Examples

curl -X POST https://www.aionmarket.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"
  }'

from aionmarket_sdk import AionMarketClient

client = AionMarketClient(api_key="YOUR_API_KEY", base_url="https://www.aionmarket.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",
)
print(result)

​

Response

{
  "success": true,
  "walletAddress": "0x1111111111111111111111111111111111111111",
  "signatureType": 0,
  "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://www.aionmarket.com/bvapi/wallet/credentials/check?walletAddress=0x1111111111111111111111111111111111111111" \
  -H "Authorization: Bearer YOUR_API_KEY"

from aionmarket_sdk import AionMarketClient

client = AionMarketClient(api_key="YOUR_API_KEY", base_url="https://www.aionmarket.com/bvapi")
status = client.check_wallet_credentials("0x1111111111111111111111111111111111111111")
print(status)

​

Signature Types

​

Troubleshooting

​

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