Available

Currency

get/v1/currency/supported

List supported currency codes

curl -X GET https://api.tbbnetwork.com/v1/currency/supported \
  -H "Authorization: Bearer sk_sandbox_..." \

Response (200)

Example 200 response

[
  "value"
]

post/v1/currency/convert

Convert an amount between supported currencies using static reference rates. Estimate only — never authoritative for settlement (see TradeEngine, which rejects cross-currency trades outright rather than trusting these rates).

curl -X POST https://api.tbbnetwork.com/v1/currency/convert \
  -H "Authorization: Bearer sk_sandbox_..." \
  -H "Idempotency-Key: 5f2f...b91" \
  -H "Content-Type: application/json" \
  -d '{
  "amount": 1,
  "from": "from",
  "to": "to"
}'

Request body

Field	Type	Required
amount	number	yes
from	string	yes
to	string	yes

Response (201)

Field	Type	Required
amount	number	—
currency	string	—
estimateOnly	boolean	—

Example 201 response

{
  "amount": 1,
  "currency": "USD",
  "estimateOnly": false
}

Possible errors

Any other failure (validation, auth, rate limiting, a resource that doesn't exist) returns this same envelope with a non-2xx status — error.code is stable and safe to branch on; error.requestId is worth logging and including in a support request.

Example error response

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "A human-readable description of what went wrong.",
    "requestId": "req_01hxyz..."
  }
}