TokenOne Core API — Guia de Início Rápido#

Sumário#

Visão geral#

Autenticação#

X-API-Key: <sua-chave>

Idempotência#

Idempotency-Key: <uuid-único>

Paginação#

{
  "data": [ /* itens */ ],
  "paging": { "limit": 20, "offset": 0, "total": 123 }
}

Modelo de erro#

{
  "code": "NOT_FOUND",
  "message": "Recurso não encontrado",
  "trace_id": "req-xxxx"
}

1) Customers (PF/PJ) + KYC#

Criar um cliente#

{
  "id": "7f2a1b2c-1111-2222-3333-aaaaaaaaaaaa",
  "type": "INDIVIDUAL",
  "country": "BR",
  "email": "ana.silva@example.com",
  "name": "Ana Silva",
  "verification": { "status": "PENDING", "level": "basic", "updated_at": "2025-09-17T19:00:00Z" },
  "created_at": "2025-09-17T19:00:00Z"
}

Listar clientes#

Ler um cliente#

Upload de documento (KYC)#

{
  "id": "d01a9c00-7777-8888-9999-cccccccccccc",
  "customer_id": "7f2a1b2c-1111-2222-3333-aaaaaaaaaaaa",
  "status": "RECEIVED",
  "created_at": "2025-09-17T19:00:00Z"
}

Verificação KYC#

2) Transactions (on-ramp, off-ramp, transfer)#

Listar transações#

Ler uma transação#

On-ramp (BRL → USDC)#

Off-ramp (USDC → BRL)#

Transfer (P2P interno em USDC)#

Status típicos: AWAITING_FUNDS → PROCESSING → SUCCESS/FAILED.

3) Offers (ofertas de investimento)#

Listar ofertas#

Criar oferta#

Ler oferta#

Comprar oferta#

Observação: criação do Token é feita após oferta finalizada (FINALIZED).

4) Tokens#

Listar tokens#

Criar token (baseado em oferta finalizada)#

Ler token#

5) Issuers (emissores)#

Listar emissores#

Criar emissor#

Ler emissor#

Atualizar emissor#

6) Distributors (distribuidores)#

Listar distribuidores#

Criar distribuidor#

Ler distribuidor#

Atualizar distribuidor#

Códigos de status comuns#

Boas práticas#

Próximos passos#

OpenAPI#