Account

Caller-scoped account endpoints

Get order status

get

Returns the status of a single order for the authenticated account.

Rules

  • symbol is required.

  • Exactly one of orderId (server-assigned UUID) or origClientOrderId (your client ID) must be provided.

  • Requests must be signed (global security requires XApiKey header AND Ed25519Sig query signature).

Authorizations
X-API-KEYstringRequired
signaturestringRequired

Ed25519 signature of payload

Query parameters
symbolstring · min: 3 · max: 33Required

Trading pair symbol

Example: PLEX-HBARPattern: ^[A-Z0-9_]+-[A-Z0-9_]+$
orderIdstring · uuidOptional

Server-assigned order ID (if combined with origClientOrderId, must refer to same order).

Example: 26a911ff-f546-eaaf-4b22-e57657b57571
origClientOrderIdstringOptional

Client-assigned order ID (optional if orderId is set).

Example: myorder-001Pattern: ^[A-Za-z0-9._-]{1,36}$
Responses
200

Order status

application/json
get
/api/v1/order
GET /api/v1/order?symbol=PLEX-HBAR HTTP/1.1
Host: aincent.com
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "symbol": "PLEX-HBAR",
  "orderId": "26a911ff-f546-eaaf-4b22-e57657b57571",
  "clientOrderId": "myorder-001",
  "price": "0.01234567",
  "origQty": "100.00000000",
  "executedQty": "25.00000000",
  "cumulativeQuoteQty": "0.30864175",
  "status": "PARTIALLY_FILLED",
  "timeInForce": "GTC",
  "type": "LIMIT",
  "side": "BUY",
  "stopPrice": null,
  "time": 1724952745000,
  "updateTime": 1724952751000,
  "isWorking": true,
  "workingTime": 60000
}

Get open orders

get

Returns all open orders for the authenticated account.

Rules

  • symbol is optional. When provided, results are filtered to that trading pair; otherwise all symbols are returned.

  • When there are no open orders, the server returns 200 with an empty array [].

  • Requests must be signed (global security requires XApiKey header AND Ed25519Sig query signature).

Authorizations
X-API-KEYstringRequired
signaturestringRequired

Ed25519 signature of payload

Query parameters
symbolstring · min: 3 · max: 33Required

Trading pair symbol

Example: PLEX-HBARPattern: ^[A-Z0-9_]+-[A-Z0-9_]+$
Responses
200

List of open orders

application/json
get
/api/v1/openOrders
GET /api/v1/openOrders?symbol=PLEX-HBAR HTTP/1.1
Host: aincent.com
X-API-KEY: YOUR_API_KEY
Accept: */*

[
  {
    "symbol": "PLEX-HBAR",
    "orderId": "26a911ff-f546-eaaf-4b22-e57657b57571",
    "clientOrderId": "myorder-001",
    "price": "0.01234567",
    "origQty": "100.00000000",
    "executedQty": "25.00000000",
    "cumulativeQuoteQty": "0.30864175",
    "status": "PARTIALLY_FILLED",
    "timeInForce": "GTC",
    "type": "LIMIT",
    "side": "BUY",
    "stopPrice": null,
    "time": 1724952745000,
    "updateTime": 1724952751000,
    "isWorking": true,
    "workingTime": 60000
  },
  {
    "symbol": "PLEX-HBAR",
    "orderId": "8d3de5fd-8b0b-4f0c-b8f4-0a9c2dbf3f60",
    "clientOrderId": "myorder-002",
    "price": "0.01230000",
    "origQty": "50.00000000",
    "executedQty": "0.00000000",
    "cumulativeQuoteQty": "0.00000000",
    "status": "NEW",
    "timeInForce": "GTC",
    "type": "LIMIT",
    "side": "SELL",
    "stopPrice": null,
    "time": 1724952800000,
    "updateTime": 1724952800000,
    "isWorking": true,
    "workingTime": 0
  }
]

Get account trades

get

Returns executed trades (fills) for the authenticated account.

Rules

  • symbol is required.

  • If fromId is supplied, results include trades with id >= fromId and are returned in ascending id order; otherwise the most recent trades are returned.

  • limit defaults to 500 and is clamped to a maximum of 1000.

  • When there are no trades, the server returns 200 with an empty array [].

  • Time window: startTime and endTime together must not exceed 24 hours.

  • Supported parameter combinations (with symbol always present):

    • symbol

    • symbol + orderId

    • symbol + startTime

    • symbol + endTime

    • symbol + fromId

    • symbol + startTime + endTime

    • symbol + orderId + fromId

  • Requests must be signed (global security requires XApiKey header AND Ed25519Sig query signature).

  • Data Source: Memory ⇒ Database.

Authorizations
X-API-KEYstringRequired
signaturestringRequired

Ed25519 signature of payload

Query parameters
symbolstring · min: 3 · max: 33Required

Trading pair symbol

Example: PLEX-HBARPattern: ^[A-Z0-9_]+-[A-Z0-9_]+$
orderIdstring · uuidOptional

Exchange-assigned order ID (UUID). May be combined with fromId.

Example: 26a911ff-f546-eaaf-4b22-e57657b57571
startTimestring · int64Optional

Start of the time filter (ms since epoch). Can be used alone or with endTime (together ≤ 24h).

Example: 1724952745000
endTimestring · int64Optional

End of the time filter (ms since epoch). Can be used alone or with startTime (together ≤ 24h).

Example: 1725039145000
fromIdstring · int64Optional

Inclusive trade id to start from (id >= fromId). May be used with symbol or with symbol + orderId.

Example: 28457
limitstring · min: 1 · max: 1000Optional

Max number of trades to return. Default 500; maximum 1000. Out-of-range values are clamped.

Example: 500
Responses
200

List of account trades

application/json
get
/api/v1/myTrades
GET /api/v1/myTrades?symbol=PLEX-HBAR HTTP/1.1
Host: aincent.com
X-API-KEY: YOUR_API_KEY
Accept: */*

[
  {
    "symbol": "PLEX-HBAR",
    "id": 28457,
    "orderId": "26a911ff-f546-eaaf-4b22-e57657b57571",
    "price": "0.01234567",
    "qty": "12.00000000",
    "quoteQty": "0.14814804",
    "commission": "0.10000000",
    "commissionAsset": "PLEX",
    "time": 1724952751000,
    "isBuyer": true,
    "isMaker": false
  },
  {
    "symbol": "PLEX-HBAR",
    "id": 28458,
    "orderId": "26a911ff-f546-eaaf-4b22-e57657b57571",
    "price": "0.01230000",
    "qty": "38.00000000",
    "quoteQty": "0.46740000",
    "commission": "0.30000000",
    "commissionAsset": "HBAR",
    "time": 1724952799000,
    "isBuyer": true,
    "isMaker": true
  }
]

Get commission rates for the authenticated account

get

Returns a particular symbol's maker and taker commission rates for the caller identified by the provided credentials. Authentication uses the global requirement: XApiKey (header) AND Ed25519Sig (query).

Authorizations
X-API-KEYstringRequired
signaturestringRequired

Ed25519 signature of payload

Query parameters
symbolstring · min: 3 · max: 33Required

Trading pair symbol

Example: WETH-USDCPattern: ^[A-Z0-9_]+-[A-Z0-9_]+$
Responses
200

Commission rates for the authenticated caller

application/json
get
/api/v1/account/commission
GET /api/v1/account/commission?symbol=text HTTP/1.1
Host: aincent.com
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "maker": "0.00150000",
  "taker": "0.00150000"
}

Get commission rates and balances for the authenticated account

get

Returns the commission rates and balances for the caller identified by the provided credentials. Authentication uses the global requirement: XApiKey (header) AND Ed25519Sig (query).

Authorizations
X-API-KEYstringRequired
signaturestringRequired

Ed25519 signature of payload

Query parameters
omitZeroBalancesbooleanOptional

If true, omit any balances where both 'free' and 'locked' are zero

Default: falseExample: true
Responses
200

Account balances for the authenticated caller

application/json
get
/api/v1/account
GET /api/v1/account HTTP/1.1
Host: aincent.com
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "commissionRates": {
    "maker": "0.00150000",
    "taker": "0.00150000"
  },
  "balances": [
    {
      "asset": "BTC",
      "free": "0.25000000",
      "locked": "0.00000000"
    },
    {
      "asset": "USDT",
      "free": "1500.00",
      "locked": "25.00"
    }
  ]
}
PreviousOrdersNextAsyncAPI spec

Last updated