Get pool funding
GET /pools/funding - Retrieve your dedicated runtime deposit instructions for the pre-funded fiat balance.
0Pools API pages are for approved headless partners. They cover the partner-visible quote, transact, status, trade, and balance lifecycle only.
Endpoint
| Field | Value |
|---|---|
| Method | GET |
| Path | /pools/funding |
| Area | Funding |
| Operation id | getFunding |
| Auth boundary | Secret key from your server. |
Use it for
Retrieve the dedicated deposit instructions that top up your pre-funded fiat balance. On-ramp trades draw from this balance, so you fund it ahead of time by sending a bank transfer to the IBAN and reference returned here.
The values are scoped to your partner account and provided at runtime. Render them to your operations team or your own funding screen rather than hard-coding any account number, and re-read this endpoint before each top-up so you always use current instructions.
EUR-only deposit instructions
Funding is EUR-only. An optional ?currency query is accepted and defaults to EUR; any non-EUR value returns 400 with the message only EUR funding is supported. The currency field in the response echoes the resolved currency — read it rather than hard-coding a value.
Response fields
| Field | Type | Use |
|---|---|---|
currency | string | Fiat currency of the deposit instructions. Funding is EUR-only, so this is always EUR. |
iban | string | null | Your dedicated deposit IBAN, provided at runtime. null until your account is provisioned (see below). |
reference | string | Payment reference you must include on the transfer so the credit is attributed to your partner balance. |
instructions | string | Human-readable deposit guidance to display to whoever initiates the transfer. Carries an operations note while unprovisioned. |
Always send the reference
The reference is how a deposit is matched to your partner balance. A transfer that omits or alters it cannot be attributed automatically and will require manual reconciliation through your account team.
Example request
# currency is optional and defaults to EUR; any non-EUR value returns 400.
curl "https://pools-api.0bit.app/v1/pools/funding?currency=EUR" \
-H "Authorization: Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"Example response
{
"currency": "EUR",
"iban": "XX00 0000 0000 0000 0000 00",
"reference": "0POOLS-PT-TEST-000123",
"instructions": "Send a SEPA transfer in EUR to the IBAN above and include the reference exactly as shown so the deposit credits your pre-funded balance."
}{
"currency": "EUR",
"iban": null,
"reference": "0POOLS-PT-TEST-000123",
"instructions": "Your dedicated deposit instructions are being provisioned. Contact your 0Bit account team to complete funding setup before sending a transfer."
}When iban is null, your dedicated deposit details have not been provisioned yet. Do not send a transfer; surface the operations note from instructions and reach out to your 0Bit account team. Poll the endpoint again once setup is confirmed.
Errors
Errors use the unified envelope. Branch on type, code, and statusCode; preserve the X-Request-Id header for support.
| Status | type | When |
|---|---|---|
400 | bad_request | A non-EUR ?currency value was supplied (only EUR funding is supported). Funding is EUR-only. |
401 | unauthorized | Missing or invalid secret key. |
403 | forbidden | Wrong key mode — code is key_mode_mismatch. This route is secret-key only and does not run the entitlement check, so the pool-access denial codes do not apply here. |
404 | not_found | Pre-funded balance funding is not enabled for your account, or the request is not partner-scoped. |
{
"type": "not_found",
"code": "not_found",
"message": "Funding instructions are not available for this account.",
"request_id": "req_test_000000000123",
"doc_url": null,
"statusCode": 404
}404 is expected when funding is off
A 404 here means the pre-funded balance gate is not enabled for your partner account — not that anything failed. Treat it as a configuration state and request enablement through your account team rather than retrying.
Production rules
- Keep secret keys on your server; this endpoint is secret-key only.
- Re-read funding instructions before each top-up; treat
currencyandibanas authoritative at runtime. - Always send the returned
referenceon the transfer so the credit is attributed automatically. - Treat
iban: nullas not-yet-provisioned: do not transfer, surface the operations note, and contact your account team. - Branch on machine-readable status, error code, and request id.
- Treat examples and placeholder ids as fake data only.
Public boundary
This reference covers partner-visible discovery, quote, transact, status, trade, balance, and funding behavior. Liquidity operations, routing internals, provider details, bank rails, reserve logic, and runbooks are outside the public API contract.