Skip to main content
GET
/
wallet
/
audit-status
Get Wallet Audit Status
curl --request GET \
  --url https://pm-t1.bxingupdate.com/bvapi/wallet/audit-status \
  --header 'Authorization: Bearer <token>'
{
  "walletAddress": "<string>",
  "auditsStatus": 0,
  "auditsStatusText": "未授权"
}

Documentation Index

Fetch the complete documentation index at: https://docs-t.aionmarket.com/llms.txt

Use this file to discover all available pages before exploring further.

Query whether a Deposit Wallet (signatureType=3) has completed all 12 on-chain approvals required for Polymarket trading.

​
Overview

This endpoint applies only to wallets registered with signatureType=3 (Deposit Wallet). For EOA (0), POLY_PROXY (1), and GNOSIS_SAFE (2) wallets, no on-chain approvals are required and this endpoint does not need to be called. When using a Deposit Wallet, the wallet must complete 12 on-chain approvals on Polygon before any order can be placed. These approvals grant Polymarket exchange contracts (CTF Exchange, Neg Risk Exchange, etc.) permission to move pUSD (ERC-20) and Conditional Tokens (ERC-1155) on behalf of the wallet. This endpoint checks mk_ai_agent.audits_status:
ValueMeaningAgent Action
0Not authorizedAgent must perform 12 approvals using the user’s private key
1Fully authorizedReady to trade on Polymarket
A background cron job runs every 30 minutes to verify all 12 approvals on-chain and update audits_status automatically.

​
Query Parameters

ParameterTypeRequiredDescription
walletAddressstringYesThe Polygon wallet address (Deposit Wallet) to check.

​
Response

​
walletAddress
string
The queried wallet address.
​
auditsStatus
integer
0 = not authorized, 1 = fully authorized.
​
auditsStatusText
string
Human-readable status: "未授权" or "已授权".
{
  "walletAddress": "0xa0179F0E513652D1193e0A493007B277C31e3C37",
  "auditsStatus": 1,
  "auditsStatusText": "已授权"
}

​
Examples

curl -G "https://pm-t1.bxingupdate.com/bvapi/wallet/audit-status" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "walletAddress=0xa0179F0E513652D1193e0A493007B277C31e3C37"

​
Error Responses

StatusDescription
400未找到匹配的 Agent 记录 — no agent found for this wallet + API key combination
401Invalid or missing API key

​
When to Use This Endpoint

Call this endpoint only when the wallet is registered with signatureType=3 (Deposit Wallet). For EOA / Proxy / Safe wallets it always returns auditsStatus=0 because those types are not subject to the 12-item audit — they don’t need it. Do not treat that 0 as a blocker for non-deposit wallets. When using a Deposit Wallet, the agent MUST call this endpoint before placing any Polymarket trade. If auditsStatus is 0, the agent must:
  1. Call GET /wallet/audit-items to get the 12 approval items
  2. Execute each approval on-chain using the user’s private key
  3. Wait for the cron job (30 min) to detect the approvals and update status, or call this endpoint again to verify

Authorizations

​
Authorization
string
header
default:YOUR_API_KEY
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
walletAddress
string
required

Polygon wallet address (Deposit Wallet) to check.

Response

Wallet audit status

​
walletAddress
string

The queried wallet address

​
auditsStatus
enum<integer>

0 = not authorized, 1 = fully authorized

Available options:
0,
1
​
auditsStatusText
enum<string>

Human-readable status text

Available options:
未授权,
已授权