Dónde mandar los USDT, la tasa de ahora y tus topes

GET/prefondeos/condicionesProbar

URL base

API key x-api-keyRecordar la clave en este navegador (localStorage, no sale de aquí)

Enviar peticiónCopiar como curl

La llamada la hace tu navegador, contra el servidor que elijas arriba. Si la documentación no está servida desde el mismo origen que la API, el navegador puede bloquear la respuesta por CORS: en ese caso abre estas páginas desde la propia API (/docs) o usa el curl de arriba.

GET

/prefondeos/condiciones

curl --request GET \
  --url http://localhost:3000/v1/prefondeos/condiciones \
  --header 'x-api-key: <x-api-key>'

• Pruebas (sandbox)
• Producción

Scope treasury:read. La red y la dirección de la wallet de recepción las fija nuestro equipo y salen de aquí y del ticket, nunca de tu request. tasaIndicativa es la de este momento; la que vale es la del ticket que cotices. Sólo se acredita el USDT enviado desde una de tus walletsOrigenActivas (ver POST /prefondeos/wallets-origen).

En tu cuenta de pruebas, o con una key sk_test_, no hay wallet: red y direccion vienen en null, simulado en true y la tasa es la fija de pruebas. En tu cuenta de pruebas tu prefondeo ya viene cargado con Bs simulados (prefondeoPruebas): no mandes USDT, cotiza payout_bs y dispersa.

Authorizations

• ApiKeyAuth

Responses

200

Condiciones vigentes

Media typeapplication/json

object

red

Null en tu cuenta de pruebas o con una sk_test_

string

nullable

direccion

Null en tu cuenta de pruebas o con una sk_test_

string

nullable

simulado

True en tu cuenta de pruebas o con una sk_test_: no hay wallet

boolean

cotizable

Si con esta key se puede cotizar un ticket (POST /prefondeos)

boolean

prefondeoPruebas

Sólo en tu cuenta de pruebas: tu prefondeo de pruebas ya cargado (Bs simulados), o null

object

id

string format: uuid

saldoBs

Céntimos de Bs que le quedan

string

bsCargado

Céntimos de Bs cargados

string

tasa

Bs por 1 USDT, 8 decimales

string

caducaEn

Cuándo se cierra su saldo simulado

string format: date-time

nuevo

boolean

activo

string

Allowed values: USDT

tasaIndicativa

Bs por 1 USDT, 8 decimales

string

venceEnMinutos

integer

minimoUsdt

Micro-USDT

string

maximoUsdt

Micro-USDT por ticket

string

ticketsAbiertos

integer

maxTicketsAbiertos

integer

walletsOrigenActivas

Tus wallets de origen activas. Sólo se acredita lo que llega desde una de ellas.

Array<object>

object

id

string format: uuid

red

string

direccion

string

etiqueta

string

nullable

nota

string

Example

{
  "red": "TRC20",
  "activo": "USDT",
  "venceEnMinutos": 30
}

422

tenant_sin_prefondeo_con_tasa: tu cuenta no tiene activo este modelo

Media typeapplication/json

object

error

object

meta

Contexto estructurado del error cuando lo hay: qué límite se superó y de cuánto, qué campo es inválido, cuánto saldo había. No aparece en errores internos.

object

key

additional properties

any

type

string

Allowed values: invalid_request_error authentication_error rate_limit_error upstream_error api_error

code

Código ESTABLE. Programa contra esto.

string

message

string

request_id

string

Example

{
  "error": {
    "type": "invalid_request_error",
    "code": "insufficient_balance",
    "request_id": "req_8a0312ba896772bc441134cd"
  }
}

503

prefondeo_sin_configurar: todavía no hay red ni wallet de recepción (sólo en real, con una sk_live_)

Media typeapplication/json

object

error

object

meta

Contexto estructurado del error cuando lo hay: qué límite se superó y de cuánto, qué campo es inválido, cuánto saldo había. No aparece en errores internos.

object

key

additional properties

any

type

string

Allowed values: invalid_request_error authentication_error rate_limit_error upstream_error api_error

code

Código ESTABLE. Programa contra esto.

string

message

string

request_id

string

Example

{
  "error": {
    "type": "invalid_request_error",
    "code": "insufficient_balance",
    "request_id": "req_8a0312ba896772bc441134cd"
  }
}