GET /funding

Account funding payments

Account funding payments.

operationId: fetchFundingHistory · CCXT method: fetchFundingHistory

Declared server: https://api.testnet.nexus.xyz/v1. See Networks.

Authentication: agentAuth, hmacAuth.

Account funding payments

get

/funding

Funding payment history for the authenticated account, newest first.

This is a bounded window, not the account's whole history. The rows are served from an in-memory tier, so the answer reaches back only as far as x-nexus-funding-oldest-ms says — older rows are persisted durably and are not returned. x-nexus-funding-truncated reports the separate question of whether limit cut the list. A short answer is not evidence that the account paid no funding.

Authorizations

X-API-KeystringRequired

HMAC API key authentication. Send three headers:

• X-API-Key: your key ID (e.g. nx_a1b2c3...)
• X-Timestamp: current time in unix milliseconds
• X-Signature: hex(hmac_sha256(secret, timestamp + "\n" + METHOD + "\n" + path + "\n" + query + "\n" + sha256_hex(body)))

Timestamp must be within 30 seconds of server time.

The key is network-scoped; the signature is not. The canonical string above has no network component, so the same signed request is byte-identical on every host. What stops a testnet key from authenticating against mainnet is that the key does not exist in that host's key store — sign only for the host that minted the key, and never replay a signed payload against another network. Presented to the wrong host, a key is refused with the same opaque 401 as an unknown key and must not be retried there. See “API keys are bound to one network” in the API description.

Query parameters

limitinteger · max: 1000Optional

Maximum records to return

Default: 100

Responses

200

Funding payments, newest first.

application/json

401

Authentication failed. All 401 responses return the same opaque body to prevent information leakage. A credential minted on a different network is one of the causes it hides — by design, so that a key id cannot be probed for existence on another network. Do not retry it against another host.

application/json

get/funding

GET /v1/funding HTTP/1.1
Host: api.testnet.nexus.xyz
X-API-Key: YOUR_API_KEY
Accept: */*

[
  {
    "symbol": "text",
    "amount": "text",
    "direction": "paid",
    "funding_rate": "text",
    "position_size": "text",
    "timestamp": 1
  }
]

Test it cannot sign this request. X-Signature is an HMAC computed per call: see Authentication, or use an SDK.

---

_{API version 0.9.122}