Official API Documentation

Authentication

Quickstart Flowgrid Payments

Accept crypto payments in 3 steps. Supports Solana, BSC, Polygon, Arbitrum, Ethereum, and Base.

Quickstart Oráculo

Real-time crypto pricing from Binance, Bybit and KuCoin. ~150 pairs updated every 2 seconds.

Code Examples

Integration examples in multiple languages. Use the OpenAPI spec at /openapi.yaml to generate SDKs.

POST /payments/v1/create-payment

Copycurl -X POST "https://api.excrypto.finance/payments/v1/create-payment" \ -H "Content-Type: application/json" \ -H "x-api-key: exc_YOUR_KEY" \ -d '{ "amount": 25.50, "idempotency_key": "order-1001", "network": "solana", "token": "USDC" }'

Copyconst res = await fetch('https://api.excrypto.finance/payments/v1/create-payment', { method: 'POST', headers: { 'Content-Type': 'application/json', 'x-api-key': 'exc_YOUR_KEY' }, body: JSON.stringify({ amount: 25.50, idempotency_key: 'order-1001', network: 'solana', token: 'USDC' }) }); const data = await res.json(); console.log(data.payment_url);

Copyimport requests res = requests.post( 'https://api.excrypto.finance/payments/v1/create-payment', headers={'x-api-key': 'exc_YOUR_KEY'}, json={ 'amount': 25.50, 'idempotency_key': 'order-1001', 'network': 'solana', 'token': 'USDC' } ) data = res.json() print(data['payment_url'])

Copy$ch = curl_init('https://api.excrypto.finance/payments/v1/create-payment'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'x-api-key: exc_YOUR_KEY' ], CURLOPT_POSTFIELDS => json_encode([ 'amount' => 25.50, 'idempotency_key' => 'order-1001', 'network' => 'solana', 'token' => 'USDC' ]) ]); $data = json_decode(curl_exec($ch), true); echo $data['payment_url'];

Copybody := []byte(`{"amount":25.50,"idempotency_key":"order-1001","network":"solana","token":"USDC"}`) req, _ := http.NewRequest("POST", "https://api.excrypto.finance/payments/v1/create-payment", bytes.NewBuffer(body)) req.Header.Set("Content-Type", "application/json") req.Header.Set("x-api-key", "exc_YOUR_KEY") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close() var data map[string]interface{} json.NewDecoder(resp.Body).Decode(&data) fmt.Println(data["payment_url"])

Copyvar client = new HttpClient(); client.DefaultRequestHeaders.Add("x-api-key", "exc_YOUR_KEY"); var content = new StringContent( JsonSerializer.Serialize(new { amount = 25.50, idempotency_key = "order-1001", network = "solana", token = "USDC" }), Encoding.UTF8, "application/json"); var res = await client.PostAsync( "https://api.excrypto.finance/payments/v1/create-payment", content); var data = await res.Content.ReadFromJsonAsync<JsonElement>(); Console.WriteLine(data.GetProperty("payment_url"));

GET /payments/v1/payment-status/:order_id

Copycurl "https://api.excrypto.finance/payments/v1/payment-status/ORDER_ID" \ -H "x-api-key: exc_YOUR_KEY"

Copyconst res = await fetch( 'https://api.excrypto.finance/payments/v1/payment-status/ORDER_ID', { headers: { 'x-api-key': 'exc_YOUR_KEY' } } ); const data = await res.json(); console.log(data.status);

Copyimport requests res = requests.get( 'https://api.excrypto.finance/payments/v1/payment-status/ORDER_ID', headers={'x-api-key': 'exc_YOUR_KEY'} ) print(res.json()['status'])

Copy$ch = curl_init('https://api.excrypto.finance/payments/v1/payment-status/ORDER_ID'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['x-api-key: exc_YOUR_KEY'] ]); $data = json_decode(curl_exec($ch), true); echo $data['status'];

Copyreq, _ := http.NewRequest("GET", "https://api.excrypto.finance/payments/v1/payment-status/ORDER_ID", nil) req.Header.Set("x-api-key", "exc_YOUR_KEY") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close() var data map[string]interface{} json.NewDecoder(resp.Body).Decode(&data) fmt.Println(data["status"])

Copyvar client = new HttpClient(); client.DefaultRequestHeaders.Add("x-api-key", "exc_YOUR_KEY"); var res = await client.GetFromJsonAsync<JsonElement>( "https://api.excrypto.finance/payments/v1/payment-status/ORDER_ID"); Console.WriteLine(res.GetProperty("status"));

GET /payments/v1/merchant/payments

Copycurl "https://api.excrypto.finance/payments/v1/merchant/payments?status=COMPLETED&limit=20" \ -H "x-api-key: exc_YOUR_KEY"

Copyconst res = await fetch( 'https://api.excrypto.finance/payments/v1/merchant/payments?status=COMPLETED&limit=20', { headers: { 'x-api-key': 'exc_YOUR_KEY' } } ); const payments = await res.json();

Copyimport requests res = requests.get( 'https://api.excrypto.finance/payments/v1/merchant/payments', headers={'x-api-key': 'exc_YOUR_KEY'}, params={'status': 'COMPLETED', 'limit': 20} ) payments = res.json()

Copy$ch = curl_init('https://api.excrypto.finance/payments/v1/merchant/payments?status=COMPLETED&limit=20'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['x-api-key: exc_YOUR_KEY'] ]); $payments = json_decode(curl_exec($ch), true);

Copyreq, _ := http.NewRequest("GET", "https://api.excrypto.finance/payments/v1/merchant/payments?status=COMPLETED&limit=20", nil) req.Header.Set("x-api-key", "exc_YOUR_KEY") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close() var payments map[string]interface{} json.NewDecoder(resp.Body).Decode(&payments) fmt.Println(payments)

Copyvar client = new HttpClient(); client.DefaultRequestHeaders.Add("x-api-key", "exc_YOUR_KEY"); var res = await client.GetFromJsonAsync<JsonElement>( "https://api.excrypto.finance/payments/v1/merchant/payments?status=COMPLETED&limit=20"); Console.WriteLine(res);

PUT /payments/v1/merchant/webhook

Copycurl -X PUT "https://api.excrypto.finance/payments/v1/merchant/webhook" \ -H "Content-Type: application/json" \ -H "x-api-key: exc_YOUR_KEY" \ -d '{"webhook_url": "https://your-site.com/webhook"}'

Copyawait fetch('https://api.excrypto.finance/payments/v1/merchant/webhook', { method: 'PUT', headers: { 'Content-Type': 'application/json', 'x-api-key': 'exc_YOUR_KEY' }, body: JSON.stringify({ webhook_url: 'https://your-site.com/webhook' }) });

Copyimport requests requests.put( 'https://api.excrypto.finance/payments/v1/merchant/webhook', headers={'x-api-key': 'exc_YOUR_KEY'}, json={'webhook_url': 'https://your-site.com/webhook'} )

Copy$ch = curl_init('https://api.excrypto.finance/payments/v1/merchant/webhook'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'PUT', CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'x-api-key: exc_YOUR_KEY'], CURLOPT_POSTFIELDS => '{"webhook_url": "https://your-site.com/webhook"}' ]); curl_exec($ch);

Copybody := []byte(`{"webhook_url":"https://your-site.com/webhook"}`) req, _ := http.NewRequest("PUT", "https://api.excrypto.finance/payments/v1/merchant/webhook", bytes.NewBuffer(body)) req.Header.Set("Content-Type", "application/json") req.Header.Set("x-api-key", "exc_YOUR_KEY") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close()

Copyvar client = new HttpClient(); client.DefaultRequestHeaders.Add("x-api-key", "exc_YOUR_KEY"); var content = new StringContent("{\"webhook_url\":\"https://your-site.com/webhook\"}", Encoding.UTF8, "application/json"); var res = await client.PutAsync("https://api.excrypto.finance/payments/v1/merchant/webhook", content);

GET /v1/price/:pair Oráculo

Copycurl "https://api.excrypto.finance/v1/price/BTCUSDT" \ -H "x-oraculo-key: exo_YOUR_KEY"

Copyconst res = await fetch('https://api.excrypto.finance/v1/price/BTCUSDT', { headers: { 'x-oraculo-key': 'exo_YOUR_KEY' } }); const price = await res.json(); console.log(price);

Copyimport requests res = requests.get( 'https://api.excrypto.finance/v1/price/BTCUSDT', headers={'x-oraculo-key': 'exo_YOUR_KEY'} ) print(res.json())

Copy$ch = curl_init('https://api.excrypto.finance/v1/price/BTCUSDT'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['x-oraculo-key: exo_YOUR_KEY'] ]); $price = json_decode(curl_exec($ch), true);

Copyreq, _ := http.NewRequest("GET", "https://api.excrypto.finance/v1/price/BTCUSDT", nil) req.Header.Set("x-oraculo-key", "exo_YOUR_KEY") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close() var price map[string]interface{} json.NewDecoder(resp.Body).Decode(&price) fmt.Println(price)

Copyvar client = new HttpClient(); client.DefaultRequestHeaders.Add("x-oraculo-key", "exo_YOUR_KEY"); var res = await client.GetFromJsonAsync<JsonElement>( "https://api.excrypto.finance/v1/price/BTCUSDT"); Console.WriteLine(res);

GET /v1/convert Oráculo

Copycurl "https://api.excrypto.finance/v1/convert?from=BTC&to=BRL&amount=1" \ -H "x-oraculo-key: exo_YOUR_KEY"

Copyconst res = await fetch( 'https://api.excrypto.finance/v1/convert?from=BTC&to=BRL&amount=1', { headers: { 'x-oraculo-key': 'exo_YOUR_KEY' } } ); const conversion = await res.json(); console.log(conversion);

Copyimport requests res = requests.get( 'https://api.excrypto.finance/v1/convert', headers={'x-oraculo-key': 'exo_YOUR_KEY'}, params={'from': 'BTC', 'to': 'BRL', 'amount': 1} ) print(res.json())

Copy$ch = curl_init('https://api.excrypto.finance/v1/convert?from=BTC&to=BRL&amount=1'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['x-oraculo-key: exo_YOUR_KEY'] ]); $data = json_decode(curl_exec($ch), true);

Copyreq, _ := http.NewRequest("GET", "https://api.excrypto.finance/v1/convert?from=BTC&to=BRL&amount=1", nil) req.Header.Set("x-oraculo-key", "exo_YOUR_KEY") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close() var data map[string]interface{} json.NewDecoder(resp.Body).Decode(&data) fmt.Println(data)

Copyvar client = new HttpClient(); client.DefaultRequestHeaders.Add("x-oraculo-key", "exo_YOUR_KEY"); var res = await client.GetFromJsonAsync<JsonElement>( "https://api.excrypto.finance/v1/convert?from=BTC&to=BRL&amount=1"); Console.WriteLine(res);

Rate Limits

Rate limiting is applied per-IP and per-key to ensure fair usage. Headers X-Credits-Remaining and X-Rate-Limit-RPM are included in Oráculo responses.

Error Codes

All errors follow a consistent format: { "ok": false, "error": "DESCRIPTION" }

Endpoint Explorer

Filter, search, and generate cURL commands for all client-facing endpoints.

Código gerado

Select an endpoint above to generate code.

API Playground

Select an endpoint and test it live.

Endpoint ...

Path Parameters

Auth

Body (JSON) {}

Send

Copiar código ▾

cURL Node.js Python PHP Go C#

---