> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aionmarket.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Register Wallet Credentials
> Store Polymarket CLOB credentials for the given wallet.
Register Polymarket CLOB API credentials for a wallet to enable trading.
## Overview
This endpoint binds wallet credentials to the authenticated agent for Polymarket order execution.
## 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](https://polymarket.com/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
⚠️ **Important**: Save these securely. You won't be able to view them again!
## Request fields
| Field | Type | Required | Description |
| --------------- | ------ | -------- | ------------------------------ |
| `walletAddress` | string | Yes | Wallet address (0x-prefixed) |
| `apiKey` | string | Yes | Polymarket CLOB API key |
| `apiSecret` | string | Yes | Polymarket CLOB API secret |
| `apiPassphrase` | string | Yes | Polymarket CLOB API passphrase |
## Examples
```bash theme={null}
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"
}'
```
```python theme={null}
from aion_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
```json theme={null}
{
"success": true,
"walletAddress": "0x1111111111111111111111111111111111111111",
"signatureType": 0,
"encryptedCredentials": true,
"registeredAt": "2024-04-15T10:30:00Z"
}
```
## Response Fields
| Field | Type | Description |
| ---------------------- | ------- | -------------------------------------------- |
| `success` | boolean | Registration success flag |
| `walletAddress` | string | Registered wallet address |
| `signatureType` | integer | `0=EOA`, `1=PolymarketProxy`, `2=GnosisSafe` |
| `encryptedCredentials` | boolean | Encrypted-at-rest indicator |
| `registeredAt` | string | Registration timestamp |
## 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
Before placing trades, verify that credentials are properly registered:
```bash theme={null}
curl -X GET "https://www.aionmarket.com/bvapi/wallet/credentials/check?walletAddress=0x1111111111111111111111111111111111111111" \
-H "Authorization: Bearer YOUR_API_KEY"
```
```python theme={null}
from aion_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
When credentials are registered, the system detects the wallet type:
| Type | Name | Description |
| ---- | ------------------------------ | -------------------------------------- |
| 0 | EOA (Externally Owned Account) | Standard Ethereum wallet |
| 1 | PolymarketProxy | Proxy contract for additional features |
| 2 | GnosisSafe | Multi-signature wallet |
## Troubleshooting
### Invalid Credentials Error
```json theme={null}
{ "detail": "Invalid Polymarket credentials" }
```
**Fix**: Verify API key, secret, and passphrase are correct and not expired.
### Wallet Address Mismatch
```json theme={null}
{ "detail": "Wallet address does not match credential owner" }
```
**Fix**: Ensure the wallet address matches the Polymarket account owner.
### Already Registered
```json theme={null}
{ "detail": "Credentials already exist for this wallet" }
```
**Fix**: Existing credentials are active. Rotate by registering new credentials.
## 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
## OpenAPI
````yaml POST /wallet/credentials
openapi: 3.1.0
info:
title: Aion AI Agent API
description: >-
API for agent registration, wallet onboarding, market discovery, order
management, and execution on Aion.
version: 1.0.0
contact:
name: Aion Support
email: info@aionmarket.com
url: https://docs.aionmarket.com
servers:
- url: https://www.aionmarket.com/bvapi
description: Aion API
security:
- bearerAuth: []
tags:
- name: Agent Management
- name: Market Operations
- name: Order Management
- name: Trading
- name: Kalshi
- name: Skills
- name: Wallet Management
- name: Trades & Leaderboard
- name: Utilities
- name: Settings
- name: Positions & Portfolio
- name: Fee Charging
paths:
/wallet/credentials:
post:
tags:
- Wallet Management
summary: Register Wallet Credentials
description: Store Polymarket CLOB credentials for the given wallet.
operationId: registerWalletCredentials
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/WalletCredentialsRequest'
responses:
'200':
description: Credentials stored
content:
application/json:
schema:
$ref: '#/components/schemas/WalletCredentialStatus'
components:
schemas:
WalletCredentialsRequest:
type: object
required:
- walletAddress
- apiKey
- apiSecret
- apiPassphrase
properties:
walletAddress:
type: string
apiKey:
type: string
apiSecret:
type: string
apiPassphrase:
type: string
signatureType:
type: integer
description: Optional explicit wallet signature type. Use 3 for deposit wallets.
enum:
- 0
- 1
- 2
- 3
WalletCredentialStatus:
type: object
properties:
hasCredentials:
type: boolean
description: >-
Whether a stored credential row exists for the authenticated user
and wallet. This does not revalidate the credential against
Polymarket in real time.
walletAddress:
type: string
description: Wallet address checked
signatureType:
type: integer
description: >-
Stored or inferred signature type: 0=EOA, 1=PolymarketProxy,
2=GnosisSafe, 3=DepositWallet
securitySchemes:
bearerAuth:
type: http
scheme: bearer
x-default: YOUR_API_KEY
````