Treasury

Download schema

Existing Tesser core API (§9.2), vendored. Nexa withdraws USDC here; BitGo converts USDC to USD and pays out (out of scope). Status progression arrives on Tesser's standard withdrawal webhooks, delivered to Nexa's own receiver.

Create withdrawal

POST

https://nexa-poc-main-c82e5ac.zuplo.app

/v1/treasury/withdrawals

Create a withdrawal from a managed account or self-custodial wallet to an external bank account.

Source types:

Circle USDC ledger (path A) — desired.from.network omitted.
Self-custodial wallet (path B) — desired.from.network populated (e.g., BASE).

Create withdrawal › Request Body

CreateWithdrawalRequest

object · required

Caller's stated intent for the withdrawal.

organization_reference_id

string

Optional client-supplied identifier.

Create withdrawal › Responses

Withdrawal created successfully

WithdrawalResponse

object · required

Withdrawal data

POST/v1/treasury/withdrawals

curl https://nexa-poc-main-c82e5ac.zuplo.app/v1/treasury/withdrawals \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "desired": {
    "from": {
      "account_id": "55042f8f-e527-56f1-b57c-eef23ca862db",
      "amount": "1000",
      "currency": "USDC"
    },
    "to": {
      "account_id": "44031e7e-d416-45f0-a46b-ded12b9751ca",
      "currency": "USD"
    }
  }
}'

Example Request Body

{
  "desired": {
    "from": {
      "account_id": "55042f8f-e527-56f1-b57c-eef23ca862db",
      "amount": "1000",
      "currency": "USDC"
    },
    "to": {
      "account_id": "44031e7e-d416-45f0-a46b-ded12b9751ca",
      "currency": "USD"
    }
  }
}

json

application/json

Example Responses

{
  "data": {
    "id": "6a2f8c1e-3b9d-4e74-b5a0-7c4d2e1f9b3a",
    "workspace_id": "b53f6690-3242-4942-9907-885779632832",
    "organization_reference_id": null,
    "direction": "outbound",
    "desired": {
      "from": {
        "account_id": "55042f8f-e527-56f1-b57c-eef23ca862db",
        "amount": "1000",
        "currency": "USDC",
        "network": null
      },
      "to": {
        "account_id": "44031e7e-d416-45f0-a46b-ded12b9751ca",
        "amount": null,
        "currency": "USD",
        "network": null
      }
    },
    "estimated": {
      "from": {
        "account_id": null,
        "amount": null,
        "currency": null,
        "network": null
      },
      "to": {
        "account_id": null,
        "amount": null,
        "currency": null,
        "network": null
      }
    },
    "actual": {
      "from": {
        "account_id": null,
        "amount": null,
        "currency": null,
        "network": null
      },
      "to": {
        "account_id": null,
        "amount": null,
        "currency": null,
        "network": null
      }
    },
    "balance_status": "unreserved",
    "balance_reserved_at": null,
    "steps": [],
    "created_at": "2024-03-01T10:00:00.000Z",
    "updated_at": "2024-03-01T10:00:00.000Z",
    "expires_at": "2024-03-01T14:00:00.000Z"
  }
}

json

application/json

Accounts

Create withdrawal

POST

https://nexa-poc-main-c82e5ac.zuplo.app

/v1/treasury/withdrawals

Create a withdrawal from a managed account or self-custodial wallet to an external bank account.

Source types:

Circle USDC ledger (path A) — desired.from.network omitted.
Self-custodial wallet (path B) — desired.from.network populated (e.g., BASE).

Create withdrawal › Request Body

CreateWithdrawalRequest

object · required

Caller's stated intent for the withdrawal.

organization_reference_id

string

Optional client-supplied identifier.

Create withdrawal › Responses

Withdrawal created successfully

WithdrawalResponse

object · required

Withdrawal data