API Documentation

Developer Portal

Integrate your application with the Validus Platform in minutes. RESTful APIs, reliable Webhooks, and ready-to-use SDKs.

Quick StartAPI Reference

Quick Start

Start integrating in 3 steps

1

Create your account

Register and access the admin panel to generate your credentials.

POST /api/auth/register
2

Generate API Key

In the Admin panel, create an API Key to authenticate your requests.

vld_sk_live_abc123...
3

Make your first call

Use the API Key in the Authorization header to authenticate.

curl -H "Authorization: Bearer ..."

Main Endpoints

Base URL: https://api.validus.com.br/v1

POST/duplicatas

Create duplicate and notify drawee

GET/duplicatas/:id

Consult duplicate status

POST/tokens/mint

Tokenize accepted duplicate

GET/marketplace/offers

List available offers

POST/marketplace/buy

Buy token (atomic swap)

POST/liquidacao/process

Process settlement and burn

View Interactive Swagger

Webhooks

Receive real-time events on your server

Available Events

  • duplicata.aceita - Drawee accepted duplicate
  • duplicata.recusada - Drawee refused duplicate
  • token.minted - Token created successfully
  • marketplace.compra - Token sold in marketplace
  • liquidacao.processada - Settlement processed and token burned

Payload example:

{
  "event": "duplicata.aceita",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "duplicata_id": "dup_abc123",
    "sacado_cnpj": "12345678000190",
    "valor": 10000.00,
    "vencimento": "2025-02-15"
  }
}

SDKs and Libraries

Accelerate your integration with our official libraries

Node.js / TypeScript

npm install @validus/sdkView documentation →

Python

pip install validus-sdkView documentation →

Go

go get github.com/validus/sdk-goView documentation →

Ready to start?

Create your account and start tokenizing today

Talk to an Expert