GET /ft/p2p/:chainId/taker/:account

List the OTC orders addressed to a taker: the orders that account can fill. Paginated.

GET /ft/p2p/{chainId}/taker/{account}

List orders addressed to a taker

cURL

curl --request GET \
  --url https://api.velora.xyz/ft/p2p/{chainId}/taker/{account}

200

{
  "orders": [
    {
      "orderHash": "<string>",
      "chainId": 1,
      "nonceAndMeta": "<string>",
      "expiry": 123,
      "maker": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "taker": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "makerAsset": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "takerAsset": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "makerAmount": "1000000000000000000",
      "takerAmount": "1000000000000000000",
      "signature": "<string>",
      "permitMakerAsset": "<string>",
      "takerFromMeta": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "makerBalance": "1000000000000000000",
      "fillableBalance": "1000000000000000000",
      "reservedBalance": "1000000000000000000",
      "swappableBalance": "1000000000000000000",
      "transactionHash": "<string>",
      "createdAt": 123,
      "updatedAt": 123
    }
  ],
  "limit": 123,
  "offset": 123,
  "total": 123,
  "hasMore": true
}

List orders where account is the named taker: the orders that address is allowed to fill. Use type=P2P to scope to counterparty-restricted OTC orders. Paginated with limit and offset; total / hasMore mark the end.

This is the endpoint a taker polls to discover orders a maker has addressed to them.

Related pages

OTC overview

Lifecycle, endpoints, and order states end to end.

List maker orders

The mirror endpoint: orders created by a maker.

GET /ft/order/:orderHash

Fetch a single order by hash before filling.

SDK → OTC

sdk.otcOrders.getOTCOrders({ taker }).

Path Parameters

chainId · integer · required

EVM chain ID. EVM chain ID. AugustusRFQ is deployed on 1 (Mainnet), 10 (Optimism), 56 (BSC), 137 (Polygon), 8453 (Base), 42161 (Arbitrum), 43114 (Avalanche), and 100 (Gnosis). See /resources/chains-and-contracts for per-chain addresses.

Example:

1

account · string · required

The taker's wallet address. EVM address (20 bytes, hex-encoded with 0x prefix).

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

Query Parameters

type · enum<string>

Filter by order type. Use P2P for OTC orders. P2P is a counterparty-restricted OTC order (a named taker). LIMIT is an open AugustusRFQ order. The OTC API surface is P2P.

Available options: P2P, LIMIT

limit · integer · default: 100

Maximum number of orders to return.

offset · integer · default: 0

Number of orders to skip, for pagination.

orderBy · enum<string> · default: createdAt

Field to sort by.

Available options: createdAt, updatedAt, expiry

hideSmallBalances · boolean · default: false

Omit orders whose remaining fillable balance is negligible.

Response

200 - application/json

Paginated list of orders.

Paginated list of orders.

orders · object[]

Show child attributes

limit · integer

offset · integer

total · integer

hasMore · boolean