Skip to main content
POST
/
agent-wallet
Manage agent wallet (signed)
curl --request POST \
  --url https://exchange-api2.bulk.trade/api/v1/agent-wallet \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": {
    "type": "agentWalletCreation",
    "agent": {
      "a": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
      "d": false
    },
    "nonce": 1704067200000
  },
  "signature": "5JX7N4f2r2qsLheHyvCpwzs4iXQjLPp1UZH1Ec4a7B4wJQi8Np4ncn3tDrEVW9BLjLVWm2nqFaGgk9T3o4WdTgpx",
  "account": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signer": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7"
}
'
{
  "status": "ok",
  "response": {
    "type": "<string>",
    "data": {
      "statuses": [
        {
          "resting": {
            "oid": "<string>"
          }
        }
      ]
    }
  }
}

Request Format

{
  "action": {
    "type": "agentWalletCreation",
    "agent": {
      "a": "AgentPublicKeyBase58",
      "d": false
    },
    "nonce": 1704067200000000000
  },
  "account": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signer": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signature": "5JXWgp1fW6px2Gjhw6YHhQ4..."
}
FieldDescription
aAgent public key to authorize (base58)
dDelete flag (false = add, true = remove)
nonceUnique nonce for replay protection (nanoseconds)

Before You Start

See the Transaction Signing guide for details on how to sign your requests.Nonce: Use timestamp in nanoseconds: BigInt(Date.now()) * 1_000_000n

Body

application/json

Signed transaction for managing agent wallets

action
object
required
signature
string
required

Ed25519 signature (base58)

account
string
required

User public key (base58)

signer
string
required

Signer public key (base58)

Response

Agent wallet updated

Response from order/cancel/agent wallet operations

status
enum<string>
Available options:
ok,
error
response
object